CALL CSRPBLD (Build A Cell Pool And Initialize An Anchor)

The CALL CSRPBLD cell pool service is used to format a 64-byte area for the cell pool anchor.

You must first have acquired the storage for the anchor. You can call this service only once for a given cell pool.

Format

Read syntax diagramSkip visual syntax diagramname CALL CSRPBLD,( cntl_alet, anchor_addr, user_name, cell_size, return_code)

Requirements for the caller

AMODE:
24 or 31 (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 cell pool anchor.
user_name
Specifies the 8-byte variable containing the name that you want the service to assign to the pool. There are no restrictions on the name.
cell_size
Specifies the variable containing the cell size in this pool. You can use any positive binary or hexadecimal number as the cell size.
return_code
When CSRPBLD completes, this field (as well as R15) contains the return code.

Return Codes in Register 15

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

Action: The upper address of the anchor exceeds the valid address range. Check to see if your program passed the wrong anchor address.

44
Program error. The cell size is not valid: it cannot be negative or 0.

Action: Specify a positive value for the cell size.