The Send Interactive  Jobs a Message  command sends a break  message to
all interactive  jobs.  Various selection criteria exist  as well as an
omit  list of  users and/or  devices can  be named  (see the  Omit list
discussion).    The  command  may  be  used  in  conjunction  with  the
ENDINTJOB command  to inform  users a few  minutes before  ending their
jobs.

You must have *JOBCTL special authority to use SNDINTMSG.

A typical command would be:

             SNDINTMSG     MSG('Signoff, backup will be started +
                              in 15 minutes.')

This  message would be  sent as  a break message  to the  device of the
interactive job  (Break messages can  only be  sent to  devices).   The
message would  be sent  to all  interactive jobs  except the device  of
the current  job or if the device  name or user name was  in one of the
'omit' lists.

The job running  SNDINTMSG is  not included  in any  of the  completion
message counts.

Assuming you  wanted to  end the jobs  of these  same users  15 minutes
later, you would specify:

             ENDINTJOB

This  would end all  the interactive  jobs unless  they were on  one of
the omit lists.

Considerations
--------------

There  are a few  exceptions to the  user not being  interrupted when a
break  message  is sent.    The  CHGJOB  command  supports  the  BRKMSG
parameter.  If  the user has specified *HOLD or  *NOTIFY he can prevent
the  break message  from occurring.   If the  user has  a break message
handling program for the workstation  message queue, he can ignore  the
message.

Certain devices  allow a 'jump'  key to  jump to a  different job.   If
the  device causes a  separate job name  to be established,  it will be
considered to be a separate device.

If multiple jobs exist  at the same device,  a break message will  only
be sent  once per device.   During the  processing, the device  is only
considered  once.   If  two  user  profiles are  signed  onto the  same
device  and the first user is on the  omit list, the device will not be
sent a message.

Omit list
---------

Two data areas  exist in TAASECURE  that can contain  up to 45  entries
each of  devices and users  that should be  omitted from the  jobs that
are  sent messages.   These are  the same data  areas that  are used by
the ENDINTJOB command.

The data areas can only be  maintained by an *ALLOBJ user and exist  in
TAASECURE.

            INTJOBDEV    - List of omitted device names
            INTJOBUSR    - List of omitted user names

An *ALLOBJ user would maintain the device list by entering:

            EDTCONARR    DTAARA(TAASECURE/INTJOBDEV)

Enter  names of  devices (workstations)  that  should not  be ended  by
ENDINTJOB.

Note  that  client access  device  names are  dynamically  assigned and
cannot be effectively omitted.

SNDINTMSG escape messages you can monitor for
---------------------------------------------

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

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

   MSG           The message text to be sent.   Up to 512 bytes may  be
                 entered.

                 A  message   is  sent  as   a  break  message   to  an
                 interactive job  unless the device  or the user  is on
                 an  'omit' list.   See the  previous documentation for
                 how to enter an 'omit' list.

   SBS           The subsystem  containing  the jobs  to send  messages
                 to.   The default  is *ALL.   If a  specific subsystem
                 is  named,   only  jobs  in  that  subsystem  will  be
                 considered.

   DEV           The device  name  (job  name)  of  the  jobs  to  send
                 messages to.   The  default is  *ALL.   A specific  or
                 generic device name may also be entered.

   USER          The user  name for the jobs to  send messages to.  The
                 default is  *ALL.   A  specific  or generic  name  may
                 also be entered.

   TEST          Whether this is  a test of  the function.  *NO  is the
                 default meaning a break message will be sent.

                 *YES  may  be  specified  when testing  the  function.
                 Messages  will be sent to the  job log for each device
                 that would have been sent a break message.

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

See the previous comments.

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

The following TAA Tools must be on your system:

     CHKJOBCTL       Check *JOBCTL special authority
     CVTWRKACT       Convert work active
     EDTVAR          Edit variable
     SNDCOMPMSG      Send completion message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   SNDINTMSG     *CMD                   TAAMSHW       QATTCMD
   TAAMSHWC      *PGM       CLP         TAAMSHWC      QATTCL
   TAAMSHWC2     *PGM       CLP         TAAMSHWC2     QATTCL