WTO
Command | Parameters |
|---|---|
WTO | 'messageText' [JOBID(n)] [ROUTCDE(n1 ... nn)] [DESC(n1 ... nn)] [CONSOLE|CN(n)] [SSID(YES|NO)] [NAME(x)] |
The following table describes the parameters:
Parameter | Function | Notes |
|---|---|---|
messageText | Text of the message to send | Maximum length is 119 characters when the SSID parameter uses the default value of YES; if the SSID is specified with NO, the maximum length is increased to 126. |
JOBID | Job identifier to place in SYSLOG as message issuer | Range is 1-8 characters alphanumeric, first character alpha. |
ROUTCDE | Routing codes to associate with the message | See IBM publication, Routing and Descriptor Codes, for more information. |
DESC | Descriptor codes to associate with the message | See IBM publication, Routing and Descriptor Codes, for more information. |
CONSOLE CN | Specific Console ID of console to receive the message | This parameter is a numeric identifier. You can specify NAME() or CONSOLE(), but you cannot specify both. If you omit the CONSOLE|CN and NAME keywords, the system uses the routing code specified on the ROUTCODE keyword on the DEFAULT statement in the CONSOLxx member of SYS1.PARMLIB. |
SSID | Appends the subsystem ID to the end of the message | This parameter is either YES or NO; the default is YES. |
NAME | Valid console name to where the message is sent | You can specify NAME() or CONSOLE(), but you cannot specify both. If you omit the CONSOLE|CN and NAME keywords, the system uses the routing code specified on the ROUTCODE keyword on the DEFAULT statement in the CONSOLxx member of SYS1.PARMLIB. |
Condition codes are listed in the following table:
Value | Description |
|---|---|
0 | Command was executed successfully. The variable IMFWTDOM contains the DOM ID for this WTO. You may need to use this value in a later invocation of the IMFEXEC DOM command to delete the message again. |
4 | Set when the WTOR is issued with Msgtext truncated because it exceeded the maximum length. |
8 | Set when invalid syntax is detected. These errors are flagged by TSO/EIKJ xxxxx messages or by BMC AMI Ops Automation short error messages or both. |
This section contains the following topic: