How to invoke SWAREQ

As parameters of the SWAREQ macro, you specify the function code and the pointer to the EPAL. The EPAL input data and the EPAL output data for each function code is summarized in the following block:

SWAREQ function EPAL size EPAL input fields EPAL output fields
Read LocateStart of change, UNAUTH=NOEnd of change Start of change16End of change SVA Block pointer, block length, block ID
Start of changeRead Locate, UNAUTH=YESEnd of change Start of change28End of change Start of changeSVAEnd of change Start of changeBlock pointer, block length, block ID, block prefix pointer, block length including the prefixEnd of change
Write Locate 16 SVA, block pointer, block ID None
When you write a program that invokes SWAREQ, you must provide the field definitions in the EPA. You might also need to provide the SWA block definitions. When you assemble the program, the following mapping macros provide the definitions that you need:
  • IEFZB505 — EPAL data area
  • IEFJESCT — JES control block
  • CVT — communications vector table
  • IEFQMIDS — SWA block ID definitions

Start of changeSee z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO for details about SWAREQ.End of change