|
|
|
|
|
The message is sent to the required destination when the accompanying ON statement criteria are satisfied.
The TO Subparameter
Specify TO=USERID-userid, to write the message to the IOA Log file under the user ID specified in the parameter.
Specify TO=OPER[–n], to send the message to the operator console (route code n). If the n value is omitted, the message is sent to all consoles to which route codes 1 or 11 are assigned. For more detailed information regarding route and descriptor codes, refer to the IBM publication Routing and Descriptor Codes, GC38-1102.
Specify TO=OPER2[–n], to send a highlighted, unrollable message is sent to the operator console (route code n). If the n value is omitted, the message is sent to all consoles to which route codes 1 or 11 are assigned. For more detailed information regarding route and descriptor codes, refer to the IBM publication Routing and Descriptor Codes, GC38-1102.
Specify TO=TSO-id or T-id, to send the message is sent to the 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, specify JES command $LSYS.
Specify TO=U-M: mail-name-prefix to send the message by e-mail to the recipient identified by the prefix. The full mail name address is supplied by the MAILDEST table in the IOA PARM library. For more information about mail destinations, see the INCONTROL for z/OS Administrator Guide. The IOAPARM member includes DFLTSFFX, the mail address suffix, such as MAIL.DOMAIN.COM, the SMTP STC name, and the HOSTNAME.
Parent Topic |