SNDINTMSG SEND INTERACTIVE JOBS A MESSAGE TAAMSHW
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
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
The job running SNDINTMSG is not included in any of the completion
Assuming you wanted to end the jobs of these same users 15 minutes
later, you would specify:
This would end all the interactive jobs unless they were on one of
the omit lists.
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
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.
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
INTJOBDEV - List of omitted device names
INTJOBUSR - List of omitted user names
An *ALLOBJ user would maintain the device list by entering:
Enter names of devices (workstations) that should not be ended by
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
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
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.
See the previous comments.
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
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
Added to TAA Productivity tools February 1, 2001