FREEPOOL—Release a buffer pool (BDAM, BISAM, BPAM, BSAM, QISAM, and QSAM)

The FREEPOOL macro releases an area of storage, previously acquired for a buffer pool for a specified data control block. The area must have been acquired either automatically (except when dynamic buffer control is used) or by executing a GETPOOL macro. For queued access methods, you must issue a CLOSE macro for all the data control blocks using the buffer pool before issuing the FREEPOOL macro. For basic access methods, you can issue the FREEPOOL macro when the buffers are no longer required. A buffer pool need be released only once, regardless of the number of data control blocks sharing the buffer pool.

The FREEPOOL macro may be issued in 24- or 31-bit addressing mode. When issued in 31-bit addressing mode, all addresses must be valid 31-bit addresses.

When you request that OPEN obtain QSAM buffers above the 16MB line by coding RMODE31=BUFF on the DCBE macro, CLOSE will free the buffer pool.

If you issue a FREEPOOL macro for a DCB that does not have a buffer pool, the FREEPOOL has no effect.

FREEPOOL does not support buffers above the line.

The format of the FREEPOOL macro is:

dcb address—RX-Type Address, (2-12), or (1)
specifies the address of a data control block to which the buffer pool is assigned. When issued in 31-bit addressing mode, the input DCB address must be a clean 31-bit address.