TO

Destination of the message (from 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 from 1 through 8 characters.
• OPER [dd] [-{rrr | -ccc | +nnnnnnnn}] – Sends the message to operator consoles, according to the optional subparameters dd, rrr, and ccc:

  — dd – Descriptor code (from 0 through 16). For more detailed information regarding descriptor codes, refer to the IBM publication Routing and Descriptor Codes, GC38-1102.

  — rrr – Route code (from 0 through 128). For more detailed information regarding route codes, refer to the IBM publication Routing and Descriptor Codes, GC38-1102. Route code and console ID are mutually exclusive.

— -ccc – Console ID number (preceded by a hyphen) of the console to which the message is to be shouted.

— +nnnnnnnn – Console Name (preceded by a plus sign) of the console to which the message is to be shouted. A valid name is between 2 to 8 alphanumeric characters. Route code. Console ID and Console Name are mutually exclusive.

• U-M – sends a message to an email destination. In order to send an email, sample exit IOAX034M should be implemented. The destination must start with "U-M:".

  Refer to the description of sample exits IOAX034M and IOAMAIL in the INCONTROL for z/OS Administrator Guide.

• TSO - logonid [;Nn | ;Mm | ;NnMm | ;Lname] – Sends the message to the user identified by the specified logon ID. logonid is mandatory (from 1 through 7 characters).

  An optional second value, indicating the computer and node (such as Nn) of the TSO logonid, can be specified, as follows:

  Under JES2:

  Valid values are Mm, Nn or NnMm, where

  — – m is the machine ID (the computer in JES2, not the 4-character SMF ID). For more information, see the discussion about specifying IOA CPUs in the IOA chapter of 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 about specifying IOA CPUs in the IOA chapter of the INCONTROL for z/OS Installation Guide.

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

URGENCY

Determines the priority level of the message.

Valid values are:

• R—regular. Default.
• U—urgent
• V—very urgent

SYSTEM

Name of the system to which the message is directed. This subparameter supports the mask characters * and ?.

Note: If no SYSTEM value is specified, the message is sent to the system identified by the %%$COMMSYS reserved user-defined variable in a preceding DO SET statement. For more information, see the description of %%$COMMSYS in Reserved User-Defined Variables, and Performing an Action on Another System ctoug3.

If %%$COMMSYS is not specified, the message is issued on the current system.

CTO282I

Indicates if the message ID is prefixed by CTO282I. Optional.

Valid values are:

• Y (Yes)—The message ID is prefixed by CTO282I. Default.
• N (No)—The message ID is the first word of the message text.

MESSAGE

Message text. Maximum Length: 60 characters. Mandatory.