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 Locate, UNAUTH=NO | 16 | SVA | Block pointer, block length, block ID |
Read Locate, UNAUTH=YES | 28 | SVA | Block pointer, block length, block ID, block prefix pointer, block length including the prefix |
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
See z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO for details about SWAREQ.