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.


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