WTOR()

CA-GSS Statements and Commands › GSS Extended Functions › IO Functions › Number, String, and Variable Functions › System Information Functions › WTOR()

WTOR()

This function displays text on the operator console. WTOR() waits for the reply from the operator of the console and returns it.

Syntax

101 - 102 ARG n MISSING OR INVALID

Example

msgid = wto('operator message',2,2) == '' /* Master console and
                                             highlight          */
x = dom(msgid)                            /* Delete the message */

Parameters

reply: Reply from the operator (or error text).
text: Text to appear on the console of the operator as the WTOR.
rout: One or more routing codes (like'1' or '1,2,3' or '1-5,8,10,15-128'). For information about routing, see the IBM guide Supervisor Services and Macro Instructions.
desc: One or more descriptor codes (like '1' or '1,2,3' or '1-5,8,10,12-16'). For information about routing and descriptor codes, see the IBM guide Supervisor Services and Macro Instructions.
cons: ID of the console to display the message. If the IMOD is being executed as the result of an operator command, the imod_console variable contains the console ID where the command was issued.

Usage Notes

WTOR() suspends the execution of IMOD until an operator replies to the displayed message.
An IMOD with an outstanding WTOR cannot be canceled until the WTOR is satisfied.

Return Codes

101

ARG 1 MISSING OR INVALID

102

One of the following for ARG 2:

NON-NUMERIC CHARACTER

CONTIGUOUS RANGES

NUMBER TOO BIG

LIST IS INCOMPLETE

RANGE IS INVALID

ZERO VALUE

103

One of the following for ARG 3: