CALL CSRPQPL (Query the Cell Pool)

The CALL CSRPQPL cell pool service is used to receive status information about the cell pool.

CSRPQPL does not prevent other programs from changing the pool during or after a query. CSRPQPL returns the status as it was at the time you issued the call.

Format

Read syntax diagramSkip visual syntax diagramname CALL CSRPQPL,( cntl_alet, anchor_addr, user_name, cell_size, total_cells, avail_cells, number_extents, return_code)

Requirements for the caller

AMODE:
24 or 31 (System code must be in 31-bit addressing mode when calling the service. All input addresses must be valid 31-bit addresses.)
RMODE:
24 or ANY
ASC Mode:
Primary or AR (If the anchor and the extents are located in a data space, the caller must be in AR mode.)

Parameters

cntl_alet
Specifies the variable containing the ALET that identifies the location of the anchor and extents. Initialize the ALET to 0 if your program is running in AR mode and the anchor and extents are in the primary address space. If your program is running in primary ASC mode, the value is ignored, but you must code the parameter anyway.
anchor_addr
Specifies the variable containing the address of the 64-byte anchor.
user_name
When CSRPQPL completes, the variable specified by user_name contains the name on the CSRPBLD service that created the cell pool.
cell_size
When CSRPQPL completes, the variable specified by cell_size contains the size of each cell at the time the cell pool was created.
total_cells
When CSRPQPL completes, the variable specified by total_cells contains the total number of cells associated with the extent.
avail_cells
When CSRPQPL completes, the variable specified by avail_cells contains the total number of cells in active extents that are available for allocation.
number_extents
When CSRPQPL completes, the variable specified by number_extents contains the total number of extents (active or inactive, connected, or disconnected) in the cell pool.
return_code
When CSRPFRE completes, the variable specifying return_code contains the return code.

Return Codes in Register 15

00
The operation was successful.
1C
Program error. The anchor address is not valid.

Action: Check to see if your program passed the wrong anchor address or inadvertently overlaid the anchor area.

64
Program error or system error. The extent address is not valid.

Action: Check to see if your program inadvertently overlaid an extent area. Make sure that no extent belongs to more than one cell pool.

68
Program error or system error. An extent chain is circular.

Action: Check to see if your program inadvertently overlaid an extent area. Make sure that no extent belongs to more than one cell pool.