PERFORM JVMSERVER

管理 CICS® 区域中的 JVM 服务器。

语法

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

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

PERFORM JVMSERVER

条件: INVREQ ， LOCKED ， NOTAUTH ， NOTFND 和 TASKIDERR

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

此命令是线程安全的。

描述

使用 PERFORM JVMSERVER 命令通过调用以下三种类型之一的操作来管理 JVM 服务器:

任何 JVM 服务器类型
Liberty JVM 服务器
OSGi JVM 服务器

请参阅使用 CICS SPI 管理 JVM 服务器以获取详细讨论。

选项

APPID(数据区)

要在 Liberty JVM 服务器中刷新的应用程序文件的 id ，如 Liberty server.xml 配置中的 id 属性所定义。它包含尾部空格，最大长度为 255。

APPIDLEN(数据区)

APPID 的长度。它是可选的，如果未指定，那么缺省为 255。如果设置为 0 ，那么关联的 APPID 将变为空字符串。

DUMPTYPE( cvda )

指定要创建的 Java 转储类型。 CVDA 值包括：

ALL: 所有可用的转储类型 (缺省值)。
标高: Javacore 转储，包含有关正在运行的 JVM 进程的重要信息。
HEAP: Java 堆转储，包含驻留在 JVM 堆中的所有对象的快照。
SNAPTRACE: 包含跟踪点数据的 Java 快照跟踪。

GATHERTYPE( cvda )

指定要收集的信息类型。

诊断: 所有可用的 JVM 诊断。请参阅使用 PERFORM JVMSERVER SPI 收集 JVM 诊断以获取更多信息。

JVMACTION( cvda )

指定要执行的 JVM 服务器操作的类型。 CVDA 值包括：

DUMP: 在 JVMSERVER 上执行 Java 转储。
收集: 从 JVMSERVER 收集诊断文件。
堆栈跟踪: 创建 Java 线程的堆栈跟踪

JVMSERVER (数据区)

指定 JVMSERVER 的 8 字符名称。

JVMTYPE( cvda )

指定 CVDA 值，该值指示要对其执行操作的 JVM 服务器的类型。 CVDA 值包括：

JVM: 任何 JVM 服务器。
OSGi: OSGi JVM 服务器。
Liberty: Liberty JVM 服务器。

LIBRTYACTION( cvda )

指定要执行的 Liberty 服务器操作的类型。

服务器 DUMP: 在与指定 JVSERVER 关联的 Liberty 服务器上运行 Liberty 服务器转储命令。服务器转储命令用于问题诊断，生成的归档文件 (.zip) 位于 ${server_output_dir}中的 zFS 上。它包含 workarea 目录中已部署应用程序的服务器信息，日志信息和详细信息。可以将该命令应用到正在运行或已停止的服务器。
REFRESH: 通知 Liberty 对其应用程序或配置所作的更改。

OSGIACTION( cvda )

指定要执行的 OSGi 框架操作的类型。

重新启动 HPKGS: 刷新 JVMSERVER 的 OSGi 框架中的包，允许在框架中安装更新后的 OSGi 捆绑软件后重新连接导入和导出包。

RESOURCETYPE( cvda )

指定要刷新的 Liberty 资源的类型。

应用程序: 应用程序文件。
CONFIG: 所有配置文件。

TASKID（数据值）

指定运行 Java 线程的任务的 4 字节压缩十进制序号

条件

INVREQ

RESP2 值：

5: JVMACTION ， JVMTYPE ， OSGIACTION 或 LIBRTYACTION 选项具有无效的 CVDA 值或未指定。
12: 尝试与未启用的 JVMSERVER 进行交互。
13: 尝试对不是 OSGi JVMSERVER 的 JVMSERVER 执行 OSGI 操作。
14: 尝试使用不是 Liberty JVMSERVER 的 JVMSERVER 执行 Liberty 操作。
15: DUMPTYPE 选项具有无效的 CVDA 值。
16: RESOURCETYPE 选项具有无效的 CVDA 值。
19: 执行操作当前不可用。此操作稍后可能会变为可用。如果此问题仍然存在，请联系 IBM 支持人员。
20: 为 APPID 提供了无效的 APPIDLEN。
21: 同时指定了 GATHERTYPE 和 DUMPTYPE
22: 同时指定了 GATHERTYPE 和 OSGIACTION
23: 同时指定了 GATHERTYPE 和 LIBRTYACTION
24: 同时指定了 RESOURCETYPE (或表示 RESOURCETYPE 的 APPID) 和 SERVERDUMP
25: 同时指定了 RESOURCETYPE (或包含 RESOURCETYPE 的 APPID) 和 JVMACTION
26 日: 同时指定了 RESOURCETYPE (或包含 RESOURCETYPE 的 APPID) 和 OSGIACTION
28 日: 执行操作失败。请检查 JVM 服务器日志文件以获取任何错误消息。

LOCKED

RESP2 值：

27: 正在收集此 JVMSERVER 的诊断信息，或者正在执行 Liberty 服务器转储。

NOTAUTH

RESP2 值：

100: 未授权与发出任务关联的用户使用此命令。
101: 未授权与发出任务关联的用户访问此 JVMSERVER。

NOTFND

RESP2 值：

3: 找不到指定的 JVMSERVER 资源。
4: 找不到 APPID。

TASKIDERR

RESP2 值：

1: 找不到 TASKID。
2: TASKID 未运行 Java 线程。