IBM SC34-6814-04 - Manual (Page 417)

2. ‘INSUFFICIENT_STORAGE’ is returned if the GETMAIN request was
specified with SUSPEND(NO), and there was not enough storage
available to satisfy the request.
3. ‘PURGED’ is returned if the GETMAIN request was specified with
SUSPEND (YES), there was not enough storage to satisfy the request,
and the task was purged.
The FREEMAIN call
FREEMAIN releases an area of storage that is currently allocated to your exit
program.
FREEMAIN
DFHSMMCX [CALL,]
[CLEAR,]
[IN,
FUNCTION(FREEMAIN),
ADDRESS(name4 | (Rn) | *),
[STORAGE_CLASS(CICS|CICS24|SHARED_CICS|SHARED_CICS24|
SHARED_USER|SHARED_USER24|USER|USER24|TERMINAL),]
[TCTTE_ADDRESS(pointer),]]
[OUT,
RESPONSE(name1 | *),
REASON(name1 | *)]
This command is threadsafe.
The explanation of the options is the same as that given above for the GETMAIN
function.
RESPONSE and REASON values for FREEMAIN:
RESPONSE REASON
OK None
EXCEPTIONNone None
DISASTER None
INVALID None
KERNERROR None
PURGED None
Note: For more detail, refer to the explanation of RESPONSE and REASON in
“Making an XPI call” on page 308.
The INQUIRE_ACCESS call
INQUIRE_ACCESS returns the access-key of an element of storage specified by
start address and length. If the element is not wholly contained within one of the
CICS dynamic storage areas (DSAs), CICS returns an exception response.
INQUIRE_ACCESS
DFHSMSRX [CALL,]
[CLEAR,]
[IN,
FUNCTION(INQUIRE_ACCESS),
ELEMENT_ADDRESS(name4 | (Rn) | *),
ELEMENT_LENGTH(name4 | (Rn) | *),]
Chapter 3. The user exit programming interface (XPI) 395