Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
CSRPRGT1 — Allocate a cell from a cell pool (register interface) z/OS MVS Programming: Assembler Services Reference ABE-HSP SA23-1369-00 |
||||||||||||||||||||||||||||||||||||||||||||
DescriptionCall the CSRPRGT1 cell pool service to allocate a cell from the cell pool using the register interface, if your program cannot obtain storage for a parameter list. CSRPRGT1 allocates cells from the lowest- to highest-numbered active extents, and within each extent, from the lowest to highest cell address. (The CSRPRGT service provides the same function but slightly slower performance.) EnvironmentThe requirements for the caller are:
Programming requirementsBefore 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 CSRPRGT1 service, the caller must ensure that
the following access registers (ARs) and general purpose registers
(GPRs) contain the specified information:
Output register informationWhen control returns to the caller, the GPRs contain:
When control returns to the caller, the 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.
ParametersABEND codesNone. Return and reason codesWhen the CSRPRGT1 service returns control to your program, GPR 15 contains one of the following return codes:
|
Copyright IBM Corporation 1990, 2014
|