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,]
[CLEAR,]
[IN,
FUNCTION (INQUIRE_ELEMENT_LENGTH),
ADDRESS (name4 | (Rn) | *),]
[OUT,
ELEMENT_ADDRESS(name4 | (Rn) | *),
ELEMENT_LENGTH(name4 | (Rn) | *),
RESPONSE (name1 | *),
REASON (name1 | *)]
This command is threadsafe.
- 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 |