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