INQUIRE_ELEMENT_LENGTH 调用

INQUIRE_ELEMENT_LENGTH 使您能够传递任务生存期存储器元素的任何部分的地址，并从 CICS® 获取包含所传递地址的存储元素的起始地址和长度。

INQUIRE_ELEMENT_LENGTH

DFHSMMCX  [CALL,]
       [CLEAR,]
       [IN,
       FUNCTION (INQUIRE_ELEMENT_LENGTH),
       ADDRESS (name4 | (Rn) | *),
       ADDRESS64 (name4 | (Rn) | *),]
       [OUT,
       ELEMENT_ADDRESS(name4 | (Rn) | *),
       ELEMENT_ADDRESS64(name4 | (Rn) | *),
       ELEMENT_LENGTH(name4 | (Rn) | *),
       ELEMENT_LENGTH64(name4 | (Rn) | *),       
       RESPONSE (name1 | *),
       REASON (name1 | *)]

此命令是线程安全的。

地址 (name4 | (Rn) | *): 指定位于当前任务的任务生存期存储元素中的地址。
CICS 接受引用前导或尾部检查区域的地址作为要查询的存储器元素的有效地址。
ADDRESS64(name4 | (Rn) | *): 指定位于当前任务的任务生存期 64 位存储器元素中的地址。
CICS 接受引用前导或尾部检查区域的地址作为要查询的存储器元素的有效地址。
ELEMENT_ADDRESS (name4 | (Rn) | *): 返回 ADDRESS 参数引用的任务生存期存储器元素的开始地址。返回的开始地址不包含前导检查区域。
ELEMENT_ADDRESS64(name4 | (Rn) | *): 返回 ADDRESS64 参数引用的任务生存期 64 位存储器元素的开始地址。返回的开始地址不包含前导检查区域。
ELEMENT_LENGTH (name4 | (Rn) | *): 返回 ADDRESS 参数引用的任务生存期存储器元素的长度。返回的长度不包含前导或尾部检查区域。
ELEMENT_LENGTH64(name4 | (Rn) | *): 返回 ADDRESS64 参数引用的任务生存期存储器元素的长度。返回的长度不包含前导或尾部检查区域。

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

INQUIRE_ELEMENT_LENGTH 的 RESPONSE 和 REASON 值

RESPONSE	推理
确定	无
EXCEPTION	INVALID_ADDRESS
DISASTER	无
INVALID	无
KERNERROR	无
PURGED	无