The Freemain Call; The Inquire_Access Call - IBM SC34-6814-04 Customization Manual

The FREEMAIN call

FREEMAIN releases an area of storage that is currently allocated to your exit
program.
FREEMAIN
DFHSMMCX [CALL,]
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
OK
EXCEPTIONNone
DISASTER
INVALID
KERNERROR
PURGED
Note: For more detail, refer to the explanation of RESPONSE and REASON in

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,]
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.
[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 | *)]
"Making an XPI call" on page 308.
[CLEAR,]
[IN,
FUNCTION(INQUIRE_ACCESS),
ELEMENT_ADDRESS(name4 | (Rn) | *),
ELEMENT_LENGTH(name4 | (Rn) | *),]
REASON
None
None
None
None
None
None
Chapter 3. The user exit programming interface (XPI)
395