INQUIRE HOST
检索有关本地系统中虚拟主机的信息。
语法
警告系统命令功能强大，可提供有关系统状态的信息，并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。
条件: END ， ILLOGIC ， INVREQ ， NOTAUTH 和 NOTFND
NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 CICS-值数据区 (CVDA)。
此命令是线程安全的。
浏览
您还可以使用 INQUIRE HOST 命令上的浏览选项 (START ， NEXT 和 END) 来浏览该区域中存在的所有虚拟主机。 有关浏览的一般信息，包括语法、异常条件和示例，请参见 浏览资源定义。
选项
- HOST(数据值)
- 指定虚拟主机的名称。 每个虚拟主机的名称取自组成虚拟主机的 URIMAP 定义中指定的主机名。 例如，如果 CICS® 区域包含指定了主机名 www.example.com的 URIMAP 定义，那么 CICS 将创建名为 www.example.com的虚拟主机。 URIMAP 定义中的主机名最多可以有 120 个字符。
- ENBLESTATUS （cvda）
- 返回表示该虚拟主机状态的 CVDA 值。 CVDA 值包括：
- ENABLED
- 已启用虚拟主机。
- DISABLED
- 虚拟主机已禁用。 构成虚拟主机的 URIMAP 定义无法由应用程序访问。
- TCPIPSERVICE(数据区)
- 返回 TCPIPSERVICE 定义的 1 至 8 字符名称，该名称指定了与此虚拟主机相关的入站端口。 如果未提供此定义，那么虚拟主机将与所有 TCPIPSERVICE 定义相关。
条件
- END
- RESP2 值有：
- 2
- 没有更多虚拟主机。
- ILLOGIC
- RESP2 值有：
- 1
- 当浏览此资源类型时，您已发出 START 命令，或者当浏览此资源类型时，您已发出 NEXT 或 END 命令。
- INVREQ
- RESP2 值有：
- 10
- 指定的主机名包含不允许的字符，或者为空白。
- NOTAUTH
- RESP2 值有：
- 100
- 未授权与发出任务关联的用户使用此命令。
- NOTFND
- RESP2 值有：
- 5
- 找不到虚拟主机。