TAA Tools

The  Retrieve  Command  Source command  retrieves  information  from  a
Command  Definition object  and  generates source  statements  based on
the definition.

Note  that the  original implementation  was prevented  from retrieving
all keywords  because of  limitations within the  API used.   This  has
been  corrected by PTFs  for V5R1  SI06296 and  V5R2 SI06403  which are
now required.

A typical command would be:

             RTVCMDSRC   CMD(xxx) SRCFILE(yyy/QCMDSRC)

The  Command Definition object would be  accessed by RTVCMDSRC.  Source
statements would  be generated to  a member  (defaults to  the name  of
the command) in the specified source file.

The first  line of source  describes the  command object that  was used
and the date and time of retrieval.

Additional  comments are  output that contain  the values  specified on
CRTCMD such as PGM, MODE, etc.  These comments appear as:

            /*PARMS ....     */

This format  is designed  for use  with the  SBMPARMS TAA  Tool.   This
tool will access  the values from  the special comments and  place them
on the CRTCMD command.  See the discussion with SBMPARMS.

Prompt information

The PROMPT/CHOICE  data returned from the  API may not be  a 100% match
with that originally entered.

RTVCMDSRC escape messages you can monitor for

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

Command parameters                                    *CMD

   CMD           The  qualified name  of the command  to retrieve from.
                 The library  value  defaults to  *LIBL.   *CURLIB  may
                 also be used.

   SRCFILE       The  source file  to  place the  retrieved source  in.
                 The  default is QCMDSRC.   The  library value defaults
                 to *LIBL.  *CURLIB may also be used.

   SRCMBR        The source  member  to  place  the  source  in.    The
                 default is *CMD  meaning the name of  the command will
                 be used as the name of the member.


See previous comments.


The following TAA Tools must be on your system:

     FIXCLPSRC       Fix CLP source
     HLRMVMSG        HLL Remove message
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic message
     SNDESCMSG       Send escape message


None, the tool is ready to use.

Objects used by the tool

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   RTVCMDSRC     *CMD                   TAACMEN       QATTCMD
   TAACMENC      *PGM       CLP         TAACMENC      QATTCL
                                        TAACMENR2     QATTRPG

TAACMENR  and TAACMENR2 source are  modules.  Each is  created and then
CRTPGM is used to create TAACMENR.

Added to TAA Productivity tools June 1, 2002

Home Page Up to Top