INQUIRE JVMENDPOINT

检索有关 JVM 服务器端点的信息。

语法

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

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

INQUIRE JVMENDPOINT

读取语法图跳过可视语法图INQUIRE JVMENDPOINT( data-value)JVMSERVER( data-value)ENABLESTATUS( CVDA)TYPE( data-area)PORT( data-area)SECPORT( data-area)HOST( data-area)

条件: 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。