Response and reason values for inquire_access, The inquire_element_length call – IBM SC34-6814-04 User Manual

Page 418

Advertising
background image

[OUT,
ACCESS(CICS | READ_ONLY | USER),
RESPONSE(name1 | *),
REASON(name1 | *)]

This command is threadsafe.

ACCESS(CICS|READ_ONLY|USER)

returns the access-key of the storage element.

CICS

CICS-key

READ_ONLY

Readonly storage

USER User-key.

ELEMENT_ADDRESS(name4 | (Rn) | *)

specifies the address of the storage element.

ELEMENT_LENGTH(name4 | (Rn) | *)

specifies the length of the storage element, in bytes. A length of zero is treated
as a length of one.

RESPONSE and REASON values for INQUIRE_ACCESS:

RESPONSE

REASON

OK

None

EXCEPTION

INVALID_ELEMENT

DISASTER

None

INVALID

None

KERNERROR

None

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.

396

Customization Guide

Advertising