TAA Tools
SNDWARNMSG      SEND WARNING MESSAGE                   TAAMSHM

The Send Warning  Message command is  designed for the  situation where
the user  should be informed of a 'warning'  situation.  If the command
is  run in  an interactive job,  the text of  the message is  sent as a
diagnostic message.  If  the command is run  in a batch job, a  message
is sent to the submitter.

In  order  to gain  the  users attention  to  a  minor problem  without
causing an escape message, a warning message can be helpful.

A typical command would be:

             SNDWARNMSG   MSG('An error situation is +
                             described in the XXX +
                             spooled file.')

If the  command is run in an interactive  job, the QMHSNDPM API is used
to send the message  to the previous program  in the program stack  (as
if you had sent the diagnostic directly from your program).

If the command  is run in a batch  job, the setting of  the SBMJOB MSGQ
parameter  determines  which message  queue will  receive  the message.
The MSGQ  parameter defaults  to *USRPRF,  but also  allows *WRKSTN  or
*NONE.

If MSGQ(*NONE) is  specified for the  batch job, the message  cannot be
sent to  the submitter.   A diagnostic message  will appear in  the job
log.

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

   MSG           The text of the message to be sent.

                 If  the  command  is  run  in  an  interactive  job, a
                 diagnostic  message  would be  sent  to  the  previous
                 programs message queue.

                 If the  command is  run in a  batch job, a  message is
                 sent  back to  the submitter  of the  job.   If SBMJOB
                 MSGQ(*USRPRF)  is  used  (it  is  the  default),   the
                 message is sent to the user.

                 If SBMJOB  MSGQ(*WRKSTN) is specified, the  message is
                 sent to the workstation where SBMJOB was used.

                 If   SBMJOB  MSGQ(*NONE)   is   specified,  SNDWARNMSG
                 cannot be used.  A  diagnostic message is sent to  the
                 job log.

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

If SBMJOB  MSGQ(*NONE)  is specified,  SNDWARNMSG cannot  be  used.   A
message is sent to the job log.

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

The following TAA Tools must be on your system:

     SNDDIAGMSG      Send diagnostic message

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

None, the tool is ready to use.

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

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

   SNDWARNMSG    *CMD                   TAAMSHM       QATTCMD
   TAAMSHMC      *PGM       CLP         TAAMSHMC      QATTCL
					

Added to TAA Productivity tools March 1, 1998


Home Page Up to Top