Retrieve information about task storage.
INQUIRE STORAGE >>-INQUIRE STORAGE----------------------------------------------> >--+-ADDRESS(ptr-value)--+-------------+--+-------------+-+---->< | '-| Element |-' '-| Flength |-' | '-| nlist |--| elist |--| llist |--| task |------------' Element: |--ELEMENT(ptr-ref)---------------------------------------------| Flength: |--FLENGTH(data-area)-------------------------------------------| nlist: |--NUMELEMENTS(data-area)---------------------------------------| elist: |--+----------------------+-------------------------------------| '-ELEMENTLIST(ptr-ref)-' llist: |--+---------------------+--------------------------------------| '-LENGTHLIST(ptr-ref)-' task: |--+------------------+-----------------------------------------| '-TASK(data-value)-'
Conditions: NOTAUTH, TASKIDERR
The INQUIRE STORAGE command has two functions. You can use it to get a list of the task storage areas associated with a particular task (using the NUMELEMENTS option), or you can use it to find the length and starting address of a particular area of storage (using the ADDRESS option). INQUIRE STORAGE applies only to storage allocated to user tasks, which are tasks executing user-defined transactions or the CICS-supplied transactions normally invoked by an operator.
Possible values are CDSA, UDSA, ECDSA, and EUDSA. If you omit this option, storage elements are returned for all four DSAs.
CICS obtains the storage for this list and frees it when the inquiring task ends, or issues another INQUIRE STORAGE command with ELEMENTLIST or LENGTHLIST, or issues an INQUIRE TASK LIST; the task cannot free the storage itself.
CICS obtains the storage for this list and frees it when the inquiring task ends, or issues another INQUIRE STORAGE command with ELEMENTLIST or LENGTHLIST, or issues an INQUIRE TASK LIST; the task cannot free the storage itself.