TAA Tools
CMPNETA         COMPARE NETWORK ATTRIBUTES             TAANETG

The Compare Network  Attributes command compares two different  uses of
CVTNETA and  describes any differences.  Each use  of CVTNETA creates a
named  member with one  record containing unique fields  for all of the
network attributes.   The value of  each network attribute is  compared
between the two file/members by CMPNETA.

The  file/members to  be  compared must  have  the same  format as  the
current  TAANETFP file in TAATOOL.   If any  new network attributes are
added during  a  release,  the  TAANETFP format  will  change  and  you
cannot  compare  to any  NETATRP  file/members  created on  a  previous
release.  See the later section on 'Release compatibility'.

Assume  you capture  the  network attributes  every month  to  the same
NETATRP file and  assign a name  NETyymmdd to the  OUTMBR parameter  of
CAPNETA.   If you want  to compare Dec  1, 2009 with  Nov 1,  2009; you
would specify:

             CMPNETA     FROMMBR(NET091201) TOMBR(NET091101)

The  NETATRP  file would  be  searched  for on  the  library  list.   A
listing would be output with any differences found.

Release compatibility
---------------------

If  a  new  release  adds  a  new  network  attribute  (or  changes the
attributes  of an  existing  network  attribute), the  CMPNETA  command
will be  updated to include any changes.   This will cause  a change in
the  format of the outfile.   The CMPNETA command  requires any members
to be compared to use the new format.

If you want  to compare against  the network attributes  of a  previous
format, do the following:

  **   Use CVTNETA to create a new version with the proper format.

  **   Use CPYF to copy  the member which uses the  prior format to the
       new  format.   Specify  REPLACE(*YES)  and  FMTOPT(*MAP).   This
       will cause  blanks  or  zeros  to  appear  in  any  new  fields.
       CMPNETA will  describe a difference  unless the default  for the
       new field is blanks or zeros.

CMPNETA escape messages you can monitor for
-------------------------------------------

None.  Escape messages from based on functions will be re-sent.

Command parameters                                    *CMD
------------------

   FROMLIB       The  library  name  of  the  NETATRP file  to  compare
                 from.

                 The default is *LIBL.

                 A library name or *CURLIB may be entered.

   TOLIB         The  library name of  the NETATRP file  to compare to.

                 The default is *LIBL.

                 A library name or *CURLIB may be entered.

   FROMMBR       The From member to be compared.

                 *FIRST is the default.

                 A member name or *LAST may be specified.

   TOMBR         The To member to be compared.

                 *FIRST is the default.

                 A member name or *LAST may be specified.

   OUTPUT        How to  output  the  results.   *  is the  default  to
                 display  the spooled  file if  the command  is entered
                 interactively.   The spooled file  is deleted after it
                 is displayed.

                 If the  command  is  entered  in batch  or  *PRINT  is
                 specified, the  spooled file  is output  and retained.

Restrictions
------------

The NETATRP files must have been created by CVTNETA.

The  files to  be compared  must have  the same  format as  the current
TAANETFP file  in  TAATOOL.    See the  previous  section  on  'Release
compatibility'.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CVTTIM          Convert time
     EDTVAR          Edit variable
     RTVFMT          Retrieve format
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   CMPNETA       *CMD                   TAANETG       QATTCMD
   TAANETGC      *PGM       CLP         TAANETGC      QATTCL
   TAANETGR      *PGM       RPG         TAANETGR      QATTRPG
					

Added to TAA Productivity tools June 1, 2005


Home Page Up to Top