Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
CSRC4QCL — Query a cell z/OS MVS Programming: Assembler Services Reference ABE-HSP SA23-1369-00 |
|||||||||||||||||||||||||||||||||||||||||
DescriptionCall the CSRC4QCL cell pool service to receive status information about a specified cell in a cell pool. CSRC4QCL reports whether the cell is free or allocated, and returns the number of the extent associated with the cell. CSRC4QCL does not prevent other programs from changing the pool during or after a query. CSRC4QCL returns the status as it was at the time you issued the CALL. EnvironmentThe requirements for the caller are:
Programming requirementsIf your program is in AR mode, issue the SYSSTATE macro with ASCENV=AR before you call CSRC4QCL so the CALL macro can generate the correct code for AR mode. As the program must be running in AMODE 64 to call this service, be sure to issue SYSSTATE AMODE64=YES at the point(s) where the program begins running in AMODE 64. Before you use cell pool services, you can optionally include the
CSRC4ASM macro to generate cell pool services equate (EQU) statements.
CSRC4ASM provides the following constants for use in your program:
RestrictionsNone. Input register informationBefore calling the CSRC4QCL service, the caller does not have to place any information into any register unless using it in register notation for a particular parameter, or using it as a base register. Output register informationWhen control returns to the caller, the 64-bit general purpose
registers (GPRs) contain:
When control returns to the caller, the access registers (ARs)
contain:
Some callers depend on register contents remaining the same before and after issuing a service. If the system changes the contents of registers on which the caller depends, the caller must save them before issuing the service, and restore them after the system returns control. Performance implicationsNone. SyntaxWrite the call as shown on the syntax diagram. You must code all parameters on the CALL statement in the order shown.
ParametersAll input to callable services is in the form of RX-type addresses. The parameters are explained as follows:
ABEND codesNone. Return and reason codesWhen the CSRC4QCL service returns control to your program, GPR 15 (and return_code) contains one of the following return codes:
|
Copyright IBM Corporation 1990, 2014
|