CMPCMDPARM -- Compare Command Parameters

CMPCMDPARM COMPARE COMMAND PARAMETERS TAACMDZ
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 compared. A typical command would be: CMPCMDPARM CMD(AAA) 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 library: CMPCMDPARM CMD(xxx/ALL) 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 exceptions. 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 option. 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. Restrictions ------------ 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. Prerequisites ------------- 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 Implementation -------------- 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

CMPCMDPARM      COMPARE COMMAND PARAMETERS             TAACMDZ


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
compared.

A typical command would be:

             CMPCMDPARM    CMD(AAA)

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
library:

             CMPCMDPARM    CMD(xxx/*ALL)

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
exceptions.

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
                 option.

                 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.

Restrictions
------------

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.

Prerequisites
-------------

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

Implementation
--------------

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

Added to TAA Productivity tools August 1, 1996

Home Page

Up to Top