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


Home Page Up to Top