|
|
|
|
|
The message is sent to the required destination when the accompanying ON statement criteria are satisfied.
It is also possible to shout to a ROSCOE user. For additional information, see your INCONTROL administrator.
Subparameter TO (CMEM)
Type TO=USERID-userid to write the message to the IOA Log under the user ID specified in the parameter.
Type TO=OPER[dd]-{rrr,-ccc} to send the message to all operator consoles, or to operator consoles selected according to route code (rrr) or console ID number (-ccc). The descriptor code (dd) determines the type of message displayed. The dd, rrr, and -ccc parameters are optional and can be assigned any valid value. Dashes (–) are used to separate the parameters specified.
For more detailed information regarding route and descriptor codes, refer to the IBM publication Routing and Descriptor Codes, GC38-1102.
Examples
Table 237 DO SHOUT OPER (CMEM) Subparameter Examples
Subparameter |
Description |
|---|---|
OPER |
Send the message to all operator consoles. |
OPER2 |
Send a highlighted unrollable message (descriptor code 2) to all operator consoles. |
OPER-5 |
Send a message to operator consoles associated with route code 5. |
OPER2-5 |
Send a highlighted unrollable message to operator consoles associated with route code 5. |
OPER-4 |
Send a message to operator console ID 04. |
OPER2-4 |
Send a highlighted unrollable message (descriptor code 2) to operator console ID 04. |
Type TO=TSO-logonid to send the message to a groupid or logonid. The Shout facility first searches the IOA Dynamic Destination table for the specified ID. If the table contains an entry that matches the value, the content of the entry is used as the target for the shouted message. The entire TO field is used. Therefore, when directing the message to a remote user, do not append Nn or Mm. Instead, do this in the IOA Dynamic Destination Table itself. For more information, see the description of Dynamic Destination Tables in the INCONTROL for z/OS Administrator Guide.
If no matching ID is found in the Dynamic Destination table, the Shout facility assumes the specified ID is a logonid. It then creates a TSO message that it hands over to MVS. MVS then sends the message to that logonid. If the logonid does not exist, MVS cannot send the message, but no error message is generated. When a second value is used, the message is sent to the TSO logonid in the specified computer or node (machine ID). To determine the machine ID under JES2, enter JES command $D MEMBER.
The URGENCY subparameter
The URGENCY value indicates the urgency level of the message.
In addition, if the destination is USERID-userid (or U-userid), the user can control, according to urgency, which messages are displayed when the IOA Log file is accessed. Urgent and very urgent messages are highlighted on the screen. For more details, see IOA Log Facility.
The CTO282I Subparameter
By default, the CTO282I subparameter has a value of Y, and CTO282I is placed as the message ID preceding the message text. When CTO282I is set to N, the first word of the message text becomes the message ID.
Control-O AutoEdit Variables
Control-O AutoEdit variables embedded in the TO and MSG subparameters are automatically resolved at time of rule activation. For more information about the AutoEdit facility, see JCL and AutoEdit Facility.
Parent Topic |