Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
AXFRE — Free authorization index z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN SA23-1372-00 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||
DescriptionThe AXFRE macro returns one or more authorization index (AX) values to the system. The AX value can be used as an extended authorization index (EAX) value. The caller must ensure that the AXs to be returned are no longer being used by any address space as an AX or an EX; otherwise, the caller abnormally terminates. On completion of the AXFRE macro, all authorization of the freed AX values in authorization tables for the entire system are purged. The caller must be dispatched in the address space that owns the AX. Related macrosAXEXT, ATSET, AXRES, and AXSET EnvironmentThese are the requirements for the caller:
Register 13 must point to a standard register save area addressable in primary mode. Programming requirementsWhen the macro is issued, the list of AX values passed to the AXFRE macro must be addressable in primary mode. RestrictionsNone. Input register informationThe AXFRE macro is sensitive to the SYSSTATE macro with the OSREL=ZOSV1R6
parameter
Output register informationAfter the caller issues the macro, the macro might use some registers as work registers or might change the contents of some registers. When the macro returns control to the caller, the contents of these registers are not the same as they were before the macro was issued. Therefore, if the caller depends on these registers containing the same value before and after issuing the macro, the caller must save these registers before issuing the macro and restore them after the system returns control. When control returns to the caller, the general purpose registers
(GPRs) contain:
Performance implicationsNone. SyntaxThis is the standard form of the AXFRE macro:
ParametersThese are the parameters:
ABEND codes
See z/OS MVS System Codes for an explanation and programmer responses for these codes. Return codesWhen AXFRE macro returns control to your program, GPR 15 contains a return code.
ExamplesFor examples of the use of this and other cross memory macros, refer to the chapter on cross memory communication in z/OS MVS Programming: Extended Addressability Guide. |
Copyright IBM Corporation 1990, 2014
|