The inquire_short_on_storage call – IBM SC33-1683-02 User Manual

Page 398

Advertising
background image

INQUIRE_ELEMENT_LENGTH

DFHSMMCX [CALL,]

[CLEAR,]

[IN,

FUNCTION (INQUIRE_ELEMENT_LENGTH),

ADDRESS (name4 | (Rn) | *),]

[OUT,

ELEMENT_ADDRESS(name4 | (Rn) | *),

ELEMENT_LENGTH(name4 | (Rn) | *),

RESPONSE (name1 | *),

REASON (name1 | *)]

ADDRESS(name4 | (Rn) | *)

specifies an address that lies within an element of task-lifetime storage of the
current task.

CICS accepts addresses that reference the leading or trailing check zones as
being valid addresses for the element of storage you are inquiring upon.

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 either above or below the 16MB line.

storage control functions

366

CICS TS for OS/390: CICS Customization Guide

Advertising