WTOR

WTOR

'Msgtext'

[JOBID(n)]

[ROUTCDE(n1 ... nn)]

[DESC(n1 ... nn)]

[CONSOLE|CN(n)] [NAME(x) REPLY(Variable name)

[WAIT(n)]

[SSID( YES|NO)]

Msgtext

text of the message to send

The maximum length of the text depends on whether you specify SSID(NO) or SSID(YES). SSID(YES) is the default.

Maximum length is 116 characters with SSID(YES).

Maximum length is 122 characters with SSID(NO).

JOBID

job identifier to place in SYSLOG as message issuer

If the JOBID parameter is not specified, the IMFEXEC WTOR command defaults to the JES job identifier for the MainView AutoOPERATOR subsystem.

Range is 1-8 characters alphanumeric, 1st character alpha.

ROUTCDE

routing codes to associate with the message

Refer to the IBM publication, Routing and Descriptor Codes, for more information.

Refer to the IBM publication OS/390 MVS Initialization and Tuning Referencefor information about CONSOL xx.

DESC

descriptor codes to associate with the message

Refer to the IBM publication, Routing and Descriptor Codes, for more information. However, only the descriptor codes of 7 and 13 or both may be specified for a WTOR.

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 can not 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.

Refer to the IBM publication OS/390 MVS Initialization and Tuning Reference for information about CONSOLxx.

NAME

specific name of console to receive the message

This parameter is optional.

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.

REPLY

variable name that receives the operators’ reply

Range is 1-32 alphanumeric characters.

WAIT

number of seconds to wait for the operators’ reply

If not specified, the EXEC will wait indefinitely.

SSID

appends subsystem identifier to the end of the message

This parameter is either YES or NO; the default is YES.

0

Command was executed successfully.

4

This value is set when the WTOR is issued with Msgtext truncated because it exceeded the maximum length.

6

One or more descriptor codes specified for the message were invalid. The invalid descriptor codes have been ignored.

8

Invalid syntax is detected in the command. These errors are flagged by TSO/E messages IKJxxxxx or by MainView AutoOPERATOR short error messages or both.

12

A timeout failure has occurred while waiting for an operator response