CMPSTRUP COMPARE STARTUP PROGRAM TAASYSU |
The Compare Start Up Program command compares the source between the
program identified for the QSTRUPPGM system value and the QSTRUP
program supplied by the system in QSYS. This can help identify
changes that have occurred after installing a new release.
For example, if you have created your own Start Up program by
retrieving the source for QSTRUP and making modifications, you will
want to be notified of any system changes to QSTRUP for a new
release.
A typical command would be:
CMPSTRUP
If the QSTRUPPGM system value is QSTRUP in QSYS and was created by
*IBM, the command ends normally with an appropriate message. If the
program was not created by *IBM, the user has replaced the QSYS
program and no comparison can be made (an escape message is issued).
If a different startup program is specified, the source for the
startup program and the source for the system supplied QSTRUP program
are accessed and compared.
Because most users who modify the startup program do so by using
RTVCLSRC from QSTRUP and then modifying the code, the third statement
of this source contains a date and time of retrieval which
automatically causes a difference. To avoid this difference, the
fourth statement of each member is retrieved and if they are
identical, the comparison begins with statement number 4. The
completion message will include a comment if this occurs.
The TAA Tool CMPSRC is used to make the comparison. This produces a
spooled file if differences occur. If the comparison is the same, no
spooled file will exist.
If the QSTRUPPGM system value is other than QSTRUP, the source for
the program must exist where it was created from. If not, consider
the use of the TAA Tool CHGOBJSRC to describe where the source
exists.
CMPSTRUP escape messages you can monitor for
---------------------------------------------
TAA9895 Differences exist (optional based on ESCAPE Parm)
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
ESCAPE Whether to send an escape message if differences
exist. The default is *NO which means a completion
message is sent.
*YES may be specified to send TAA9895 if differences
exist.
Restrictions
------------
If the QSTRUPPGM system value is other than QSTRUP, the source for
the program must exist where it was created from.
Prerequisites
-------------
The following TAA Tools must be on your system:
CMPSRC Compare source
EDTVAR Edit variable
RTVSRCSTMT Retrieve source statement
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
------ ---- --------- ---------- ----------
CMPSTRUP *CMD TAASYSU QATTCMD
TAASYSUC *PGM CLP TAASYSUC QATTCL
|
Added to TAA Productivity tools July 1, 1999