CVTPRXCMD CONVERT PROXY COMMAND TAACMFO |
The Convert Proxy Command command converts from a command object one
record for each command in a proxy command chain. One record will
always exist for the actual command in the chain with a type of *CMD.
The QCDRCMDI API is used. The outfile is always PRXCMDP which uses
the model file TAACMFOP with a format name of PRXCMDR.
CVTPRXCMD looks 'down' the proxy chain for a specific command. To
understand a proxy chain, use DSPCMD.
See also the DSPALLPRX command which finds all of the proxy commands
associated with an actual command. DSPALLPRX command displays
command information based on the current information in the TAACMFBP
file in TAATOOL. This file must be periodically refreshed using the
CRTFNDCMD command.
Proxy commands
--------------
Proxy commands provide two significant advantages 1) the
authorizations only need to be kept on the actual command and 2) the
command definition of the actual command may change without impacting
the proxy version. A proxy command may use the same or a different
name than the command that is referenced when CRTPRXCMD is specified.
A proxy command may refer to another proxy command thus creating a
chain to the real command.
Typical CVTPRXCMD
-----------------
A typical example of CVTPRXCMD would be:
CVTPRXCMD CMD(ABC) OUTLIB(yyy)
Multiple records may be output:
** One record would be written if the ABC command was created via
CRTPRXCMD.
** One record would also be written for each additional proxy
command in the chain.
** One final record would be written for the actual command.
The records would be written to the PRXCMDP file in the named
library. If the command specified is not a proxy command, one record
would be output for the actual command.
CVTPRXCMD escape messages you can monitor for
---------------------------------------------
None. Escape messages from based on functions will be re-sent.
CVTPRXCMD Command parameters *CMD
----------------------------
CMD The qualified name of the command to convert
information for. The library value defaults to
*LIBL. A specific library or *CURLIB may also be
used.
OUTLIB The library in which the PRXCMDP file will be
placed. The default is *LIBL. If the PRXCMDP file
does not already exist, a library must be specified.
OUTMBR The member of the PRXCMDP file to be used. If the
member does not exist, it is added. The default is
PRXCMDP.
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
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
DUPTAADBF Duplicate TAA data base file
EDTVAR Edit variable
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
------ ---- --------- ---------- ----------
CVTPRXCMD *CMD TAACMFO QATTCMD
TAACMFOC *PGM CLP TAACMFOC QATTCL
TAACMFOR *PGM RPGLE TAACMFOR QATTRPG
TAACMFOP *FILE PF TAACMFOP QATTDDS
|
Added to TAA Productivity tools October 15, 2011