查询 STORAGE64

检索有关 64 位任务存储器的信息。

语法

警告系统命令功能强大，可提供有关系统状态的信息，并允许对系统进行更改。系统命令只能由授权应用程序和用户使用。

通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。

查询 STORAGE64

条件: INVREQ ， NOTAUTH 和 TASKIDERR

NOHANDLE、RESP 和 RESP2是常用选项，可添加到所有 EXEC CICS 命令中以处理错误条件。命令语法图和选项说明中没有明确包含这些选项。有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项.

此命令是线程安全的。

描述

使用 INQUIRE STORAGE64 来执行以下操作:

获取与特定任务关联的任务存储区域的列表 (通过使用 NUMELEMENTS 选项)。
查找 64 位存储器的特定区域的长度和起始地址 (通过使用 ADDRESS64 选项)。

INQUIRE STORAGE64 返回 64 位元素地址或与任务关联的 64 位地址的列表。该存储器仅可供在 AMODE 64 中运行的组合件语言程序访问。

INQUIRE STORAGE64 仅适用于分配给用户任务的存储，即执行用户定义事务或事务的任务。 CICS®

选项

ADDRESS64 (ptr-value): 指定您正在查询 64 位存储器的单个区域并标识该区域。您指定的地址可以在您要查询的区域内的任何位置; 它不必是其开头。 CICS 返回区域的长度（单位 FLENGTH ），如果是有效的用户任务存储单元，则返回其起始地址（单位 ELEMENT64 ），如果它是用户任务存储空间的有效元素。
DSANAME (data-value): 指定要为其返回存储元素的 DSA 的名称。
可能的值为 GCDSA 和 GUDSA。请参阅 CICS 动态存储区 (DSA)。如果省略此选项，那么将针对这两个 DSA 返回存储元素。
ELEMENT64 (ptr-ref): 返回存储区域的起始地址，该存储区域包含您在 ADDRESS64 选项上提供的地址 (如果该区域是用户任务存储器)。这是可用于任务数据的区域的第一个字节，而不是前面的存储管理控制信息 (如果有)。如果该区域不是用户任务存储器，那么返回的地址为空。
ELEMENTLIST (ptr-ref): 返回您在 TASK 选项上指定的任务的所有任务存储区域的双字地址列表的地址。每个地址都指向可用于数据存储的第一个字节，而不是前面的存储管理控制信息 (如果有)。此列表中的地址数是 NUMELEMENTS 选项值。 (地址的长度为 8 字节，因此列表的长度 (以字节为单位) 是 NUMELEMENTS的 8 倍。)
CICS 获取此列表的存储器，并在查询任务结束时释放此存储器，或者发出另一个带有 ELEMENTLIST 或 LENGTHLIST的 INQUIRE STORAGE 或 INQUIRE STORAGE64 命令，或者发出 INQUIRE TASK LIST 命令; 该任务无法释放存储器本身。
FLENGTH (数据区): 返回一个全字二进制字段，该字段给出包含您在 ADDRESS64 选项上指定的地址的存储区域的长度。这是可用于任务数据的部件的长度。它不包含区域开始或结束时的存储管理控制信息 (如果有)。如果该区域不是用户任务存储区，则返回的长度为 -1 。
LENGTHLIST (ptr-ref): 返回双字二进制长度列表的地址。此列表中的每个条目都是 ELEMENTLIST 列表中相应条目指向的存储区域的长度。这些长度是可用于数据存储的数量，不包括存储管理控制信息 (如果有)。
CICS 获取此列表的存储器，并在查询任务结束时释放此存储器，或者发出另一个带有 ELEMENTLIST 或 LENGTHLIST的 INQUIRE STORAGE 或 INQUIRE STORAGE64 命令，或者发出 INQUIRE TASK LIST 命令; 该任务无法释放存储器本身。
NUMELEMENTS (数据区): 指示您正在请求在 TASK 选项上指定的任务的任务存储区列表。 CICS 以全字二进制格式返回您提供的数据区中的区域数。如果请求 ELEMENTLIST 或 LENGTHLIST，那么此值是列表中的条目数。
TASK (data-value): 以 4 字节压缩十进制值的形式指定要为其请求存储列表的任务编号。如果省略此选项但包含 NUMELEMENTS，那么 CICS 将假定查询是针对发出 INQUIRE STORAGE64 命令的任务。

条件

INVREQ

RESP2 值：

1: 指定了无效的 DSANAME。

NOTAUTH

RESP2 值：

100: 与发出任务关联的用户无权使用此命令。

TASKIDERR

RESP2 值：

1: 任务号不存在。
2: 任务号指定系统任务，而不是用户任务。