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


SWAREQ - Execute form

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

Syntax

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

Syntax Description
   
   name name: Symbol. Begin name in column 1.
   
One or more blanks must precede SWAREQ.
   
SWAREQ  
   
One or more blanks must follow SWAREQ.
   
   ,FCODE=fncde fncde: Function code
   
   ,EPA=addr addr: External parameter area pointer address.
  It may be specified symbolically, as a register enclosed in parentheses, or as a symbol equated to a register enclosed in parentheses.
   
   ,UNAUTH=YES Default: UNAUTH=NO.
   ,UNAUTH=NO  
   
,MF=(E,addr) addr: RX-type address or register (1) - (12).
   

Parameters

The parameters are explained under the list form of the SWAREQ macro, with the following exceptions:

,UNAUTH=YES
,UNAUTH=NO
UNAUTH=YES specifies that the system is to invoke the unauthorized form of the SWA manager. The unauthorized form of the SWA manager provides the output of the RL function of the authorized SWA manager. If you also specify the FCODE parameter, the SWAREQ macro checks the syntax of the FCODE parameter but does not use the function code. To use SWAREQ with UNAUTH=YES you must:
  • Be in 31–bit addressing mode
  • Issue the macro IEFZB505 specifying LOCEPAX=YES, which generates a longer, 28–byte, EPA

To use SWAREQ with the default of UNAUTH=NO, you must be in supervisor state, holding no locks, in task mode, and not in cross memory mode. However, when you are using SWAREQ to perform a Read Locate, you can override these restrictions by specifying UNAUTH=YES, in which case you must follow the requirements for UNAUTH=YES, above.

,MF=(E,addr)
E specifies the execute form of the SWAREQ macro, and addr specifies the address of the parameter list.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014