SMMC gate, INQUIRE_TASK_STORAGE function
The INQUIRE_TASK_STORAGE function of the SMMC gate is used to obtain details of all the task-lifetime storage that is associated with the specified task or the current task (depending whether the input parameter TRANSACTION_NUMBER is supplied).
Input Parameters
- ELEMENT_BUFFER
- A buffer into which the storage manager returns the start addresses of all the task-lifetime storage of the specified task.
- LENGTH_BUFFER
- A buffer into which the storage manager returns the lengths of all the task-lifetime storage of the specified task.
- DSA_NAME
- Optional Parameter
- The DSA that contains the storage elements under inquiry.
- TRANSACTION_NUMBER
- Optional Parameter
- The transaction to obtain storage details about. If this parameter is omitted, this function returns storage details of the current task.
Output Parameters
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- INSUFFICIENT_STORAGE
- INVALID_DSA_NAME
- NO_TRANSACTION_ENVIRONMENT
- NUMBER_OF_ELEMENTS
- The number of storage elements in each buffer.
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.