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

This command is threadsafe.
ACCESS(CICS|READ_ONLY|USER)
ELEMENT_ADDRESS(name4 | (Rn) | *)
ELEMENT_LENGTH(name4 | (Rn) | *)
RESPONSE and REASON values for INQUIRE_ACCESS:
RESPONSE
OK
EXCEPTION
DISASTER
INVALID
KERNERROR

The INQUIRE_ELEMENT_LENGTH call

INQUIRE_ELEMENT_LENGTH enables you to pass the address of any part of an
element of task-lifetime storage, and to obtain from CICS the start address and the
length of the storage element that contains the passed address.
INQUIRE_ELEMENT_LENGTH
DFHSMMCX [CALL,]
This command is threadsafe.
ADDRESS(name4 | (Rn) | *)
396
Customization Guide
[OUT,
ACCESS(CICS | READ_ONLY | USER),
RESPONSE(name1 | *),
REASON(name1 | *)]
returns the access-key of the storage element.
CICS CICS-key
READ_ONLY
Readonly storage
USER User-key.
specifies the address of the storage element.
specifies the length of the storage element, in bytes. A length of zero is treated
as a length of one.
[CLEAR,]
[IN,
FUNCTION (INQUIRE_ELEMENT_LENGTH),
ADDRESS (name4 | (Rn) | *),]
[OUT,
ELEMENT_ADDRESS(name4 | (Rn) | *),
ELEMENT_LENGTH(name4 | (Rn) | *),
RESPONSE (name1 | *),
REASON (name1 | *)]
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.
REASON
None
INVALID_ELEMENT
None
None
None