WTO - Execute form

Use the execute form of the WTO macro together with the list form of the macro for applications that require reentrant code. The execute form of the macro stores the parameters into the storage area defined by the list form.

The message cannot be modified on the execute form of the macro if you code inline text (‘msg’ or (‘text’...)) on the list form.

Parent topic: WTO- Write to operator

Syntax

The execute form of the WTO macro is written as follows:

Syntax Description
   
   name name: Symbol. Begin name in column 1.
   
␢ One or more blanks must precede WTO.
   
WTO  
   
␢ One or more blanks must follow WTO.
   

TEXT=(text addr)
TEXT=((text addr,),(text
 addr,),...(text addr,))

 text addr: RX-type address or register (2) - (12).
Note:
  1. If you code TEXT=(text addr) on the execute form of WTO, you must code TEXT= on the list form.
  2. If you specify inline text on the list form (‘msg’ or (‘text’...)), do not code the TEXT keyword on the execute form.
   
   ,CART=cmd/resp token

cmd/resp token: RX-type address or register (2) - (12).
If you code CART on the execute form of WTO, you must code
CART on the list form.
   
   ,KEY=key

key: RX-type address or register (2) - (12).
If you code KEY on the execute form of WTO, you must code KEY
on the list form.
   
   ,TOKEN=token

token: RX-type address or register (2) - (12).
If you code TOKEN on the execute form of WTO, you must
code TOKEN on the list form.
   
   ,CONSID=console id console id: RX-type address or register (2) - (12).
   ,CONSNAME=console name console name: RX-type address or register (2) - (12). If you code CONSID (or CONSNAME) on the execute form of WTO, you must code CONSID (or CONSNAME) on the list form.
   
,MF=(E,list addr) list addr: RX-type address, or register (1) - (12).
   

Parameters

The parameters are explained under the standard form of the WTO macro, with the following exception:

,MF=(E,list addr)
Specifies the execute form of the WTO macro.

list addr specifies the area that the system uses to store the parameters.

Example 1

Write a message with a prebuilt parameter list pointed to by register 1. 
WTO     MF=(E,(1))

Example 2

Issue a WTO whose list form is defined at label MYLIST, and is pointed to by register 2. Send the WTO to the console with an ID of 1, pointed to by register 4. 
R2       EQU   2
R4       EQU   4
         .
         .
         .
         LA    R2,MYLIST                ADDRESS OF PARAMETER LIST
         L     R4,MYCONID               CONSOLE ID
         WTO   MF=(E,(R2)),CONSID=R4
         .
         .
         .
MYCONID  DC    F'1'