TAA Tools
CMPSYSVAL       COMPARE SYSTEM VALUES                  TAASYST

The  Compare  System  Values command  allows  a  comparison  of  system
values  between two  systems or  two versions  converted from  the same
system.    The  CVTSYSVAL  TAA  command must  be  used  to  capture the
information on  each system  in an  outfile.   CMPSYSVAL then  compares
the  information from the  two files  and prints  a listing  noting any
differences.

Assuming  you   want  to  compare  system  values  from  two  different
systems, you must first capture the information on each system:

             CVTSYSVAL  OUTLIB(xxx) CMPSYSVAL(*YES)

Specifying CMPSYSVAL(*YES) provides  for additional  information to  be
compared  on  system  releases  and the  full  value  of  QSYSLIBL  and
QUSRLIBL.

The  name of the outfile  is always SYSVALP.   Assume you did CVTSYSVAL
on a second system  and then transferred it  to your current system  in
library  ABC.   Assume you  did  CVTSYSVAL of  your  current system  to
library DEF.  You would then make the following comparison:

             CMPSYSVAL  FROMLIB(ABC) TOLIB(DEF)

The two files would be compared and a listing produced.

System  values which should  not be compared  such as QDATE  or QSRLNBR
are flagged.  Any differences are flagged.

When  a new version of  TAA is installed, it  may change the definition
or the  data that could  be written to  SYSVALP.   Starting with a  new
version of SYSVALP may be required to gain the proper comparison.

Regular saving of system values
-------------------------------

Another use  of CMPSYSVAL  is to compare  the settings of  your current
system  values against  a previous  version.  You  may want  to convert
the system values using CVTSYSVAL on  a scheduled basis such as once  a
month  to allow  you to  make  a comparison  of  any two  months.   The
CVTSYSVAL  OUTMBR(*DATE) parameter may  be used in  this case to  add a
member Mcyymmdd.  Be sure to specify CMPSYSVAL(*YES).

Assume you are  using CVTSYSVAL  monthly and  now want  to compare  the
first month you captured  the information to the last  time the capture
was made.  You would specify:

             CMPSYSVAL  FROMLIB(xxx) TOLIB(xxx)
                          FROMMBR(*FIRST) TOMBR(*LAST)

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

   FROMLIB       The  library   containing  the  SYSVALP   file  to  be
                 treated as the 'From System'.

   TOLIB         The   library  containing  the   SYSVALP  file  to  be
                 treated as the 'To System'.

   FROMMBR       The member in the  SYSVALP From file.  The  default is
                 *FIRST.    A specific  member  name  or  *LAST may  be
                 specified.

   FROMMBR       The  member in  the SYSVALP To  file.   The default is
                 *FIRST.   A  specific  member  name or  *LAST  may  be
                 specified.

   GROUP         Whether to  compare all  system values  or a  selected
                 group  such as  defined  by WRKSYSVAL  (*SEC, *SYSCTL,
                 etc.) The default is *ALL for all groups.

                 One  of  the  following  values  may  be  entered   to
                 compare only  those system  values which  belong to  a
                 group  of  *ALC,  *DATTIM,  *EDT, *LIBL,  *MSG,  *SEC,
                 *STG,  or  *SYSCTL.    If a  group  is  specified, the
                 heading of  the output  contains the requested  group,
                 but it does not appear on each detail line.

   CMPDAT        Whether  to compare  the  date system  values such  as
                 QDATE  and  QDAYOFWEEK.    The  default  is *NO  which
                 means they will be flagged  as 'Unique' values in  the
                 listing.    Time  system  values  such  as  QTIME  are
                 always considered 'Unique'.

                 *YES  may be  specified to cause  a comparison  of the
                 date system values.

   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
------------

See previous comments.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CVTSYSVAL       Convert system value
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   CMPSYSVAL     *CMD                   TAASYST       QATTCMD
   TAASYSTC      *PGM       CLP         TAASYSTC      QATTCL
   TAASYSTR      *PGM       RPG         TAASYSTR      QATTRPG
					

Added to TAA Productivity tools January 1, 1999


Home Page Up to Top