Previous Topic

Next Topic

Book Contents

Book Index

Examples

Table 138 shows examples of the DO SHOUT OPER subparameter.

Table 138 DO SHOUT OPER 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

OPER-+CONSNY

Send a message to operator console CONSNY

Specify 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 entry’s content 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 the Dynamic Destination Table in the IOA chapter of 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, specify JES command $LSYS.

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 AutoEdit Facility.

Parent Topic

DO SHOUT: Automated Console Action Parameter