INQUIRE NETNAME

检索有关终端或会话的信息。

语法

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

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

查询网络名/终端

读取语法图跳过可视语法图INQUIRE NETNAME( data-value)TERMINAL(data-area)options
options

有关选项，请参阅查询终端。

条件: NOTAUTH 和 TERMIDERR

NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 CICS-值数据区 (CVDA)。

描述

INQUIRE NETNAME 命令返回有关特定终端或会话的信息，就像 INQUIRE TERMINAL 命令一样。 主要区别在于您通过终端的网络标识 (而不是其 CICS® 终端标识) 来标识该终端。 对于物理终端，网络标识是 z/OS® Communications Server用于识别终端的名称。 对于 ISC 会话，它是会话 (或会话组，如果存在并行会话) 对于 z/OS Communications Server已知的名称。 对于 MRO 会话，这是已连接区域用于登录到区域间通信程序的名称。

因此，与 INQUIRE TERMINAL 相比， NETNAME 和 TERMINAL 选项的角色相反; NETNAME 是必需的，您提供的数据值包含您要查询的终端的 8 字符网络标识。 TERMINAL 是可选的。 如果您使用它，那么 CICS 将在您提供的数据区域中返回相应的 4 字符 CICS 终端标识。

INQUIRE TERMINAL 的其他选项在 INQUIRE NETNAME 命令中返回的信息与在 INQUIRE TERMINAL 命令中返回的信息相同。

如果一个网络名有多个条目，并且查询不是浏览的一部分，那么将返回找到的第一个条目。 将按以下顺序搜索条目:
  1. z/OS Communications Server 终端和控制台 (按字母数字顺序)。
  2. 连接，按字母数字顺序。 将返回前导会话 (在浏览中，将返回所有会话)。

请注意，不保证在将来的发行版中维护此订单。

浏览

您还可以使用 INQUIRE NETNAME 或 INQUIRE TERMINAL 命令中的浏览选项（START、NEXT 和 END），浏览系统中安装的所有 NETNAME 资源的定义。 请参阅 浏览资源定义 ，以获取有关浏览的常规信息，包括语法，异常条件和示例。

请注意，不会返回没有会话的连接 (例如，间接连接或未使用的远程连接)。 如果要返回所有连接，请使用 INQUIRE CONNECTION 命令。

有关适用于 INQUIRE NETNAME 命令的选项和条件的详细信息，请参阅 INQUIRE TERMINAL。