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

Last modified on March 10, 2014 © 1995, 2014 - TAA Tools, Inc.