TAA Tools
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


Home Page Up to Top