TAA Tools

 CVTCLPCMD       CONVERT CLP COMMAND                    TAACMFQ

 The Convert  CLP  Command command  converts CL  commands  from CL  type
 source to  an outfile.   One record would  be written for  each command
 with   the  identifying  information  such  as  member  name,  sequence
 number, and  last change  date.   Some commands  such as  SBMJOB or  IF
 which contain  a sub  command will  also cause a  record to  be written
 which is identified as a sub command.

 A  tool such as DSPCLPCMD or  ANZCLPCMD may then be  used to display or
 summarize the information.  A user query may also be used.

 Some restrictions apply.

 A typical command would be:

             CVTCLPCMD  SRCFILE(QCLSRC) OUTLIB(xxx)

 All members  of  the  file  would  be read  and  the  source  would  be
 translated to upper case  so that only upper case  would be written for
 the  command and command  library names.   Only CL type  source (CLP or
 CLLE) source  type members  will  be searched.    One record  would  be
 output for each  command found and  certain sub commands such  as found
 on SBMJOB or  IF.  See later discussion of sub  commands.  If a command
 is  qualified to  a library,  the library name  will also  exist in the
 outfile.

 Using a permanent library for CLPCMDP
 -------------------------------------

 You  may place  the  outfile  in  a  permanent library  to  allow  fast
 searches  (such as  using DSPCLPCMD)  of where  specific  commands have
 been used.  You would need to periodically refresh the outfile.

 You  may  convert all  CL  type of  source  in all  libraries  with the
 command:

              CVTCLPCMD  SRCFILE(*ALL/*ALL) OUTLIB(xxx)

 Running this command  would obviously be slow  and should be  submitted
 to batch at an off peak time.

 Sub commands
 ------------

 A sub  command is  defined as a  command that  is specified  on another
 command such  as IF or SBMJOB.   The CLPCMDP outfile  field CMCMDT will
 have a '1' for a primary command and '2' for a secondary command.

 Sub commands  found  on  the  following  commands  will  be  output  as
 primary commands:

              IF
              ELSE
              OTHERWISE
              MONMSG

 Sub  commands  found  on the  following  commands  will  be  output  as
 secondary commands.

              SBMJOB
              RUNRMTCMD

 Invalid source
 --------------

 Certain  invalid  source occurrences  such  as an  11  byte command  or
 command library name will be bypassed.  Other cases such as:

        MONMSG    ...  EXEC(*)

 will cause 'noise' (such as the *) to appear as a command name.

 Source code restrictions
 ------------------------

   **   Valid source syntax must exist.

   **   Some  non-keyword  forms  will  not  be  recognized  for  a  sub
        command such as WRKSYSSTS in the following command:

              MONMSG   CPF0000 *NONE WRKSYSSTS

 CVTCLPCMD escape messages you can monitor for
 ---------------------------------------------

       TAA9891    No commands were found

 Escape messages from based on functions will be re-sent.

 CVTCLPCMD Command parameters                          *CMD
 ----------------------------

    SRCFILE       The  qualified  name   of  the   source  file  to   be
                  processed.   The source  file name  may be  a specific
                  name, a generic name, or the special value *ALL.

                  The  library  value  defaults to  *LIBL.    A specific
                  library  or  the  special  values  *USRLIBL,  *CURLIB,
                  *ALL,  *ALLUSR, *ALLUSR2,  *ALLNONQ,  or  *IBM may  be
                  entered.   For  a description  of the  special values,
                  see the CVTLIBDBF command.

    MBR           The member to be processed.   The default is *ALL  for
                  all  members.   A  specific  or  generic name  may  be
                  entered.

    SRCTYPE       The  source  type  to  be  processed.    *ALL  is  the
                  default.  The other valid entries are CL or CLLE.

    OUTLIB        The   library  in  which  the  CLPCMDP  file  will  be
                  placed.  The  default is *LIBL.   If the CLPCMDP  file
                  does not  already exist, a library  must be specified.

    OUTMBR        The  member of the  CLPCMDP file to  be used.   If the
                  member does not  exist, it is added.   The default  is
                  CLPCMDP.

    REPLACE       A  *YES/*NO value  for whether  the  member should  be
                  cleared before  writing records into it.   The default
                  is *YES.

                  *NO may be  specified to  add records  to an  existing
                  file.


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

 See the previous discussion.

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

 The following TAA Tools must be on your system:

      CVTLIBDBF       Convert library data base file
      CVTMBRLST       Convert member list
      DUPTAADBF       Duplicate TAA data base file
      EDTVAR          Edit variable
      HLRMVMSG        HLL Remove message
      RTVDAT          Retrieve date
      RSNLSTMSG       Resend last message
      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
    ------        ----    ---------      ----------    ----------

    CVTCLPCMD     *CMD                   TAACMFQ       QATTCMD
    TAACMFQC      *PGM       CLP         TAACMFQC      QATTCL
    TAACMFQC2     *PGM       CLP         TAACMFQC2     QATTCL
    TAACMFQR      *PGM       RPG         TAACMFQR      QATTRPG
    TAACMFQP      *FILE      PF          TAACMFQP      QATTDDS

Added to TAA Productivity Tools April 15, 2012


Home Page

Last modified on November 19, 2014 © 1995, 2014 - TAA Tools, Inc.