INQUIRE_TASK_STORAGE 调用

INQUIRE_TASK_STORAGE 使您能够请求属于任务的任务生存期存储器的所有元素的详细信息。您可以在调用上显式指定任务的事务号，或者使其缺省为当前任务。

INQUIRE_TASK_STORAGE

DFHSMMCX  [CALL,]
       [CLEAR,]
       [IN,
       FUNCTION (INQUIRE_TASK_STORAGE),
       [TRANSACTION_NUMBER(name4 | (Rn) | *),]
       ELEMENT_BUFFER(buffer-descriptor),
       LENGTH_BUFFER(buffer-descriptor),]
       [OUT,
       NUMBER_OF_ELEMENTS(name4 | (Rn) | *),
       RESPONSE (name1 | *),
       REASON (name1 | *)]

此命令是线程安全的。

ELEMENT_BUFFER (缓冲描述符): 定义缓冲区的地址和长度， CICS® 将返回属于指定任务或缺省情况下属于当前任务的任务生存期存储器的所有元素的开始地址列表。
返回的开始地址不包含前导检查区域。有关缓冲区描述符的描述，请参阅 XPI 语法。
LENGTH_BUFFER (缓冲描述符): 定义缓冲区的地址和长度， CICS 将返回属于指定任务或缺省情况下属于当前任务的任务生存期存储器元素的长度列表。返回的长度不包括前导或尾部检查区域。
有关缓冲区描述符的描述，请参阅 XPI 语法。
NUMBER_OF_ELEMENTS (name4 | (Rn) | *): 以全字二进制值形式返回两个缓冲区 (ELEMENT_BUFFER 和 LENGTH_BUFFER) 中的每个缓冲区中的条目数。 NUMBER_OF_ELEMENTS 可以为零。
TRANSACTION_NUMBER (name4 | (Rn) | *): 以 4 字节压缩十进制值的形式指定存储器所属任务的事务号。
如果省略事务 (任务) 号，那么 CICS 将采用当前任务。

INQUIRE_TASK_STORAGE 的 RESPONSE 和 REASON 值

RESPONSE	推理
确定	无
EXCEPTION	存储器不足
	NO_TRANSACTION_environment
DISASTER	无
INVALID	无
KERNERROR	无
PURGED	无