Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
CSRPGT2 — Allocate a cell from a cell pool z/OS MVS Programming: Assembler Services Reference ABE-HSP SA23-1369-00 |
||||||||||||||||||||||||||||||||||||||||||||
DescriptionCall the CSRPGT2 cell pool service to allocate a cell from the cell pool. CSRPGT2 allocates cells from the lowest- to highest-numbered active extents, and within each extent, from the lowest to the highest cell address. CSRPGT2 passes back to the calling program the address of the cell it allocated but does not clear the cell storage to binary zeros. (The CSRPGET service provides the same function but slightly slower performance. CSRPGT2 is preferred over CSRPGT1 when using multiple extents, as CSRPGT2 has an additonal output parameter to return the address of the extent containing the obtained cell.) EnvironmentThe requirements for the caller are:
Programming requirementsIf your program is in AR mode, issue the SYSSTATE macro with ASCENV=AR before you call CSRPGT2 so the CALL macro can generate the correct code for AR mode. Before you use cell pool services, you can optionally include the
CSRCPASM macro to generate cell pool services equate (EQU) statements.
CSRCPASM provides the following constants for use in your program:
RestrictionsNone. Input register informationBefore calling the CSRPGT2 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 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 CSRPGT2 service returns control to your program, GPR 15 (and return_code) contains one of the following return codes:
|
Copyright IBM Corporation 1990, 2014
|