$$WTO – JES2 subtask write to operator

Use $$WTO to initiate the display of an operator message from a JES2 subtask or during JES2 initialization or termination. The message is issued through an MVS™ execute-form WTO macro after supplying the JES2 command ID character.

$$WTO stores the message text within the message area; therefore, your program becomes non-reentrant after using this macro. Your program remains reentrant if the message area is acquired (using $GETMAIN) and refreshed each time the macro is issued.

Format description


>>-+--------+--$$WTO--+-wto-list-+--+----------------+---------->
   '-symbol-'         '-(--R1--)-'  |        .-YES-. |   
                                    '-,MID=--+-NO--+-'   

>--+-----------------------------------------------------------------------------+-->
   '-,TEXT=-+-message-addrx------------+-+------------------+-+----------------+-'   
            '-(message-addrx +-,C--+-)-' '-,CONNECT=--conid-' '-,AREAID=--area-'     
                             +-,L--+                                                 
                             +-,D--+                                                 
                             +-,DE-+                                                 
                             '-,E--'                                                 

>--+-------------+--+-----------------+------------------------->
   '-JOBID=jobid-'  '-JOBNAME=jobname-'   

>--+----------------------+------------------------------------><
   |           .-BRANCH-. |   
   '-LINKAGE=--+-SVC----+-'

wto-list

Specifies the address of a list-form MVS WTO message. If TEXT= is also specified, it is assumed that the list form WTO also specified TEXT=. If TEXT= was not specified, it is assumed that the list form WTO contains the text of the message to be issued. If descriptor code 1, 2, 3, or 11 was specified, the DOM ID is returned in register 1. If a multi-line WTO was specified, the connect ID is returned in register 1.

AREAID=

Specifies the console area ID. Only valid if TEXT= was specified

CONNECT=

If this is not the first line of a multi-line WTO, specifies the MLWTO connect ID. Only valid if TEXT= was specified.

JOBID=

Specifies the job id to be associated with the message. This parameter is optional.

JOBNAME=

Specifies the job name to be associated with the message. This parameter is optional.

LINKAGE=

Specifies whether BRANCH or SVC linkage is to be used to enter the WTO service. The default is LINKAGE=SVC.

MID=

Specifies whether the message has a message ID and therefore whether or not to add the JES2 COMCHAR to the start of the message. Default is YES.

TEXT=

Option keyword which specifies the address of the text of the operator message. The address can be in a register (2-12) or be the name of a field. Use of this keyword implies that the WTO MF=L specified TEXT= and that it generates an extended WPL.

The address specified by TEXT= will be placed in the WPL pointed to through the wto-list parameter.

TEXT is the address of a half-word length followed by the message text. The length does not include the length of the half-word.

A second optional value is the line type for multi-line WTOs. Valid values are C, L, D, DE, and E. See z/OS MVS Programming: Assembler Services Reference IAR-XCT for complete descriptions.

Format description

Environment