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

WTO()

This function issues the specified text as a WTO.

Syntax

msgid = WTO(text,[rout],[desc],[cons])

Parameters

msgid

A unique message ID assigned by the operating system. Can be used with the DOM() function to delete messages that are no longer needed. If the WTO fails, error information is returned.

text

Text to appear on the console of the operator as a WTO.

rout

One or more routing codes (like '1' or '1,2,3' or '1-5,8,10,15-128'). For information about routing codes, see the IBM guide Supervisor Services and Macro Instruction.

desc

One or more descriptor codes (like '1' or '1,2,3' or '1-5,8,10,12-16'). For information about descriptor codes, see the IBM guide Supervisor Services and Macro Instructions.

cons

The number of consoles to receive a message. If the IMOD is running as the result of an operator command, the predefined variable imod_console contains the console ID of the console issuing the command.

Return Codes

101 - 102

ARG n MISSING OR INVALID

Example

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