JVM 服务器选项

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

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

JVM 服务器选项和描述

_DFH_UMASK= {007|nnn}

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

CICS_WLP_MODE= {INTEGRATED| STANDARD}

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

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

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

CLASSPATH_PREFIX， CLASSPATH_SUFFIX=类路径名

使用这些选项来指定要由未启用 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 选项指定的多个项。

DISPLAY_JAVA_VERSION= {TRUE| FALSE}

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

IDENTITY_PREFIX= {TRUE| FALSE}

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

JAVA_DUMP_TDUMP_PATTERN=

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

JAVA_HOME=/usr/lpp/java/javadir/

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

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

JAVA_PIPELINE= {TRUE |FALSE}

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

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

JNDI_REG政务司= {TRUE| FALSE}

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

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

指定在 JVM 服务器操作期间将 Java 跟踪写入的 z/OS UNIX 文件或 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 位置。

LIBPATH_PREFIX， LIBPATH_SUFFIX=路径名

指定要搜索本机 C 动态链接库 (DLL) 文件的目录路径，这些文件由 JVM 使用，并且在 z/OS UNIX 中具有扩展名 .so 。 这包括运行 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 。

If STDOUT, STDERR, and JVMTRACE use the default scheme, or if customized, include the &DATE;.&TIME; pattern, then only the newest 恩 of each log type is kept on the system. 如果您的定制不包含任何使输出唯一的变量，那么会将文件追加到其中，并且不需要删除。 如果将输出变量定制为将输出路由到 DD: // 或 JOBLOG ，那么清除不适用。 特殊值 0 表示不删除。

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 概要文件中不可见)。

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。

SECURITY_TOKEN_SERVICE= {TRUE |FALSE}

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

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

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

指定 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 (如果未定义)。

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

STDIN=file_name

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

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

指定 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 (如果未定义)。

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

USEROUTPUTCLASS=类名

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

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

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

WLP_INSTALL_DIR= {&USSHOME;/wlp}

指定 Liberty 概要文件技术的安装目录。 Liberty 概要文件安装在 CICS 的 z/OS UNIX 主目录中名为 wlp的子目录中。 缺省安装目录为 /usr/lpp/cicsts/cicsts54/wlp。 Always use the &USSHOME; symbol to set the correct file path and append the wlp directory.

如果要启动 Liberty JVM 服务器，那么此环境变量是必需的。 如果设置此环境变量，那么还可以提供其他环境变量和系统属性来配置 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/servers

指定包含 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。

WLP_ZOS_PLATFORM= {TRUE| FALSE}

如果此选项设置为 FALSE ，那么将禁用 Liberty JVM 服务器中的 z/OS 平台扩展。 在此方式下不允许使用 cicsts:security-1.0 和 cicsts:distributedIdentity-1.0 功能部件。

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 区域创建不同的工作目录。

If you specify a directory name that uses the &APPLID; symbol (whereby CICS substitutes the actual CICS region APPLID), you can have a unique working directory for each region, even if all the CICS regions share the set of JVM profiles. 例如，如果您指定：

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 = {<installation_directory>}

提供 z/OS Connect Enterprise Edition 功能部件安装的位置。 对于 z/OS Connect Enterprise Edition V2.0，缺省值为 /usr/lpp/IBM/zosconnect/v2r0/runtime 。 对于 z/OS Connect Enterprise Edition V3.0，缺省值为 /usr/lpp/IBM/zosconnect/v3r0/runtime 。