Free Storage (CEEFRST) API

Required Parameter:

address

Input

POINTER

Omissible Parameter:

Output

FEEDBACK

  Service Program Name: QLEAWI

  Default Public Authority: *USE

  Threadsafe: Yes

The Free Storage (CEEFRST) API frees previously allocated heap storage.

Authorities and Locks

None.

address (input): The address returned by a previous CEEGTST call or a language-intrinsic function. The storage at this address is deallocated.

CEE0000	The API completed successfully
Severity: 00
CEE0802	The storage headers are damaged
Severity: 40
CEE0810	The starting address for reallocation is not valid
Severity: 30

The heap identifier is inferred from the address of the storage to be freed. The storage is deallocated from the heap in which it was allocated. The deallocate operation may be issued from an activation group other than the activation group that owns the heap.
The pointer to the address passed as the argument is no longer valid after this call. The storage freed by this operation can be reallocated on a subsequent CEEGTST call. If the pointer is not reassigned, any further use of it will have unpredictable results.

API introduced: V2R3