TO

Destination of the message (1 through 16 characters). Mandatory. Valid values are:

• U-userid or USERID-userid – Writes the message to the IOA Log file under the specified user ID. userid must be 1 through 8 characters.
• OPER[–n] – Sends a rollable message to the operator console. n is an optional 3-digit route code. If a route code is not specified, the default routes are Master Console and Programmer Information (1 and 11), and optionally, Control-M/Enterprise Manager. For more detailed information regarding route codes, refer to the IBM publication Routing and Descriptor Codes, GC38-1102.
• OPER2[–n] – Sends an unrollable, highlighted message to the operator console. n is an optional 3-digit route code. If a route code is not specified, the default routes are Master Console and Programmer Information (1 and 11), and optionally, Control-M/Enterprise Manager. For more detailed information regarding route codes, refer to the IBM publication Routing and Descriptor Codes, GC38-1102.
• [TSO - loginid | T - loginid] [;Nn | ;Mm | ;NnMm | ;Lname] – Sends the message to the specified ID (groupid or logonid). ID is mandatory.
  If a groupid is specified, it must be a valid ID found within the IOA Dynamic Destination Table.
  If a logonid is specified, it must be 1 through 7 characters.
  An optional second value, indicating the computer and/or node (such as Mm) of the TSO logonid, can be specified, as follows:
  Under JES2:
  Valid values are: Nn, Mm or NnMm, where:
  – m is the machine ID (the computer in JES2, not the
     4-character SMF system ID). For more information, see
     the discussion on specifying IOA CPUs in the description
     of the customization process in the INCONTROL for
     z/OS Installation Guide.
  – n is the 1 to 2 character JES/NJE node ID.
  Under JES3:   
  The only valid value is Lname, where Lname is the logical JES name of the machine (that is, the name as used in JES3 command *T, not the SMF system ID).
  For more information, see the discussion on specifying IOA CPUs in the description of the customization process in the INCONTROL for z/OS Installation Guide.

Note: A shout to a TSO user performs a TSO SEND command, which may require authorization at the receiving node.

• U-M:email_dest – Sends a message by e-mail to the recipient identified by the variable (email_dest), which consists of from 1 through 12 characters, and can be any of the following:
  — an e-mail name prefix, based on the full mail name address
       that is supplied by the MAILDEST table in the IOA PARM
       library
  — a nickname defined in the MAILDEST destination table
  — a group name defined in the MAILDEST destination
       table
• U-S:snmp_dest – Sends an SNMP trap (message) to the recipient identified by snmp_dest.
  snmp_dest consists of from 1 through 12 characters, and can be any of the following:
  — a host name
  — an IP address, if it fits in the screen field. Otherwise use a
       nickname.
  — a nickname defined in the SNMPDEST destination table
  — a group name defined in the SNMPDEST destination table
• U-ECS – Sends messages to the Control-M/Enterprise Manager user. For more information on this feature, see "Shouting to Control-M/Enterprise Manager" in General Information for DO SHOUT.

URGENCY

Determines the priority level of the message. Valid values are:

• R – Regular. Default.
• U – Urgent
• V – Very urgent

=

Message text

Maximum length: 70 characters

AutoEdit variables (both system and user-defined) are supported and automatically resolved (replaced) at the time the SHOUT message is issued. For AutoEdit usage information, see JCL and AutoEdit Facility.