To use these macros, a program must be in supervisor state, 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 the UNAUTH=YES parameter. Overriding these restrictions by specifying the UNAUTH=YES parameter does not mean that the SWA blocks for another address space can be accessed, but that the service can run with the primary address space even if it is not the same as the home address space.
To use these macros, you must provide information to one of two external parameter areas (EPAs). When invoking SWAREQ, use the EPAL. When invoking IEFQMREQ, use the EPAM. This information uses the term EPA when generically referring to either of these areas.
One of the items that you must store in the EPA before invoking the macro is the token that identifies the SWA block that you want to access. You can obtain these tokens (called SVAs) from the following fields:
SWA block to be accessed | Field that contains the token | Mapping macro for field that contains the token |
---|---|---|
JFCB (job file control block) | TIOEJFCB in the TIOT entry | IEFTIOT1 |
JFCBX (job file control block extension) | JFCBEXAD in the JFCB | IEFJFCBN |