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
|
