The Convert  Command  Usage command  converts the  spooled output  from
PRTCMDUSG to  an outfile.  This  allows you to write a  program for all
programs  that use a  specific command.   Only a single  command may be
specified.    The outfile  is  named  CMDUSGP  and  may  exist  in  any
library.

The model  file is TAACMEKP in  TAATOOL with a format  name of CMDUSGR.

Because  the function  reads the  spooled file  listing, it  is release
dependent.  Only  the lower  and upper case  English language  versions
are  supported.   If  the  format  of  the  PRTCMDUSG spooled  file  is
changed on a subsequent release, the program must be modified.

A  typical command to  convert all  RTVJOBA commands from  all programs
in library LIB1 to the outfile USGCMDP in QTEMP would be:

            CVTCMDUSG    CMD(RTVJOBA) PGM(LIB1/*ALL) OUTLIB(QTEMP)

If none of  the specified commands  exist or there are  no programs  of
the specified name, the  command completes normally.  No  records would
be written to the CMDUSGP file.

CVTCMDUSG escape messages you can monitor for
---------------------------------------------

None.  Escape messages from based on functions will be re-sent.

Command parameters                                    *CMD
------------------

   CMD           The command  name to search for in  the programs named
                 in the PGM parameter.

   PGM           The  qualified  program  name  to  search  for.   *ALL
                 programs  in  library *USRLIBL  is  the  default.    A
                 single program  or a generic program name  may also be
                 specified.

   OUTLIB        The  library  which  will  contain  the CMDUSGP  file.
                 The default is *LIBL.   *LIBL may not  be used if  the
                 CMDUSGP file does not exist on the library list.

   OUTMBR        The member  to write  the output to.   The  default is
                 CMDUSGP.

   REPLACE       Whether  to replace  the data  in an  existing CMDUSGP
                 file.  The default is *YES.

                 *NO may be specified to add records to the member.

Restrictions
------------

Because the  function reads  the spooled  file listing,  it is  release
dependent.   Only the lower  and upper  case English language  versions
are  supported.    If the  format  of  the  PRTCMDUSG  spooled file  is
changed on a subsequent release, the program must be modified.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CRTDUPPF        Create duplicate physical file
     EDTVAR          Edit variable
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion 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
   ------        ----    ---------      ----------    ----------

   CVTCMDUSG     *CMD                   TAACMEK       QATTCMD
   TAACMEKC      *PGM       CLP         TAACMEKC      QATTCL
   TAACMEKR      *PGM       RPG         TAACMEKR      QATTRPG
   TAACMEKP      *FILE      PF          TAACMEKP      QATTDDS