Discard Heap (CEEDSHP) API

Required Parameter:

heap_id

Input

INT4

Omissible Parameter:

Output

FEEDBACK

  Service Program Name: QLEAWI

  Default Public Authority: *USE

  Threadsafe: Yes

The Discard Heap (CEEDSHP) API deletes an existing heap.

Authorities and Locks

None.

CEE0000	The API completed successfully
Severity: 00
CEE0803	The heap identifier does not match any existing heap
Severity: 30
CEE0812	The basic initial heap cannot be marked and discarded
Severity: 30
CEE0850	The heap cannot be marked
Severity: 30

A heap_id of 0 is not valid. This is the heap identifier of the default heap; it cannot be discarded.
After this call, there may still be pointers to storage that had been allocated from this heap. Their use can cause unpredictable or erroneous results.

API introduced: V2R3