The inquire_short_on_storage call – IBM SC34-6814-04 User Manual

Page 419

Advertising
background image

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

Advertising