The Send  Escape Message  5 command  is similar to  the TAA  SNDESCMSG2
command  (part  of  the  SNDESCMSG  tool),  but also  allows  a  'stack
counter'  to be specified.   This allows the escape  message to be sent
to a  program  higher in  the  stack than  the  calling program.    The
QMHSNDPGM API is used.

For  a  similar tool  for  other message  types  (such  as *DIAG),  see
SNDPGMMSG3.

A typical command would be:

             SNDESCMSG5  MSGID(TAA9883) MSGF(TAAMSGF) +
                           MSGFLIB(TAATOOL) +
                           MSGDTA('I jumped over a few programs +
                           to send you this escape message') +
                           STKCTR(2)

The  processing  retrieves information  about the  calling  program and
sends an  escape  message  to the  program  that  is 2  higher  in  the
program  stack.    Programs  between the  SNDESCMSG5  command  and  the
program the escape message was sent to would be ended.

The  message ID TAA9891  in TAAMSGF in  TAATOOL is blank  thus allowing
the MSGDTA value to  appear as the  text of the  message.  Any  message
ID could be used.

The   TAA  product   supports   blank  messages   TAA9881-TAA9888   and
TAA9891-TAA9897 that could be used.

SNDESCMSG5 escape messages you can monitor for
----------------------------------------------

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

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

   MSGID         The  message ID to  be sent.   It must be  an existing
                 message ID.

   MSGF          The message file containing the message ID.

   MSGFLIB       The  library where the message  file exists.  *LIBL is
                 the default.   A  specific library or  *CURLIB may  be
                 entered.

   MSGDTA        The  message data  to appear  as the  message  text of
                 the escape message.

   STKCTR        The  stack counter value  to be used.   The default is
                 2.  It must be a value between 1 and 99.

                 Normally, you  would  want to  send  to at  least  the
                 second program above the calling program.


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

None.

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

None.

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

None, the tool is ready to use.

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

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

   SNDESCMSG5    *CMD                   TAAMSJL       QATTCMD
   TAAMSJLC      *PGM       CLP         TAAMSJLC      QATTCL