SMGF gate, INQUIRE_ELEMENT_LENGTH function
The INQUIRE_ELEMENT_LENGTH function of the SMGF gate is used to return the length of an element of storage whose address is known.
Input Parameters
- ADDRESS
- is the address of the element under inquiry.
- STORAGE_CLASS
- Optional Parameter
- identifies the class of storage that is under inquiry.
- Values for the parameter are:
- CICS
- CICS24
- TASK
- TASK24
- TASK31
- USER
- USER24
- SUBPOOL_TOKEN
- Optional Parameter
- is a token identifying the subpool within which the element is allocated.
- LOCK_POOL
- Optional Parameter
- Indicates if access to the subpool is to be controlled by a lock.
- Values for the parameter are:
- NO
- YES
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- LOCK_ERROR
- LOOP
- UNLOCK_ERROR
- The following values are returned when RESPONSE is EXCEPTION:
- ADDRESS_NOT_FOUND
- The following values are returned when RESPONSE is INVALID:
- INVALID_STORAGE_CLASS
- INVALID_SUBPOOL_TOKEN
- SUBPOOL_LOCK_FAILED
- SUBPOOL_UNLOCK_FAILED
- ELEMENT_LENGTH
- is the length of the element.
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.