INQUIRE_TASK_STORAGE64 调用

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

INQUIRE_TASK_STORAGE64

DFHSMMCX  [CALL,]
       [CLEAR,]
       [IN,
       FUNCTION (INQUIRE_TASK_STORAGE64),
       [TRANSACTION_NUMBER(name4 | (Rn) | *),]
       ELEMENT_BUFFER64(buffer-descriptor),
       LENGTH_BUFFER64(buffer-descriptor),]
       [OUT,
       NUMBER_OF_ELEMENTS(name4 | (Rn) | *),
       RESPONSE (name1 | *),
       REASON (name1 | *)]

此命令是线程安全的。

参数

ELEMENT_BUFFER64(buffer-descriptor)
定义缓冲区的地址和长度, CICS® 将返回属于指定任务或缺省情况下属于当前任务的任务生存期 64 位存储器的所有元素的开始地址列表。

返回的开始地址 包含前导检查区域。 有关缓冲区描述符的描述,请参阅 XPI 语法

LENGTH_BUFFER64(buffer-descriptor)
定义缓冲区的地址和长度, CICS 将返回属于指定任务或缺省情况下属于当前任务的任务生存期 64 位存储器的元素的长度列表。 返回的长度 包括前导或尾部检查区域。

有关缓冲区描述符的描述,请参阅 XPI 语法

NUMBER_OF_ELEMENTS (name4 | (Rn) | *)
以全字二进制值的形式返回两个缓冲区中的每个缓冲区 ( ELEMENT_BUFFER64 和 LENGTH_BUFFER64) 中的条目数。
TRANSACTION_NUMBER (name4 | (Rn) | *)
以 4 字节压缩十进制值的形式指定 64 位存储器所属任务的事务号。

如果省略事务 (任务) 号,那么 CICS 将采用当前任务。

注: XPI 命令只能在 AMODE 31 中运行。 INQUIRE_ELEMENT_LENGTH 和 INQUIRE_TASK_STORAGE64 将元素地址作为 64 位地址或在 31 位缓冲区中的 64 位地址列表返回。 AMODE 31 程序无法访问这些地址。

RESPONSE 和 REASON 值

下表列INQUIRE_TASK_STORAGE64响应和原因值。

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