The  Retrieve Message  Description  2 tool  is  similar to  the  system
RTVMSG  command, but  allows a  retrieve when  only  the message  ID is
known.    This  is desirable  when  the  message file  or  message file
library is  not  known.   If  the message  file cannot  be  determined,
TAA9892  is  sent  as an  escape  message.    DSPMSGTXT has  a  similar
function, but offers a display.

While  most messages are in  QCPFMSG in QSYS,  there are other messages
in different  message  files in  QSYS and  in  other message  files  in
different libraries.   RTVMSGD2 should be  used when you only  know the
message ID.

A typical sequence of commands would be:

             DCL           &MSGID *CHAR LEN(7)
             DCL           &MSGF *CHAR LEN(10)
             DCL           &MSGFL *CHAR LEN(10)
              .
             RTVMSGD2      MSGID(&MSGID) MSGF(&MSGF) MSGFL(&MSGFL)
             MONMSG        MSGID(TAA9892) EXEC(DO) /* Not found */
                           /**************************************/
                           /*                                    */
                           /*   Your processing of not found     */
                           /*                                    */
                           /**************************************/
             ENDDO

RTVMSGD2 escape messages you can monitor for
--------------------------------------------

      TAA9892    The message file could not be determined.

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

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

   MSGID         The  message  ID  of  the  message  that exists  in  a
                 message file.

   FSTLVL        The first  level text  to be  returned.   If used,  it
                 must be declared as *CHAR LEN(132).

   SECLVL        The second  level text to  be returned.   If used,  it
                 must be declared as *CHAR LEN(3000).

   MSGF          The  message file to  be returned.   If used,  it must
                 be declared as *CHAR LEN(10).

   MSGFL         The  message file  library to  be returned.   If used,
                 it must be declared as *CHAR LEN(10).

   FMTCTLCHAR    A *YES/*NO  parameter for  whether the format  control
                 characters  should be  returned in  the message.   The
                 default is *NO.

                 If  *YES is specified, format  control characters such
                 as &N  &P  and &B  will  be  returned in  the  message
                 text.

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

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

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

The following TAA Tools must be on your system:

     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   RTVMSGD2      *CMD                   TAAMSIA       QATTCMD
   TAAMSIAC      *PGM       CLP         TAAMSIAC      QATTCL
   TAAMSIAC2     *PGM       CLP         TAAMSIAC2     QATTCL