Free Storage (CEEFRST) API
Required Parameter:
| 1 | address | Input | POINTER |
Omissible Parameter:
| 2 | fc | 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.
Required Parameter
- address (input)
- The address returned by a previous CEEGTST call or a language-intrinsic function. The storage at this address is deallocated.
Omissible Parameter
- fc (output)
- A 12-byte feedback code.
Feedback Codes and Conditions
| 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 |
Usage Notes
- 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
[ Back to top | ILE CEE APIs | APIs by category ]