INQUIRE JVMENDPOINT
检索有关 JVM 服务器端点的信息。
语法
警告系统命令功能强大,可提供有关系统状态的信息,并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态(在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS),激活命令安全检查。
条件: END , ILLOGIC , NOTAUTH 和 NOTFND
NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项,用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息,请参阅 CICS-值数据区 (CVDA)。
描述
您可以使用 INQUIRE JVMENDPOINT SPI 来检索 JVM 服务器端点的详细信息。 目前仅支持Liberty服务器 HTTP 端点。
(可选) 可以提供 ENABLESTATUS , TYPE , HOST , PORT 和 SECPORT 参数以获取更多端点详细信息。 如果未在 Liberty 配置中指定,那么 HOST 可以为空。 如果没有在 Liberty 配置中定义,PORT 和 SECPORT 将等于 -1 。
要检索单个端点的详细信息,请发出以下命令: INQUIRE
JVMENDPOINT(data-value) JVMSERVER(data-value)。
要点: 使用 JVMENDPOINT SPI 时,请避免在 Liberty 端点名称中使用特殊字符。
浏览
您可以使用使用浏览语法的 INQUIRE JVMENDPOINT 命令上的浏览选项 (START , NEXT 和 END) 来浏览 JVM 服务器的所有端点。 有关浏览的一般信息,包括语法、异常条件和示例,请参阅 浏览资源定义。
选项
- JVMENDPOINT( 数据值 )
- 由 JVMSERVER 定义的端点的名称。 对于 Liberty 端点,这是在 server.xml中配置的端点元素的
id属性。 将除去此元素中的任何尾部空格 (区分大小写) ,并将其截断为 224 个字符。 - JVMSERVER( 数据值 )
- 定义端点的 JVMSERVER 的 8 字符名称。 这是必需的。
- ENABLESTATUS( cvda )
- 返回指示端点状态的 CVDA 值。 有效值为:
- ENABLED
- 指定端点是否正在侦听请求。
- DISABLED
- 指定端点是否未侦听请求。
- TYPE(数据区)
- 返回端点的类型。
- PORT(数据区)
- 返回此端点正在侦听的端口。 如果该端点未使用端口,或端口未知,则返回 -1 。
- SECPORT(数据区)
- 返回此端点正在侦听的安全端口。 如果该端点未使用安全端口,或者不知道安全端口,则返回 -1 。
- HOST(数据区)
- 返回此端点正在侦听的 TCP/IP 主机的详细信息。 如果端点未在主机上侦听,或者如果主机未知,那么将返回空字符串。
条件
- END
- RESP2 值:
- 2
- 没有更多此类型的资源定义。
- ILLOGIC
- RESP2 值:
- 1
- 当此资源类型的浏览已在进行时,您已发出 START 命令,或者当此资源类型的浏览未在进行时,您已发出 NEXT 或 END 命令。
- NOTAUTH
- RESP2 值:
- 100
- 未授权与发出任务关联的用户使用此命令。
- 101
- 未授权与发出任务关联的用户访问此 JVMSERVER。
- NOTFND
- RESP2 值:
- 1
- 找不到指定的 JVMSERVER 资源或该资源已禁用。
- 3
- 找不到指定的 JVMENDPOINT。
