SMSR gate, INQUIRE_ACCESS function

The INQUIRE_ACCESS function of the SMSR gate is used to return the access key of an element of storage, and optionally, the dynamic storage area (DSA) that contains the storage element.

Input Parameters

ELEMENT_ADDRESS
The start address of the storage element.
ELEMENT_LENGTH
The length of the storage element.
ACCESS_TOKEN
Optional Parameter
The access token for the element of storage (returned by the INQUIRE_ACCESS_TOKEN function).

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • LOOP
The following values are returned when RESPONSE is EXCEPTION:
  • INVALID_ELEMENT
The following values are returned when RESPONSE is INVALID:
  • INVALID_FUNCTION
ACCESS
The type of access for the storage element.
Values for the parameter are as follows:
  • CICS
  • READ_ONLY
  • USER
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
DSA_EXTENT_END
Optional Parameter
The end address of the DSA extent that contains the input address.
DSA_EXTENT_START
Optional Parameter
The start address of the DSA extent that contains the input address.
DSA_NAME
Optional Parameter
The name of the dynamic storage area (DSA) that contains the storage element.
Values for the parameter are as follows:
  • CDSA
  • ECDSA
  • ERDSA
  • ESDSA
  • ETDSA
  • EUDSA
  • RDSA
  • SDSA
  • UDSA


dfhs3_SMSRinquire_access.html | Timestamp icon Last updated: Monday, 5 June 2017