SET JVMSERVER

更改已安装 JVMSERVER 资源的状态。

SET JVMSERVER

条件: INVREQ ， NORMAL ， NOTAUTH 和 NOTFND

此命令是线程安全的。

描述

SET JVMSERVER 命令用于启用，禁用和修改 JVM 服务器。

要更改在 CICS® 束中定义和安装的 JVMSERVER 资源的状态，请启用或禁用 CICS 束。如果已禁用 CICS 束，但需要清除仍在 JVM 服务器中运行的任务，那么可以使用 PURGE ， FORCEPURGE 或 KILL 选项对动态生成的 JVMSERVER 资源发出 SET JVMSERVER DISABLED 命令以清除任务。

要修改在 CICS 束中定义和安装的 JVMSERVER 资源的属性，请使用 CICS Explorer 中的资源编辑器来修改 CICS 束中的定义，并安装新版本的 CICS 束或部署该束的应用程序。要更新定义，请遵循使用 CICS Explorer 产品文档中的束中的指示信息，将旧版本的 CICS 束替换为新束。

可以单独更新单独部署或使用平台部署的 CICS 束。
如果 CICS 束是作为应用程序的一部分或通过应用程序绑定进行部署，请更新整个应用程序。

您可以使用 SET JVMSERVER 命令来更改动态生成的资源的属性，但这些更改不会编目，也不会在 CICS的热启动中恢复。

选项

ENABLESTATUS(cvda)

设置 JVMSERVER 资源的状态:

ENABLED: 启用 JVMSERVER 资源。 CICS 创建 Language Environment ® 相关可调度单元组，启动 JVM 并执行启用 JVMSERVER 所需的处理。一旦启用了 JVMSERVER ，应用程序可能需要额外的时间才能完全准备好处理请求。
DISABLED: 禁用 JVMSERVER 资源。 CICS 完成与 JVM 服务器关联的处理任务，然后停止 JVM 和 Language Environment 相关可调度单元组。

JVMSERVER(data-value)

指定要更改的 JVMSERVER 资源的 8 字符名称。

PURGETYPE(cvda)

指定在禁用资源时如何清除与 JVM 服务器相关联的任务。如果未设置值，那么 CICS 将使用 PHASEOUT 选项。

FORCEPURGE: 必须在发出 FORCEPURGE 之前发出 PURGE。; 将强制清除在 JVM 服务器中运行的任务。在 JVM 中运行的任何 CICS 线程都将停止。当存在剩余任务或 CICS 线程时， JVMSERVER 资源仍处于 "正在禁用" 状态。不保证数据完整性。
KILL: 必须先发出 FORCEPURGE ，然后再发出 KILL。; 在 JVM 服务器中运行的任务将终止。在 JVM 中运行的任何 CICS 线程都将停止。 JVMSERVER 资源进入 DISABLED 状态，所有工作都已终止。然而，CICS 可能仍处于不稳定状态。; 系统和数据完整性无法保证。 CICS 可能异常终止。; 在 JVMSERVER KILL 之后重新启动 CICS 区域被视为最佳实践。
PHASEOUT: 在 JVM 服务器中运行的任务将继续执行，直到完成为止，但不会启动任何新工作。完成所有任务后， JVMSERVER 资源将进入 DISABLED 状态。 PHASEOUT 是缺省值。如果 JVM 服务器是 Liberty JVM 服务器，那么会请求 Liberty 停顿，这可能需要几分钟才能完成，并且通常需要比 OSGi JVM 服务器更长的时间。
PURGE: 必须先发出 PHASEOUT ，然后才能发出 PURGE。; 将清除 JVM 服务器中运行的任务。在 JVM 中运行的任何 CICS 线程都将停止。仅当可以保证系统和数据完整性的前提下，CICS 才会清除任务。当存在剩余任务或 CICS 线程时， JVMSERVER 资源仍处于 "正在禁用" 状态。

THREADLIMIT(data-value)

设置 JVM 中允许的最大 CICS 线程数。每个 CICS 线程都使用 T8 TCB 进行连接。有效范围为 1-256。如果指定的值超过 CICS 区域的最大值 2000 (考虑到所有已启用和已禁用的 JVMSERVER 资源) ，那么 THREADLIMIT 将设置为到 2000 为止的剩余 CICS 线程数。

条件

INVREQ

RESP2 值：

1: 没有足够的 CICS 线程可用于满足请求的最大数目。
2: ENABLESTATUS 值无效。
3: THREADLIMIT 值无效，因为它是 0 或大于 256。
4: 未成功创建 Language Environment 相关可调度单元组。
7: 无法禁用 JVMSERVER ，因为它处于启用状态。
8: 必须先清除 JVM 服务器，然后才能使用 FORCEPURGE 选项。
9: PURGETYPE 选项具有无效的 CVDA 值。
10: 必须先 FORCEPURGE JVM 服务器，然后才能使用 KILL 选项。
11: 必须先 PHASEOUT JVM 服务器，然后才能使用 PURGE 选项。
300: 指定了对 BUNDLE 资源安装的资源无效的操作。
301: 仅当首先通过将父 BUNDLE 资源设置为 DISABLED 来隐式发出了 PHASEOUT 时，才能在捆绑软件安装的 JVMSERVER 上发出 PURGE ， FORCEPURGE 或 KILL。如果已禁用 BUNDLE ，但 JVMSERVER 处于 "正在禁用" 状态的时间比您期望的工作停顿时间长，或者如果您不想等待工作停顿，请考虑对 JVMSERVER 资源发出 PURGE 请求。

NORMAL

RESP2 值:

1: 可用的 CICS 线程数小于请求的 THREADLIMIT 值。

NOTAUTH

RESP2 值：

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

NOTFND

RESP2 值:

3: 找不到 JVMSERVER 资源。