INQUIRE MODENAME

描述

INQUIRE MODENAME 命令返回有关在与远程系统的连接中定义的一组会话 (有时称为 方式) 的信息。 (组的 MODENAME 是分配给创建该组的 SESSIONS 资源定义的名称。)

MODENAME 在给定连接中是唯一的，但在连接之间不是唯一的。 因此，要查看特定会话组，必须同时指定 MODENAME 和 CONNECTION 选项的数据值。

浏览

您还可以使用 INQUIRE MODENAME 命令上的浏览选项 (START ， NEXT 和 END) 来浏览特定连接的所有会话组或所有连接的所有组。

当在 INQUIRE MODENAME 命令上使用了浏览选项 START 和 END 时， CONNECTION 选项无效。

与单个 INQUIRE MODENAME 命令一样，必须在 INQUIRE MODENAME NEXT 命令上同时包含 MODENAME 和 CONNECTION 选项。 MODENAME 的数据值是可选的; 如果提供该数据值，那么 CICS® 将使用该数据值来返回会话组的名称。 如果要将浏览限制为单个连接，请指定 CONNECTION 的数据值。

要查看所有组，请在运行 INQUIRE MODENAME NEXT 命令之前初始化 CONNECTION 数据值。 使用每个 INQUIRE MODENAME NEXT 命令上 CONNECTION 数据值的输出作为下一个 INQUIRE MODENAME NEXT 命令的输入。 然后，您可以浏览所有连接的所有 MODENAME。

请参阅 浏览资源定义 ，以获取有关浏览的常规信息，包括语法，异常条件和示例。

选项

活动 (数据区)

返回一个半字二进制字段，给出组中当前正在使用的会话数。

AUTOCONNECT (cvda)

返回 CVDA 值，指示每当 CICS 启动与 z/OS® Communications Server的通信时，是否自动绑定此组中的会话。 CVDA 值包括：

ALLCONN

CICS 尝试同时绑定争用胜方会话和争用败方会话。

AUTOCONN

CICS 尝试仅绑定其争用获胜者的会话。

非自动连接

CICS 不会尝试绑定任何会话。

AVAILABLE (数据区)

返回一个半字二进制字段，给出组中的当前会话数 (数字 界限)。

连接 (data-value)

指定与此会话组相关联的远程系统的 4 字符标识 (该系统的 CONNECTION 资源定义的名称)。

MAXIMUM (数据区域)

返回半字二进制字段，给出会话组定义允许的最大会话数。

MAX优胜者 (数据区)

返回一个半字二进制字段，该字段给出会话组定义允许作为争用获胜者的最大会话数。 对于此字段，由 RDO 或自动安装安装的单会话 APPC 定义始终显示 0。

MODENAME (data-value)

指定要查询的会话组的 8 字符标识。 Modename 是组的 SESSIONS 资源定义的名称。

条件

END

RESP2 值：

2

没有更多此类型的资源定义。

ILLOGIC

RESP2 值：

1

当浏览此资源类型时，您已发出 START 命令，或者当浏览此资源类型时，您已发出 NEXT 或 END 命令。

NOTAUTH

RESP2 值：

100

未授权与发出任务关联的用户使用此命令。

SYSIDERR

RESP2 值：

1

找不到连接。

2

找不到连接中的 modename。

3

找不到在 INQUIRE MODENAME NEXT 上指定的连接。