z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


WTOR - List form

z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO
SA23-1375-00

Use the list form of the WTOR macro together with the execute form of the macro for applications that require reentrant code. The list form of the macro defines an area of storage, which the execute form of the macro uses to store the parameters.

Syntax

The list form of the WTOR macro is written as follows:

Syntax Description
   
   name name: Symbol. Begin name in column 1.
   
One or more blanks must precede WTOR.
   
WTOR  
   
One or more blanks must follow WTOR.
   
‘msg’,reply addr,reply length,ecb addr  
(‘text’,reply addr,reply length,ecb addr)  
((‘text’,line type,...,‘text’,line type),reply addr, reply length,ecb addr)  
TEXT=(,reply addr,reply length,ecb addr)  
 TEXT=(((,line type),(,line type),...,(,line type)), reply addr,reply length,ecb addr)  
  msg: Up to 122 characters.
  text: Up to 122 characters.
  reply addr: A-type address.
  reply length: Symbol, decimal digit. The minimum length is 1; the maximum length is 119.
  ecb addr: A-type address.
 
The permissible line types, text lengths, and maximum numbers are shown below:
line type     text       maximum number
C             31 char    1 C type
L             66 char    2 L type
D             66 char    14 D type
DE            66 char    1 DE type
               or
E             None       1 E type

The maximum total of lines that can be coded in one instruction is 14.

 
Note:
  1. If you code ‘msg’... or (‘text’...), it must be the first parameter you code.
  2. If you do not code reply addr on the list form of WTOR, mark its position with a comma, and code reply addr on the execute form. The same is true for reply length and ecb addr.
   
   ,ROUTCDE=(routing code) routing code: Decimal digit from 1 to 128. The routing code is one or more codes, separated by commas, or a hyphen to indicate a range.
   
   ,DESC=(descriptor code) descriptor code: Decimal number 7 or 13. If you code both 7 and 13, separate them with commas.
   
   ,MSGTYP=(msg type) msg type: Any of the following:
N
SESS,JOBNAMES
Y
SESS,STATUS
SESS
JOBNAMES,STATUS
JOBNAMES
SESS,JOBNAMES,STATUS
STATUS
 
Note: IBM® recommends that you do not use MSGTYP=Y. See the MSGTYP explanation on page ,MSGTYP=(msg type) for more information.
   
   ,MCSFLAG=(flag name) flag name: Any combination of the following, separated by commas:
NOCPY
HRDCPY
RESP
BRDCST
REPLY
NOTIME
   
   ,RPLYISUR= Parameter value not required for list form. Code only ,RPLYISUR=. If you code RPLYISUR on the list form of WTOR, you must code RPLYISUR on the execute form.
   
   ,CONSID= Parameter value not required for list form. Code only ,CONSID= (or ,CONSNAME=). If you code CONSID (or CONSNAME) on the list form of WTOR, you must code CONSID (or CONSNAME) on the execute form.
   ,CONSNAME=  
   
   ,SYSNAME= Parameter value not required for list form. Code only ,SYSNAME=. If you code SYSNAME on the list form of WTOR, you must code SYSNAME on the execute form.
   
   ,CART= Parameter value not required for list form. Code only ,CART=. If you code CART on the list form of WTOR, you must code CART on the execute form.
   
   ,KEY= Parameter value not required for list form. Code only ,KEY=. If you code KEY on the list form of WTOR, you must code KEY on the execute form.
   
   ,TOKEN= Parameter value not required for list form. Code only ,TOKEN=. If you code TOKEN on the list form of WTOR, you must code TOKEN on the execute form.
   
   ,JOBID= Parameter value not required for list form. Code only ,JOBID=. If you code JOBID on the list form of WTOR, you must code JOBID on the execute form.
   
   ,JOBNAME= Parameter value not required for list form. Code only ,JOBNAME=. If you code JOBNAME on the list form of WTOR, you must code JOBNAME on the execute form.
   
   ,LINKAGE= Parameter value not required for list form. Code only ,LINKAGE=. If you code LINKAGE on the list form of WTOR, you must code LINKAGE on the execute form.
   
   ,SYNCH=NO Default: NO
   ,SYNCH=YES  
   
,MF=L  
   

Parameters

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

,MF=L
Specifies the list form of the WTOR macro.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014