JVM 服务器概要文件选项

选项如何应用于 JVM 服务器的不同用途

下表指示特定使用 JVM 服务器时是需要选项 (可选) 还是不支持选项。

Axis2

不推荐使用的功能: 不推荐使用对 Web Service 数据变换服务的基于 JVMSERVER 的配置选项的支持。 使用 CICS 网络服务的非 Java 管道可替代已废弃的选项、 z/OS Connect Enterprise Edition 或使用 Java 或 Node.js.更多详情，请参阅稳定化通知。

JVM 服务器选项和描述

_DFH_UMASK= {007|number}

设置创建 JVMSERVER 文件时适用的 z/OS® UNIX System Services 进程 UMASK。 此值为三位数字 octal。 例如，缺省值 007 允许尊重所有者和组的预期 read/write/execute 许可权，同时防止在创建文件时将 read/write/execute 授予 other 。 提供的值必须在 000 (限制最少) 到 777 (限制最多) 的范围内。 UMASK 适用于 JVM 的生存期。

为了安全起见，最佳实践是将 z/OS 用户标识分配给组。 可以在组级别应用许可权，而不是单独应用许可权。

CICS_WLP_MODE= {INTEGRATED| STANDARD}

对于 Liberty JVM 服务器，请选择 CICS 与 Liberty 之间的集成级别。

指定 INTEGRATED 方式以使用 CICS 集成方式 Liberty。 Liberty JVM 服务器使用 CICS 启用线程运行，尊重 CICS 安全性，与 CICS 工作单元集成，并为您的 Java 网络应用程序提供用于 CICS (JCICS) API 的 Java™ 类库。 如果省略了此选项或此选项无效，那么将使用缺省值 INTEGRATED 。

指定 STANDARD 方式以使用 CICS 标准方式 Liberty。 Liberty JVM 服务器以对所有 Liberty 支持的平台更标准的方式运行。 此方式允许您将 Liberty 应用程序从其他平台移植并部署到 CICS ，而不进行更改。 JVM 服务器保留对 Liberty 服务器的控制，并管理服务器创建，生命周期和配置。 但是，缺省情况下，线程未启用 CICS ，并且不会在 CICS 事务上下文中运行。 CICS 工作单元集成， CICS 安全性集成和 JCICS API 不可用于 Java 应用程序。

CLASSPATH_PREFIX， CLASSPATH_SUFFIX=classpathnames

使用这些选项来指定要由未启用 OSGi 的 JVM 搜索的目录路径， Java 归档文件和压缩文件。 例如，它用于 Java Web Service。 如果要使用 OSGi 框架，请不要设置类路径，因为 OSGi 框架会为您处理类装入。 如果使用这些选项来指定 Axis2的标准类路径，那么还必须指定 JAVA_PIPELINE=TRUE 以启动 Axis2 引擎。

CLASSPATH_PREFIX 将类路径条目添加到标准类路径的开头， CLASSPATH_SUFFIX 将它们添加到标准类路径的结尾。 您可以通过在要继续的每行末尾使用 \ (反斜杠) 在单独的行上指定条目。

请谨慎使用 CLASSPATH_PREFIX 选项。 CLASSPATH_PREFIX 中的类优先于 CICS 和 Java 运行时提供的同名类，并且可能会装入错误的类。

CICS 通过使用 USSHOME 系统初始化参数和 JVM 概要文件中的 JAVA_HOME 选项指定的目录的 /lib 子目录，为 JVM 构建基类路径。 此基类路径包含由 CICS 和 JVM 提供的 Java 归档文件。 它在 JVM 概要文件中不可见。 请勿在 JVM 概要文件中的类路径中再次指定这些文件。

使用冒号 (:) 而不是逗号来分隔使用 CLASSPATH_PREFIX 或 CLASSPATH_SUFFIX 选项指定的多个项。

DIAGS_ARCHIVE_DIR=路径名

指定当 PERFORM JVMSERVER (jvmserver-name) JVM GATHER DIAGNOSTICS 命令完成时，诊断归档 tar 文件的存储位置。 请参阅 使用 PERFORM JVMSERVER SPI 收集 JVM 诊断。 缺省值为 ${WORKDIR}/diagnostics/archives。

DIAGS_TEMP_DIR=路径名

指定最初创建诊断归档 tar 文件的位置以及将跟踪信息存储为 PERFORM JVMSERVER (jvmserver-name) JVM GATHER DIAGNOSTICS 命令运行的位置。 请参阅 使用 PERFORM JVMSERVER SPI 收集 JVM 诊断。 缺省值为 /tmp。

DISPLAY_JAVA_VERSION= {TRUE| FALSE}

如果此选项设置为 TRUE ，那么当应用程序启动 JVM 时， CICS 会将消息 DFHSJ0901 写入 MSGUSER 日志，显示正在使用的 IBM Software Developer Kit for z/OSJava Technology Edition 的版本和构建。

IDENTITY_PREFIX= {TRUE| FALSE}

要建立 JVM 服务器输出的源，所有 STDOUT和路由到 JES 的 STDERR 条目都将使用 JVM 服务器名称的前缀字符串进行写入，这在多个 JVM 服务器共享 JES 目标时很有用。 可以通过设置 IDENTITY_PREFIX=FALSE来禁用此行为，这将禁止使用前缀字符串。

JAF_REG政务司= {TRUE| FALSE}

6.2 及更高版本此选项已过时。 CICS 会根据需要自动将 Jakarta 激活框架 (JAF) 功能添加到 JVM 服务器运行时。 在 Java 11 之前，此技术包含在 JRE 中。

6.1 指定将 Jakarta Activation Framework (JAF) 注册 JAR 文件自动添加到 JVM 运行时环境以支持 Java 应用程序使用 JAF。 对于 Liberty JVM 服务器，将忽略此选项。 可以通过设置 JAF_REGISTRATION=FALSE来选择退出这些文件的自动添加。 如果不需要此功能，那么选择性停用可防止与较新的 JAR 文件发生潜在冲突，可使 JVM 占用量变小，并避免不必要的类装入。 在 Java 11 之前，此技术包含在 JRE 中。

java_dump_tdump_pattern=

z/OS UNIX System Services 环境变量，用于指定要用于来自 JVM 的事务转储 (TDUMP) 的文件名模式。 如果发生 JVM 异常终止，那么会将 Java TDUMP 写入数据集目标。

JAVA_HOME=/usr/lpp/java/javadir/

指定 z/OS UNIX 中 IBM® 64 位 SDK for z/OS、Java Technology Edition 或 IBM Semeru Runtime® Certified Edition for z/OS 安装位置。 此位置包含 Java 支持所需的子目录和 Java 归档文件。

提供的样本 JVM 概要文件包含由 DFHISTAR CICS 安装作业中的 JAVADIR 参数生成的路径。 JAVADIR 参数的缺省值为 java/J8.0_64/，这是 IBM 64 位 SDK for z/OSJava Technology Edition的缺省安装位置。 此值会在 /usr/lpp/java/J8.0_64/的 JVM 概要文件中生成 JAVA_HOME 设置。

有关更多信息，请参阅 设置 Java 运行时的版本。

JAVA_PIPELINE= {TRUE |FALSE}

将必需的 Java 归档文件添加到类路径，以便 JVM 服务器可以支持 Java 标准 SOAP 管道中的 Web Service 处理。 缺省值为 false。 如果设置此值，那么 JVM 服务器将配置为支持 Axis2 而不是 OSGi。 您可以使用 CLASSPATH 选项将更多 JAR 文件添加到类路径。

注: 选项 JAVA_PIPELINE=TRUE 和 SECURITY_TOKEN_SERVICE=TRUE 不兼容。

不推荐使用的功能: 不推荐使用对 Web Service 数据变换服务的基于 JVMSERVER 的配置选项的支持。 使用 CICS 网络服务的非 Java 管道可替代已废弃的选项、 z/OS Connect Enterprise Edition 或使用 Java 或 Node.js.更多详情，请参阅稳定化通知。

JAXB_REG政务司= {TRUE| FALSE}

6.2 及更高版本此选项已过时。 CICS 会根据需要在 JVM 服务器运行时自动添加 Jakarta XML Binding API (JAXB) 功能。 在 Java 11 之前，此技术包含在 JRE 中。

6.1 指定将 Jakarta XML Binding API (JAXB) 注册 JAR 文件自动添加到 JVM 运行时环境中，以支持 Java 应用程序使用 JAXB。 对于 Liberty JVM 服务器，将忽略此选项。 可以通过设置 JAXB_REGISTRATION=FALSE来选择退出这些文件的自动添加。 如果不需要此功能，那么选择性停用可防止与较新的 JAR 文件发生潜在冲突，可使 JVM 占用量变小，并避免不必要的类装入。 在 Java 11 之前，此技术包含在 JRE 中。

JNDI_REG政务司= {TRUE| FALSE}

指定将 JNDI 注册 JAR 文件自动添加到 JVM 运行时环境以支持 Java 应用程序使用 JNDI。 对于 Liberty JVM 服务器，将忽略此选项。 可以通过设置 JNDI_REGISTRATION = FALSE 来选择退出这些文件的自动添加。 如果不需要此功能，那么选择性停用可防止与较新的 JAR 文件发生潜在冲突，可使 JVM 占用量变小，并避免不必要的类装入。

JVM 日志={{&APPLID;.&JVMSERVER;.}Dyyyymmdd.Thhmmss.dfhjvmlog|文件名|作业日志|// DD:数据定义}

指定 z/OS UNIX 文件或 JES DD 的名称，JVM 服务器日志将在 JVM 服务器运行期间写入该文件或 JES DD。 如果未设置此选项的值，那么 CICS 会自动为每个 JVM 服务器创建唯一的日志文件。

如果 JVMLOG 保留为缺省值或是相对文件名，那么输出位置取决于 LOG_PATH_COMPATIBILITY 选项。 如果 LOG_PATH_COMPATIBILITY=FALSE，那么文件将放在 WORK_DIR/applid/jvmserver 目录中。 如果 LOG_PATH_COMPATIBILITY=TRUE，那么文件将放在 WORK_DIR 目录中。

如果为 JVMLOG指定了绝对文件名，那么 CICS 将在路径中创建不存在的任何目录。

如果该文件存在，那么输出将追加到该文件的末尾。 要为每个 JVM 服务器创建唯一的输出文件，请在文件名中使用 JVMSERVER 和 APPLID 符号，如样本 JVM 概要文件中所示。 如果将 JVMLOG 保留为缺省值，那么 CICS 将使用 APPLID 和 JVMSERVER 符号以及 JVM 服务器开始创建唯一输出文件的日期和时间戳记。

要路由到 JES DD ，请使用语法 // DD:data_definition从 JES 指定数据定义名称。

如果此选项设置为 JOBLOG，那么会将 JVMLOG 路由到当前 stdout 位置。

JVMTRACE={{&APPLID;.&JVMSERVER;.}Dyyyymmdd.Thhmmss.dfhjvmtrc|文件名|作业日志|// DD :data_definition}

指定 z/OS UNIX 文件或 JES DD 的名称，在 JVM 服务器运行期间，JVM 服务器跟踪会写入该文件或 JES DD。 如果没有为此选项设置值，那么 CICS 会自动为每个 JVM 服务器创建唯一的跟踪文件。

如果 JVMTRACE 保留为缺省值或为相对文件名，那么输出位置取决于 LOG_PATH_COMPATIBILITY 选项。 如果 LOG_PATH_COMPATIBILITY=FALSE，那么文件将放在 WORK_DIR/applid/jvmserver 目录中。 如果 LOG_PATH_COMPATIBILITY=TRUE，那么文件将放在 WORK_DIR 目录中。

如果为 JVMTRACE指定了绝对文件名，那么 CICS 将在路径中创建不存在的任何目录。

如果该文件存在，那么输出将追加到该文件的末尾。 要为每个 JVM 服务器创建唯一的输出文件，请在文件名中使用 JVMSERVER 和 APPLID 符号，如样本 JVM 概要文件中所示。 如果将 JVMTRACE 保留为缺省值，那么 CICS 将使用 APPLID 和 JVMSERVER 符号以及 JVM 服务器开始创建唯一输出文件的日期和时间戳记。

要路由到 JES DD ，请使用语法 // DD:data_definition从 JES 指定数据定义名称。

如果此选项设置为 JOBLOG，那么 JVMTRACE 将路由到当前 stdout 位置。

LIBERTY_INCLUDE_XML=文件名

指定要作为 <include> 元素添加到 server.xml 的文件或以逗号分隔的文件列表。

在变量前使用 + 字符来附加逗号以及对该变量的现有值指定的值。 例如：

LIBERTY_INCLUDE_XML=/path/file1
+LIBERTY_INCLUDE_XML=/path/file2

这相当于:

LIBERTY_INCLUDE_XML=/path/file1,/path/file2

LIBERTY_PRODUCT_EXTENSIONS=名称; 位置

允许将您自己的产品扩展安装到 Liberty 服务器中。

name 是产品扩展的唯一名称。 它也用作功能部件前缀。 位置 是 zFS 上产品扩展所在的目录的绝对位置。

您可以使用逗号来分隔多个产品扩展，以添加多个产品扩展。 或者，可以使用附加语法。

LIBERTY_PRODUCT_EXTENSIONS=product1;/u/product1, product2;/u/product2

OR

LIBERTY_PRODUCT_EXTENSIONS=product1;/u/product1
+LIBERTY_PRODUCT_EXTENSIONS=product2;/u/product2

警告: 请勿将产品扩展命名为 cicsts ，因为它与核心 JVM 服务器支持冲突并提供不可预测的结果。

请勿将产品扩展命名为 usr ，因为 Liberty 会在 ${wlp.usr.dir}/extension 目录而不是您自己的目录中查找扩展。

LIBPATH_PREFIX， LIBPATH_SUFFIX=路径名

指定要搜索的目录路径，以查找 JVM 使用的、扩展名为 .so 的本地 C 动态链接库 (DLL) 文件， z/OS UNIX。 这包括运行 JVM 所需的文件以及应用程序代码或服务加载的附加本地库。

JVM 的基本库路径是通过使用 USSHOME 系统初始化参数和 JVM 概要文件中的 JAVA_HOME 选项指定的目录自动构建的。 基本库路径在 JVM 概要文件中不可见。 它包含运行 JVM 所需的所有 DLL 文件以及 CICS所使用的本机库。

您可以使用 LIBPATH_SUFFIX 选项来扩展库路径。 此选项将目录添加到库路径末尾的基本库路径之后。 使用此选项来指定包含应用程序所使用的任何其他本机库的目录。 此外，使用此选项来指定未包括在 CICS的标准 JVM 设置中的任何服务所使用的目录。 例如，其他本机库可能包含使用 Db2® JDBC 驱动程序所需的 DLL 文件。

LIBPATH_PREFIX 选项在基本库路径之前将目录添加到库路径的开头。 小心使用这个选项。 如果指定目录中的 DLL 文件与基本库路径上的 DLL 文件同名，那么将装入这些文件而不是所提供的文件。

使用冒号 (:) 而不是逗号来分隔使用 LIBPATH_PREFIX 或 LIBPATH_SUFFIX 选项指定的多个项。

库路径上供应用程序使用的 DLL 文件必须使用 XPLink 选项进行编译和链接。 使用 XPLink 选项进行编译和链接可提供最佳性能。 在基本库路径上提供的 DLL 文件和服务 (例如 Db2 JDBC 驱动程序) 所使用的 DLL 文件是使用 XPLink 选项构建的。

LOG_FILES_MAX= {0|number}

指定系统上保留的旧日志文件数。 缺省设置 0 可确保保留日志文件的所有旧版本。 您可以更改此值以指定要保留在文件系统上的旧日志文件数。

如果为 LOG_PATH_COMPATIBILITY=TRUE，那么将忽略 LOG_FILES_MAX 。

如果 STDOUT、 STDERR、 JVMLOG 和 JVMTRACE 使用默认方案，或者自定义方案中包含 &DATE;.&TIME; 模式，则系统中只保留每种日志类型的最新编号。 如果您的定制不包含任何使输出唯一的变量，那么会将文件追加到其中，并且不需要删除。 只有带有 .dfhjvmtrc, .dfhjvmlog, .dfhjvmout 或 .dfhjvmerr 的文件才会被删除。

如果将输出变量定制为将输出路由到 DD: // 或 JOBLOG ，那么清除不适用。

LOG_LEVEL= {INFO|WARNING|ERROR|NONE}

提供对 dfhjvmlog 文件中返回的已记录信息的控制。 值 NONE 将禁止所有输出，并且该文件为空。 任何其他值指示写入 dfhjvmlog 文件的最低日志类型。 例如，选择 WARNING 将给出 WARNING 级别和更高级别的日志条目。

LOG_PATH_COMPATIBILITY= {TRUE |FALSE}

缺省值为 LOG_PATH_COMPATIBILITY=FALSE ，用于提供合并日志输出。 这会将 JVMSERVER 日志文件放置在 JVMSERVER的现有子组件 (例如， OSGi 框架和 Liberty 服务器) 所使用的同一输出目录结构中。 要还原为先前发行版的行为，请将参数设置为 LOG_PATH_COMPATIBILITY=TRUE ，并在原始位置创建 JVMSERVER 日志目录。

OSGI_BUNDLES=路径名

指定在 OSGi JVM 服务器的 OSGi 框架中启用的中间件束的目录路径。 这些 OSGi 捆绑软件包含用于在框架中实现系统功能的类，例如，连接到 IBM MQ 或 Db2。 要指定多个 OSGi 捆绑软件，请使用逗号来分隔这些捆绑软件。

OSGI_CONSOLE= {TRUE |FALSE}

将必需的 OSGi 捆绑软件添加到 OSGi 框架以启用 OSGi 控制台。 还必须在 JVM 概要文件中设置以下属性: -Dosgi.console=host:port 和 -Dosgi.file.encoding={ISO-8859-1|US-ASCII|ASCII}。 缺省值为 false。 如果要查看 OSGi 捆绑软件和服务的状态，请参阅 对 Java 应用程序进行故障诊断。

OSGI_FRAMEWORK_TIMEOUT= {60|number}

指定 CICS 在 OSGi 框架超时之前等待其初始化或关闭的秒数。 您可以设置 1-60000 秒范围内的值。 缺省值为 60 秒。 如果 OSGi 框架的启动时间超过指定的秒数，那么 JVM 服务器将无法初始化，并且 CICS 将发出 DFHSJ0215 消息。 错误消息将写入 zFS中的 JVM 服务器日志文件。 如果 OSGi 框架需要比指定秒数更长的时间来关闭，那么 JVM 服务器无法正常关闭。

PRINT_JVM_OPTIONS= {TRUE |FALSE}

如果此选项设置为 TRUE ，那么当 JVM 启动时，会将在启动时传递到 JVM 的选项也打印到 SYSPRINT。 每次 JVM 在其概要文件中使用此选项启动时，都会生成输出。 您可以使用此选项来检查特定 JVM 概要文件的类路径的内容，包括基本库路径和 CICS构建的基本类路径 (在 JVM 概要文件中不可见)。

PRINT_PROFILE= {TRUE |FALSE}

如果此选项设置为 TRUE ，那么会将概要文件中传递到 JVM 服务器和应用程序的选项，系统属性和环境变量输出到 SYSPRINT。

PURGE_ESCALATION_TIMEOUT= {15|时间}

指定当 JVM 服务器迂到 TCB 故障或失控任务时， CICS 执行的禁用操作之间的时间间隔 (以秒计)。 每次超时后， CICS 都会升级到下一个禁用操作 (例如，从分阶段停止到清除) ，直到重新启动 JVM 服务器为止。

CICS 按顺序执行以下步骤:

1. CICS 使用 PHASEOUT 选项禁用 JVMSERVER 资源，以允许 JVM 中的现有工作在可能的情况下完成，并阻止新工作使用 JVM。
2. 如果 PHASEOUT 操作未能在 PURGE_ESCALATION_TIMEOUT JVM 服务器选项指定的时间间隔内禁用 JVMSERVER ，那么 CICS 将升级到下一个禁用操作 PURGE ，直到禁用 JVMSERVER 为止。

   对于 Liberty JVM 服务器，从分阶段停止到清除至少有 60 秒超时。

3. 如果 PURGE 操作未能在时间间隔内禁用 JVMSERVER ，那么 CICS 将上报到下一个禁用操作 FORCEPURGE。
4. 如果 FORCEPURGE 操作未能在时间间隔内禁用 JVMSERVER ，那么 CICS 将升级到 KILL。
5. 成功禁用 JVMSERVER 后，将发出消息 DFHSJ1008 。
6. CICS 尝试重新启用资源以创建新的 JVM。

SCRIPT_TIMEOUT_SECS= {300|number}

指定允许 PERFORM JVMSERVER (jvmserver-name) JVM GATHER DIAGNOSTICS 命令在被认为已发生故障 (在此之后将放弃执行) 之前运行的秒数。 请参阅 使用 PERFORM JVMSERVER SPI 收集 JVM 诊断。缺省值为 300 秒。

SECURITY_TOKEN_SERVICE= {TRUE |FALSE}

6.16.2

如果此选项设置为 TRUE ，那么 JVM 服务器可以使用安全性令牌。 如果此选项设置为 FALSE ，那么将对 JVM 服务器禁用安全性令牌服务支持。

注: 选项 SECURITY_TOKEN_SERVICE=TRUE 和 JAVA_PIPELINE=TRUE 不兼容。

6.3 使用 CICS 安全令牌服务的 SAML 支持已从 CICS TS 6.3 中删除。

STDERR={{&APPLID;.&JVMSERVER;.}Dyyyymmdd.Thhmmss.dfhjvmerr|文件名|作业日志|// DD:数据定义}

指定 stderr 流重定向到的 z/OS UNIX 文件或 JES DD 的名称。 如果没有为此选项设置值，那么 CICS 会自动为每个 JVM 服务器创建唯一的跟踪文件。

如果 STDERR 保留为缺省值或是相对文件名，那么输出位置取决于 LOG_PATH_COMPATIBILITY 选项。 如果 LOG_PATH_COMPATIBILITY=FALSE，那么文件将放在 WORK_DIR/applid/jvmserver 目录中。 如果 LOG_PATH_COMPATIBILITY=TRUE，那么文件将放在 WORK_DIR 目录中。

如果为 STDERR指定了绝对文件名，那么 CICS 将在路径中创建不存在的任何目录。

如果该文件存在，那么输出将追加到该文件的末尾。 要为每个 JVM 服务器创建唯一的输出文件，请在文件名中使用 JVMSERVER 和 APPLID 符号，如样本 JVM 概要文件中所示。 如果将 STDERR 保留为缺省值，那么 CICS 将使用 APPLID 和 JVMSERVER 符号以及 JVM 服务器开始创建唯一输出文件的日期和时间戳记。

要路由到 JES DD ，请使用语法 // DD:data_definition从 JES 指定数据定义名称。

如果此选项设置为 JOBLOG，那么 STDERR 将路由到 SYSOUT (如果已定义) 或动态 SYSnnn (如果未定义)。

6.3 已不再支持 USEROUTPUTCLASS 函数。

如果在 JVM 概要文件上指定 USEROUTPUTCLASS 选项，那么该选项上指定的 Java 类将改为处理 System.err 请求。 如果 USEROUTPUTCLASS 选项命名的类无法将数据写入预定目标，则仍可使用 STDERR 选项命名的 z/OS UNIX 文件；例如，当使用提供的示例类 com.ibm.cics.samples.SJMergedStream 时。 如果出于任何其他原因由 USEROUTPUTCLASS 选项指定的类将输出定向到该文件，那么也可以使用该文件。

STDIN=文件名

指定读取 stdin 流的 z/OS UNIX 文件名。 除非为此选项指定值，否则 CICS 不会创建此文件。

标准输出={{&APPLID;.&JVMSERVER;.}Dyyyymmdd.Thhmmss.dfhjvmout|文件名|作业日志|// DD:数据定义}

指定 stdout 流重定向到的 z/OS UNIX 文件或 JES DD 的名称。 如果没有为此选项设置值，那么 CICS 会自动为每个 JVM 服务器创建唯一的跟踪文件。

如果 STDOUT 保留为缺省值或为相对文件名，那么输出位置取决于 LOG_PATH_COMPATIBILITY 选项。 如果 LOG_PATH_COMPATIBILITY=FALSE，那么文件将放在 WORK_DIR/applid/jvmserver 目录中。 如果 LOG_PATH_COMPATIBILITY=TRUE，那么文件将放在 WORK_DIR 目录中。

如果为 STDOUT指定了绝对文件名，那么 CICS 将在路径中创建不存在的任何目录。

如果该文件存在，那么输出将追加到该文件的末尾。 要为每个 JVM 服务器创建唯一的输出文件，请在文件名中使用 JVMSERVER 和 APPLID 符号，如样本 JVM 概要文件中所示。 如果将 STDOUT 保留为缺省值，那么 CICS 将使用 APPLID 和 JVMSERVER 符号以及 JVM 服务器启动以创建唯一输出文件的日期和时间戳记。

要路由到 JES DD ，请使用语法 // DD:data_definition从 JES 指定数据定义名称。

如果此选项设置为 JOBLOG，那么 STDOUT 将路由到 SYSPRINT (如果已定义) 或动态 SYSnnn (如果未定义)。

6.3 已不再支持 USEROUTPUTCLASS 函数。

如果在 JVM 概要文件上指定 USEROUTPUTCLASS 选项，那么该选项上指定的 Java 类将改为处理 System.out 请求。 如果 USEROUTPUTCLASS 选项命名的类无法将数据写入预定目标，则仍可使用 STDOUT 选项命名的 z/OS UNIX 文件；例如，当你使用提供的示例类 com.ibm.cics.samples.SJMergedStream 时。 如果出于任何其他原因由 USEROUTPUTCLASS 选项指定的类将输出定向到该文件，那么也可以使用该文件。

TERMINATION_TIMEOUT= {300|number}

指定当 JVM 服务器在超时之前处于禁用状态时， CICS 等待 LE 相关可调度单元组关闭的秒数。 缺省值为 300 秒。 如果 LE 封套关闭所需的时间超过指定的秒数，那么 CICS 将发出 DFHSJ0212 并继续终止 JVM。

6.3 已不再支持 USEROUTPUTCLASS 函数。

USEROUTPUTCLASS=类名

指定 Java 类的标准名称，该 Java 类拦截来自 JVM 的输出和来自 JVM 内部的消息。 您可以使用此 Java 类来重定向来自 JVM 的输出和消息，并且可以将时间戳记和头添加到输出记录。 Liberty 不支持此操作。 如果 Java 类无法将数据写入其预期目标，那么仍可能使用 STDOUT 和 STDERR 选项中指定的文件。

指定 USEROUTPUTCLASS 选项会对 JVM 的性能产生负面影响。 为了在生产环境中获得最佳性能，请勿使用此选项。 但是，此选项对于使用同一 CICS 区域的应用程序开发者很有用，因为 JVM 输出可以定向到可标识的目标。

有关此类和提供的样本的更多信息，请参阅 控制 JVM 输出，日志，转储和跟踪的位置。

WLP_INSTALL_DIR= {&USSHOME;/wlp|directory_path}

指定 Liberty 安装目录。 Liberty 的默认位置是 CICS 的 z/OS UNIX home 目录，子目录名为 wlp。 默认安装目录为 /usr/lpp/cicsts/cicstsnn/wlp ，其中 nn 反映 CICS TS 的版本：例如 CICS TS 6. 3 中的 /usr/lpp/cicsts/cicsts63/wlp 。

要设置正确的文件路径，您可以:

• 使用 &USSHOME; 符号设置默认文件路径，并追加 wlp 目录。
• 指定备用 Liberty 版本的安装目录。 这种配置有时被称为 "自带自由 "或 BYOL。 在这种情况下，CICS会验证 "自由 "请求的级别：
  • 强制实施最低版本的 Liberty。 如果尝试启动低于 CICS 支持的最低级别的 Liberty 版本，那么将抛出异常，并且 Liberty JVM 服务器不会启动。 异常消息-写入 JVMLOG 和 STDERR-指示要启动的 Liberty 版本以及接受的最低版本:Liberty version XX.X.X.X not supported. Minimum version is YY.Y.Y.Y.
  • 如果要启动的 Liberty 版本高于 CICS支持的最大 Liberty 版本，那么发出警告。 此警告将写入 JVMLOG ， Liberty 将继续启动。 如果 CICS 尚未为此级别的 Liberty 提供支持，或者如果您尚未应用配套的 CICS 服务 APAR ，那么可能会发生此情况。 如果迂到此警告，那么谨慎的做法是限制使用此类版本来测试，原型或开发系统。
  将定期重新评估受支持的最低版本和最高版本，并由季度 CICS Liberty 修订包 APAR (如果适用) 进行更改。

除了 &USSHOME; 环境变量外，您还可以提供其他环境变量和系统属性来配置 Liberty JVM 服务器。 环境变量以 WLP 为前缀，系统属性在 JVM 系统属性中描述。

WLP_LINK_TIMEOUT= {30000|number}

指定 CICS 在超时之前等待分派请求以调用 Liberty JVM 服务器中的应用程序的毫秒数。 如果指定 0 ，那么 CICS 将无限期等待。 缺省值为 30000 毫秒。 如果在指定的毫秒数之后未将任务分派到 Liberty JVM 服务器，那么 EXEC CICS LINK 命令将失败，并且 CICS 将发出 DFHSJ1006 消息。

WLP_OUTPUT_DIR = $WLP_USER_DIR/服务器

指定包含 Liberty 概要文件的输出文件的目录。 缺省情况下， Liberty 概要文件将服务器的日志，工作区，配置文件和应用程序存储在以服务器命名的目录中。

此环境变量是可选的。 如果未指定该值，那么 CICS 缺省为 $WORK_DIR/&APPLID;/&JVMSERVER;/wlp/usr/servers，将符号替换为运行时值。

如果设置了此环境变量，那么输出日志和工作区将存储在 $WLP_OUTPUT_DIR/server_name中。

WLP_USER_DIR={&APPLID;/&JVMSERVER;/wlp/usr/|目录路径}

指定包含 Liberty JVM 服务器的配置文件的目录。 此环境变量是可选的。 如果未指定该值，那么 CICS 将在工作目录中使用 &APPLID;/&JVMSERVER;/wlp/usr/ ，并将符号替换为运行时值。 配置文件将写入 servers/server_name。

WORK_DIR= {。|/tmp|directory_name}

指定 z/OS UNIX 上的工作目录，供 CICS 区域用于与 JVMSERVER 有关的活动。 CICS JVMSERVER 使用此目录作为配置和输出的路径。 在提供的 JVM 概要文件中定义了句点 (.) ，指示 CICS 区域用户标识的主目录将用作工作目录。 可以在 CICS 安装期间创建此目录。 如果该目录不存在或省略了 WORK_DIR ，则 /tmp 将用作 z/OS UNIX 目录名。

可以指定工作目录的绝对路径或相对路径。 相对工作目录相对于 CICS 区域用户标识的主目录。 如果您不想将主目录用作与 Java 相关的活动的工作目录，或者如果 CICS 区域共享 z/OS 用户标识 (UID) ，因此具有相同的主目录，那么可以为每个 CICS 区域创建不同的工作目录。

如果指定的目录名使用了 &APPLID; 符号（ CICS 代替实际的 CICS 区域 APPLID），即使所有 CICS 区域共享一组 JVM 配置文件，每个区域也可以有一个唯一的工作目录。 例如，如果您指定：

WORK_DIR=/u/&APPLID;/javaoutput

使用该 JVM 概要文件的每个 CICS 区域都有自己的工作目录。 确保在 z/OS UNIX 上创建了相关目录，并为 CICS 区域提供了读取、写入和运行这些目录的权限。

您还可以指定工作目录的固定名称。 您必须确保该目录是在 z/OS UNIX 上创建的，且访问权限已授予正确的 CICS 区域。 如果对工作目录使用固定名称，那么将在该目录中创建来自共享 JVM 概要文件的 CICS 区域中所有 JVM 服务器的输出文件。 如果为输出文件使用固定的文件名，那么这些 CICS 区域中所有 JVM 服务器的输出都会附加到相同的 z/OS UNIX 文件中。 为了避免附加到相同的文件，请使用 JVMSERVER 符号和 APPLID 符号为每个 JVM 服务器生成唯一的输出和转储文件。

不要在 z/OS UNIX 上的 CICS 安装目录中定义工作目录，该目录是 USSHOME 系统初始化参数定义的 CICS 文件的主目录。

WSDL_VALIDATOR= {TRUE| FALSE}

针对 SOAP 请求和响应的定义和模式启用验证。 对于 Liberty 和类路径类型 JVM 服务器，将忽略此选项。 有关更多信息，请参阅 验证 SOAP 消息。 可以通过设置 WSDL_VALIDATOR = FALSE 来关闭此选项。 选择性停用可防止与较新的 JAR 文件发生潜在冲突，浪费存储空间以及启动较慢。

ZCEE_INSTALL_DIR= {directory_name}

提供z/OS连接功能的安装位置。 对于 z/OS连接 V2.0，默认值为 /usr/lpp/IBM/zosconnect/v2r0/runtime。 对于 z/OS连接 V3.0，默认值为 /usr/lpp/IBM/zosconnect/v3r0/runtime。