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.


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