S2SR gate, INQUIRE_ACCESS function
The INQUIRE_ACCESS function of the S2SR gate is used to return the access key of a storage element in 64-bit storage and, optionally, the dynamic storage area (DSA) that contains the storage element.
Input Parameters
- ELEMENT_ADDRESS
- The start address of the storage element in 64-bit storage.
- ELEMENT_LENGTH
- The length of the storage element in 64-bit storage.
- ACCESS_TOKEN
- Optional Parameter
- The access token for the storage element (returned by the S2SR INQUIRE_ACCESS_TOKEN function).
Output Parameters
- ACCESS
- The type of access for the storage element.
- Values for the parameter are as follows:
- CICS
- 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:
- GCDSA
- 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
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.