TAA Tools
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