Control reception of unsolicited messages
Component: | BS2000 |
Functional area: | Job processing |
Domain: | JOB |
Privileges: | STD-PROCESSING |
Function
With the MODIFY-MSG-OPTIONS command, users can control the reception of unsolicited messages for their jobs. The messages in question are asynchronous messages and messages from systems support or a system task, capable of reaching the user but not necessarily directly related to command processing.
It is possible for a user to receive the following messages:
job-related messages sent to that user by systems support using the INFORM-JOB command
messages sent to all users by systems support using the INFORM-ALL-JOBS command (broadcasts)
messages from system tasks (e.g. on completion of a file transfer)
Users can configure their message reception requirements separately for three types of message:
for job-related messages in the OPERATOR-MSG operand
for messages to all users in the OPERATOR-BROADCAST operand
for messages from system tasks in the SYSTEM-MSG operand
Urgent messages, e.g. messages at system shutdown, are always output.
At the start of a task, the following settings apply:
Operand | Setting at start of task |
|---|---|
OPERATOR-BROADCAST | *YES |
OPERATOR-MSG | *YES |
SYSTEM-MSG | *NO |
INFO-OUTPUT | *STD |
The INFO-OUTPUT operand further allows the user to control exactly where on the terminal the messages are output.
The current settings can be displayed with the SHOW-MSG-OPTIONS command.
Accessing suppressed messages
While the MODIFY-MSG-OPTIONS command allows you to suppress the output of unsolicited messages if you find them irritating, the drawback is that you may fail to receive a message which is important to you.
You have the option of using the ASSIGN-SYSEVENT command to create an event stream to collect all the asynchronous messages sent to your interactive task, and then using the SHOW-SYSEVENT-LOG command to view its contents online. You can also page through the event stream.
A task with the OPERATING privilege can access the event stream directly (i.e. without assignment). However, in order also to receive the three message categories that can be suppressed with MODIFY-MSG-OPTIONS, the task must explicitly assign the system event stream using ASSIGN-SYSEVENT.
Format
MODIFY-MSG-OPTIONS |
OPERATOR-BROADCAST = *UNCHANGED / *YES / *NO ,OPERATOR-MSG = *UNCHANGED / *YES / *NO ,SYSTEM-MSG = *UNCHANGED / *YES / *NO ,INFO-OUTPUT = *UNCHANGED / list-poss(2): *STD / *SYSTEMLINE |
Operands
OPERATOR-BROADCAST = *UNCHANGED / *YES / *NO
Specifies whether the user wants to receive messages sent to all users by systems support using the INFORM-ALL-JOBS command.
OPERATOR-MSG = *UNCHANGED / *YES / *NO
Specifies whether the user wants to receive messages sent to him by systems support using the INFORM-JOB command.
SYSTEM-MSG = *UNCHANGED / *YES / *NO
Specifies whether the user wants to receive messages sent to him by a system task. Example: notification of file transfer completion.
INFO-OUTPUT = *UNCHANGED / list-poss(2): *STD / *SYSTEMLINE
Specifies how messages sent by systems support are to be output on the terminal.
If *STD is specified, the messages are output in the current screen line.
If *SYSTEMLINE is specified, the messages are output in the display line, i.e. the bottom line of the screen.
If both values are specified, the messages are output in both the current screen line and the display line.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed without error | |
1 | 32 | NBR0940 | Command not executed because no entry in the TCB was possible |