CALL CSRPCON (Connect Cell Storage to an Extent)

The CALL CSRPCON cell pool service is used to connect cell storage to the extent that you specify or to reuse a disconnected extent.

The CSRPEXP service returned the extent number. The extent must be in the disconnected state, which means that you have not called CSRPACT to activate this particular extent.

Format

Read syntax diagramSkip visual syntax diagramname CALL CSRPCON,( cntl_alet, anchor_addr, area_addr, area_size, extent_num, 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.
area_addr
Specifies the variable containing the starting address of the cell storage area. The starting address of this area must be consistent with any boundary requirements that you might have.
area_size
Specifies the variable containing the size (binary or hexadecimal) of the storage area for the cells. CSRPCON determines the number of cells that fit in the area.
extent_num
When CSRPCON completes, the variable specifying extent_num contains the number of the extent to be connected. The extent number must be within the range 0 to 65,536.
return_code
When CSRPCON 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.

34
Program error. You issued the services in the wrong order, or did not issue a necessary service.

Action: Check to see if your program passed the wrong extent number. Make sure that the extent is in a disconnected state (that is, it has not been activated through CSRPACT or CSRPEXP).

48
Program error. The cell area length is not valid.

Action: Correct the cell area length. The cell area size cannot be less than the cell size.

4C
Program error. The service could not use the cell area address.

Action: If the cell area is in a data space, make sure that the cell area is completely within the data space.

50
Program error. The cell area is too large.

Action: Specify a larger extent size or a smaller cell area size.

64
Program error or system error. An extent chain was broken.

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 the anchor address being passed is for the right cell pool.