IBM SC34-6814-04 User Manual

Page of 953
ELEMENT_ADDRESS(name4 | (Rn) | *)
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.
ELEMENT_LENGTH(name4 | (Rn) | *)
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.
RESPONSE and REASON values for
INQUIRE_ELEMENT_LENGTH:
RESPONSE
REASON
OK
None
EXCEPTION
INVALID_ADDRESS
DISASTER
None
INVALID
None
KERNERROR
None
PURGED
None
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,]
[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 | *)]
This command is threadsafe.
SOS_ABOVE_THE_BAR(NO|YES),
returns YES if CICS is currently short-on-storage above the 2GB boundary, and
NO if not.
SOS_ABOVE_THE_LINE(NO|YES),
returns YES if CICS is currently short-on-storage above the 16MB line (and
below the 2GB boundary), and NO if not.
SOS_BELOW_THE_LINE(NO|YES),
returns YES if CICS is currently short-on-storage below the 16MB line, and NO
if not.
Chapter 3. The user exit programming interface (XPI)
397