Callable cell pool services

Note to reader

Note to reader In this section, the notation CSRPxxx/CSRC4xxx is used to indicate either the CSRPxxx service in AMODE 24 or 31, or the CSRC4xxx service in AMODE 64.

End of Note to reader
Callable cell pool services manage areas of virtual storage in the primary address space, in data spaces and in address spaces other than the primary address space. A cell pool is an area of virtual storage that is subdivided into fixed-sized areas of storage called cells, where the cells are the size you specify. A cell pool contains:

The anchor is the starting point or foundation on which you build a cell pool. Each cell pool has only one anchor. An extent contains information that helps callable cell pool services manage cells and provides information you might request about the cell pool. A cell pool can have up to 65,536 extents, each responsible for its own cell storage. Your program determines the size of the cells and the cell storage. Figure 1 illustrates the three parts of a cell pool.

Through callable cell pool services, you build the cell pool. You can then obtain cells from the pool. When there are no more cells available in a pool, you can use callable cell pool services to enlarge the pool.

To use callable cell pool services, your program issues the CALL macro to invoke one of the following services:
Your system's AMODE will determine which set of services to use, as follows: