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.


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