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 Up to Top