CALL CSRPQEX (Query a Cell Pool Extent)
The CALL CSRPQEX cell pool service is used to receive status information about a specified extent.
Format
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.
- extent_num
- Specifies the variable containing the number of the extent the service will query.
- status
- When CSRPQEX completes, the variable specified for status contains
one of the following decimal numbers. These indicate the status of
the extent at the time of the CALL.
- 1
- Disconnected and inactive
- 2
- Connect in progress
- 3
- Connected and inactive
- 4
- Connected and active
- 5
- Disconnect in progress
- extent_addr
- When CSRPQEX completes, the variable specified for extent_addr contains the address of the extent.
- extent_len
- When CSRPQEX completes, the variable specified for extent_len contains the length of the extent, in bytes.
- area_addr
- When CSRPQEX completes, the variable specified for area_addr contains the address of cell storage.
- ,areasize
- When CSRPQEX completes, the variable specified for area_size contains the size of cell storage for the extent.
- total_cells
- When CSRPQEX completes, the variable specified by total_cells contains the total number of cells associated with the extent.
- avail_cells
- When CSRPQEX completes, the variable specified by avail_cells contains the total number of cells in active extents that are available for allocation.
- number_extents
- When CSRPQEX 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 CSRPQEX 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.
- 30
- Program error. The extent number is not valid.
Action: Specify the extent number within the range 1 to 65,536.
- 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.
- 6C
- Program error or system error. An extent could not be found.
Action: Check to see if your program inadvertently overlaid an extent area. Make sure that no extent belongs to more than one cell pool.
- 74
- Program error or system error. An extent has been overlaid.
Action: Check to see if your program inadvertently overlaid an extent area. Make sure that no extent belongs to more than one cell pool.