CVTCMDA CONVERT COMMAND ATTRIBUTES TAACMEQ |
The Convert Command Attributes command builds an outfile of one or
more Command objects. The outfile created is named CMDP. The
outfile may then be queried for consistency or searching for specific
values such as those Command objects containing a prompt override
program.
The model file is TAACMEQP with a format name of CMDR. You can
display the model file with DSPFMT TAACMEQP.
You must have *ALLOBJ authority to use a library qualifier of *ALL or
*ALLUSR.
A typical command would be:
CVTCMDA CMD(xxx) OUTLIB(QTEMP)
The named Command objects would be converted to the CMDP file in
QTEMP. There would be one record for each Command object.
Retrieve errors
---------------
Certain system commands cannot be retrieved using the sub tool
RTVCMDA. This includes the Command Definition commands such as PGM
and the export commands such as STRPGMEXP.
If a command cannot be retrieved with RTVCMDA, the value **RTVERR**
is placed in the CACPP field (Command processing program). Values
that can be retrieved using RTVOBJD such as the owner and source
member are placed in the outfile. Values that cannot be retrieved
using RTVOBJD such as CAMAXP (Maximum parameters) will be blank.
CVTCMDA escape messages you can monitor for
-------------------------------------------
TAA9891 No *CMD object types in the library.
TAA9893 Unable to retrieve from the command object
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
CMD The qualified name of the Command object to be
converted. *ALL is the default. A specific name or
a generic name may also be entered.
The library value defaults to *LIBL. *USRLIBL,
*CURLIB, *ALLUSR, or *ALL may also be used.
OUTLIB The library in which the CMDP file will be placed.
The default is *LIBL. If the CMDP file does not
already exist, a library must be specified.
OUTMBR The member of the CMDP file to be used. If the
member does not exist, it is added. The default is
CMDP.
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 existing
data.
Restrictions
------------
If more than 5 proxy commands exist, most of the return fields will
be blank. The CAPXY and CAPXYL fields will reflect the proxy
command. The CATEXT will contain an indication.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
DUPTAADBF Duplicate TAA data base file
EDTVAR Edit variable
RTVCMDA Retrieve Command 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
------ ---- --------- ---------- ----------
CVTCMDA *CMD TAACMEQ QATTCMD
TAACMEQC *PGM CLP TAACMEQC QATTCL
TAACMEQR *PGM RPG TAACMEQR QATTRPG
TAACMEQP *FILE PF TAACMEQP QATTDDS
|
Added to TAA Productivity tools May 1, 2003