TAA Tools
RTVRPYLE        RETRIEVE REPLY LIST ENTRY              TAAMSIK

The Retrieve  Reply List Entry  command retrieves  the attributes of  a
specific System  Reply List Entry based on a  Sequence Number.  Because
the command returns variables, it may only be used in a CL program.

The  command does not  perform as fast as  typical Retrieve commands as
it uses CVTRPYLE  to create a  file in QTEMP of  the entire Reply  List
and then reads thru the file for the requested sequence number.

A typical set of commands would be:

             DCL           &MSGID *CHAR LEN(7)
              .
             RTVRPYLE      SEQNBR(20) MSGID(&MSGID)

RTVRPYLE escape messages you can monitor for
--------------------------------------------

      TAA9891    The sequence number was not found.

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

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

   SEQNBR        The  sequence number  of  the entry  to be  retrieved.
                 It must be a value between 1 and 9999.

   MSGID         An  optional return  value for the  Message Identifier
                 assigned to the entry.   If used, it must be  declared
                 as *CHAR LEN(7).

   CMPDTAVAL     An optional  return value  for the Compare  Data Value
                 assigned to  the entry.  If used,  it must be declared
                 as *CHAR LEN(28).

   CMPDTASTR     An optional return  value for the  Compare Data  Start
                 Position assigned  to the entry.   The  value returned
                 will  be between  1-999  or the  special  value *NONE.
                 If used, it must be declared as *CHAR LEN(5).

   RPY           An   optional  return   value  for   the  Reply  value
                 assigned to the entry.   If used, it must  be declared
                 as *CHAR LEN(32).

   DUMP          An  optional   return  value   for  the   Dump  option
                 assigned  to the entry.   A value of *YES  or *NO will
                 be returned.   If used, it must  be declared as  *CHAR
                 LEN(4).

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

Because the  command returns  variables, it may  only be  used in  a CL
program.

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

The following TAA Tools must be on your system:

     CVTRPYLE        Convert reply list entry
     EDTVAR          Edit variable
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

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

   RTVRPYLE      *CMD                   TAAMSIK       QATTCMD
   TAAMSIKC      *PGM       CLP         TAAMSIKC      QATTCL
					

Added to TAA Productivity tools July 15, 2003


Home Page Up to Top