CMPREGINF COMPARE REGISTRATION INFORMATION TAAREGB |
The Compare Registration Information command compares two different
uses of the CVTREGINF command and describes any differences. Each
use of CVTREGINF creates a named member with one record for each
combination of exit point and exit program. The values of each
combination are compared from the two file/members by CMPREGINF.
The file/members to be compared must have the same format as the
current TAAREGAP file in TAATOOL. If any changes to the format are
required for a new release, see the later section on 'Release
compatibility'.
Assume you capture the Registration Information every month to the
same REGINFP file using OUTMBR(*DATE). If you want to compare the
first month to the last month, you would specify:
CMPREGINF FROMMBR(*FIRST) TOMBR(*LAST1)
The REGINFP file would be searched for on the library list. A
listing would be output with any differences found.
Release compatibility
---------------------
If a new release requires changes to the information generated by
CVTREGINF, the format used for the outfile will change. The
CMPREGINF command requires any members to be compared to use the new
format.
If you want to compare against the registration information of a
previous format, do the following:
** Use CVTREGINF 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.
CMPREGINF will describe a difference unless the default for
the new field is blanks or zeros.
CVTREGINF 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 REGINFP file to compare
from.
The default is *LIBL.
A library name or *CURLIB may be entered.
TOLIB The library name of the REGINFP 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.
BYPEXIT A list of 150 exit point names to be bypassed. The
default is *NONE. This allows you to bypass an exit
point such as QIBM_QSY_HOSTFUNC.
OUTPUT How to output the results. * is the default to
display the summary spooled file if the command is
entered interactively. Individual spooled files (if
any) must be manually displayed. All spooled files
are retained.
If the command is entered in batch or *PRINT is
specified, the spooled file is output.
Restrictions
------------
The REGINFP files must have been created by CVTREGINF.
The files to be compared must have the same format as the current
TAAREGAP file in TAATOOL. See the previous section on 'Release
compatibility'.
Prerequisites
-------------
The following TAA Tools must be on your system:
CVTTIM Convert time
DUPTAADBF Duplicate TAA data base file
RTVFMT Retrieve format
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDSTSMSG Send status message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CMPREGINF *CMD TAAREGB QATTCMD
TAAREGBC *PGM CLP TAAREGBC QATTCL
TAAREGBR *PGM RPG TAAREGBR QATTRPG
TAAREGBR2 *PGM RPG TAAREGBR2 QATTRPG
TAAREGBP *FILE PF TAAREGBP QATTDDS
|
Added to TAA Productivity tools June 1, 2005