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
|
