The Inquire_Short_On_Storage Call - IBM SC34-6814-04 Customization Manual

ELEMENT_ADDRESS(name4 | (Rn) | *)
ELEMENT_LENGTH(name4 | (Rn) | *)
RESPONSE and REASON values for
INQUIRE_ELEMENT_LENGTH:
RESPONSE
OK
EXCEPTION
DISASTER
INVALID
KERNERROR
PURGED

The INQUIRE_SHORT_ON_STORAGE call

INQUIRE_SHORT_ON_STORAGE enables you to determine whether CICS is short
on storage:
v above or below the 16MB line
v above the 2GB bar
INQUIRE_SHORT_ON_STORAGE
DFHSMSRX [CALL,]
This command is threadsafe.
SOS_ABOVE_THE_BAR(NO|YES),
SOS_ABOVE_THE_LINE(NO|YES),
SOS_BELOW_THE_LINE(NO|YES),
returns the start address of the element of task-lifetime storage referenced by
the ADDRESS parameter. The start address returned does not include the
leading check zone.
returns the length of the element of task-lifetime storage referenced by the
ADDRESS parameter. The length returned does not include the leading or
trailing check zones.
[CLEAR,]
[IN,
FUNCTION(INQUIRE_SHORT_ON_STORAGE),]
[OUT,
SOS_ABOVE_THE_BAR(NO|YES),
SOS_ABOVE_THE_LINE(NO|YES),
SOS_BELOW_THE_LINE(NO|YES),
RESPONSE (name1 | *),
REASON (name1 | *)]
returns YES if CICS is currently short-on-storage above the 2GB boundary, and
NO if not.
returns YES if CICS is currently short-on-storage above the 16MB line (and
below the 2GB boundary), and NO if not.
returns YES if CICS is currently short-on-storage below the 16MB line, and NO
if not.
REASON
None
INVALID_ADDRESS
None
None
None
None
Chapter 3. The user exit programming interface (XPI)
397