The Compare Command Parameters command compares the parameter lists
of the command source against the source for the CPP. A single
command, a generic command name, or all commands in a library may be
A typical command would be:
The AAA command would be accessed using *USRLIBL. The source member
used for the command definition object would be determined as well as
the Command Processing Program (CPP). The source member used for the
CPP would be determined.
The two source members would then be compared using the CMPSRCPARM
TAA Tool. The tool is restricted to work with CPPs created from CLP
or RPG source.
Another typical command would be to compare all commands within a
If a single command is processed, the default is to retain the
spooled file produced by CMPSRCPARM.
If multiple commands are processed (a generic name or *ALL), the
default is to delete the spooled files when CMPSRCPARM finds the
parameter lists the same. A summary listing is produced with one
line per command. This removes the clutter and leaves only the
If either of the source members cannot be accessed, or the CPP cannot
be accessed, an error message will occur.
You should not attempt to process any commands or CPPs that are
shipped by the system. These objects will not have any source and
the CMPCMDPARM command will send an error message.
You should not attempt to process any commands from the TAA
Productivity Tools. The source files used to create the objects does
not exist on your system and CMPCMDPARM will send an error message.
After the objects are created, the source is compressed into the TAA
Archive which does exist on your system.
Command parameters *CMD
CMD The qualified file name of the command to be
compared. A single command, a generic name, or the
special value *ALL may be used.
The library value defaults to *USRLIBL. A specific
library, *ALLUSR, or *CURLIB may be specified.
DLTSPLF You may choose to delete spooled files created by
the sub tool CMPSRCPARM if the parameter lists are
the same. If differences are found, the spooled
file will always be retained regardless of the
The default is * which means that the spooled file
created by CMPSRCPARM will be retained if a single
command is processed. If multiple commands are
processed, any spooled files created by CMPSRCPARM
will be deleted if the parameter lists are the same.
*NO may be specified to retain any spooled files
created by CMPSRCPARM.
*YES may be specified to delete the spooled file
created by CMPSRCPARM when a single command is
processed and the parameter lists are the same.
RQDEXTDSC Determines whether any externally described files
are required. *YES is the default. If an
Externally Described file is specified in the
source, it must exist on the library list or an
escape message will occur.
*NO may be specified in which case if an Externally
Described file exists, the field specifications are
used. If an Externally Described file does not
exist, no error occurs, but the information about
some of the fields may be missing.
The command processing program must be written in CL or RPG.
The CMPSRCPARM command relies upon several sub tools to access the
information and make the comparisons. The CMPSRCPARM command is used
to make the comparisons. Other tools used directly or indirectly
include RTVCMDPARM, RTVCLPVAR, RTVRPGFLD, and RTVRPGPARM. These sub
tools have restrictions.
The following TAA Tools must be on your system:
CMPSRCPARM Compare source parameters
EDTVAR Edit variable
RSNLSTMSG Resend last message
RTVCMDA Retrieve command attributes
RTVPGMA Retrieve program attributes
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
SNDSTSMSG Send status message
None, the tool is ready to use.
Objects used by the tool
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CMPCMDPARM *CMD TAACMDZ QATTCMD
TAACMDZC *PGM CLP TAACMDZC QATTCL
TAACMDZR *PGM RPG TAACMDZR QATTRPG