TAA Tools
SNDESCMSG3      SEND ESCAPE MESSAGE 3                  TAAMSHR

The  Send  Escape Message  3  command  allows  you to  send  an  escape
message  with  both  first   level  and  second  level  text  using  an
impromptu  form  of  message text.    Standard message  IDs  (TAA9871 -
TAA9878) must be used.  Two  different jobs may use the same ID  at the
same time and the text will be unique to their individual jobs.

This allows for  impromptu text to be used in a  situation where a long
string of second level text is needed.

A typical command would be:

            SNDESCMSG3   MSGID(TAA9871) MSG('...') SECLVL('...')

The  message  IDs  exist  in  the  TAAMSGF  message  file  in  TAATOOL.
SEV(40) is used in the message description.

An escape message  is sent using  the QMHSNDPM API  to the 2nd  program
higher in  the stack.   This  allows the message  to be  sent as  if it
were sent by the program that ran SNDESCMSG3.

If  SNDESCMSG3  is used  from an  ILE  program, the  escape  message is
still sent to the previous program.   Note that in a complex  situation
where several modules exist  in the current ILE program  in the program
stack,  the message  is not  sent to  the previous  module, but  to the
previous program.

Both  the first  and second level  text could be  read by  the user and
will be in the job log.

Both the  MSG and  SECLVL parameters  may contain  an expression  where
you concatenate variables into the message such as:

         MSG('You are missing the ' *CAT &FILE *TCAT ' file.')

To  send a  message other  than an  escape with  the same  second level
help approach, see the SNDPGMMSG2 tool.

SNDESCMSG3 escape messages you can monitor for
----------------------------------------------

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

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

   MSGID         The  message  ID  to  be sent.    It  must  be  one of
                 TAA9871, TAA9872 -  TAA9878.   The messages should  be
                 considered unique within your program.

                 That  is,  the same  message  IDs  can be  re-used  in
                 another  program  within  your  job,  by another  job,
                 etc.

                 Two independent  jobs may  both use  the same  message
                 ID at  the  same time  and the  text  will be  unique.
                 Providing  TAA9871  -   TAA9878  allows  you  to  have
                 multiple   monitorable   messages   within   the  same
                 program.

   MSG           The first level  text that will  appear in the  escape
                 message.    Up  to  512  bytes may  be  entered.    An
                 expression may be used.

   SECLVL        The  second level text that will  appear in the escape
                 message.   Up  to  512  bytes  may  be  entered.    An
                 expression may be used.

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

None.

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

None.

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

None, the tool is ready to use.

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

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

   SNDESCMSG3    *CMD                   TAAMSHR       QATTCMD
   TAAMSHRC      *PGM       CLP         TAAMSHRC      QATTCL
					

Added to TAA Productivity tools September 1, 1999


Home Page Up to Top