IBM SC34-6814-04 User Manual

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.

FREEMAIN releases an area of storage that is currently allocated to your exit
program.

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.

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

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.

DFHSMSRX [CALL,]

[CLEAR,]
[IN,
FUNCTION(INQUIRE_ACCESS),
ELEMENT_ADDRESS(name4 | (Rn) | *),
ELEMENT_LENGTH(name4 | (Rn) | *),]

Chapter 3. The user exit programming interface (XPI)