TAA Tools
SNDMSGSBM       SEND MESSAGE TO SUBMITTER              TAAMSGO

The Send Message to  Submitter command makes it easy to  send a message
from a batch job back to the submitter.  A typical command would be:

        SNDMSGSBM   MSG('The PAYROLL file is missing')

The  command performs  the simple  function  of retrieving  the message
queue of the submitter and sending a message to him.

The message would appear as:

        From job XXXX - The PAYROLL file is missing

The  submitter  of  the  job  would  first  see  the  SNDMSGSBM message
followed by one of the following sent by the system:

     - CPF1240 Batch job ended abnormally

     - CPF1241 Batch job ended normally

Using SNDMSGSBM allows  a more specific  error or completion  statement
to occur.   Sending  a good error  description can often  avoid looking
in the job log.

When   SBMJOB  is  used,  the  MSGQ   parameter  defaults  to  *USRPRF.
Therefore, the completion  messages will go  the user's message  queue.
The other  values that can  be entered  are *WRKSTN, a  specific queue,
or *NONE.  SNDMSGSBM cannot be used if MSGQ(*NONE) is specified.

Once  the batch job  is started, you  cannot change the  setting of the
MSGQ value.    Consequently,  the  user  will  normally  see  both  the
SNDMSGSBM message and the SBMJOB completion message.

The command can be entered in a CL program or run thru QCMDEXC.

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

   MSG           The  message  text  to  be  sent.     The  message  is
                 normally sent  to the message  queue of the  user that
                 submitted  the job.  If  MSGQ(*WRKSTN) is specified on
                 SBMJOB,  the  message  is  sent  to   the  workstation
                 message  queue.   The  message  can include  character
                 variables.

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

  **   The command can only be entered in batch.

  **   The  MSGQ(*NONE)  function  cannot  be  used  when  the  job  is
       submitted.

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

The following TAA Tools must be on your system:

       SNDCOMPMSG     Send completion message
       SNDESCMSG      Send escape message

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

None, the tool is ready to use.

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

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

   SNDMSGSBM     *CMD                       TAAMSGO       QATTCMD
   TAAMSGOC      *PGM           CLP         TAAMSGOC      QATTCL
					

Added to TAA Productivity tools April 1, 1995


Home Page Up to Top