对概要文件进行编码的规则

JVM 概要文件是存储在 USS 文件系统上时以 EBCDIC 编码的文本文件。在 CICS 束中创建 JVM 概要文件时，可以使用任何文本编辑器在工作站上编辑这些概要文件。当它们传输到 USS 时，必须将它们转换为 EBCDIC。将 CICS 束项目导出到 USS 时， CICS Explorer 会自动执行此转换。

区分大小写

所有参数关键字和操作数都区分大小写，并且必须完全如 CICS 环境中的 JVM 选项， JVM 系统属性或 Node.js 概要文件和命令行选项中所示指定。

备注

要添加注释或注释掉选项而不是将其删除，请以 # 符号开始注释的每一行。当启动程序读取文件时，将忽略注释行。

也将忽略空白行。可以使用空白行作为选项或选项组之间的分隔符。

概要文件解析代码将除去内联注释。内联注释定义如下:

注释以 # 符号开头
它前面有一个或多个空格 (或制表符)
未包含在带引号的文本中

表 1. 内联注释示例
代码	结果
`MYVAR=myValue # Comment`	MYVAR=myValue
`MYVAR=#myValue # Comment`	MYVAR=#myValue
`MYVAR=myValue "# Quoted comment" # Comment`	MYVAR=myValue "# 引用评论"

连续页面

对于选项，该值由文本文件中的行尾定界。如果您正在输入或编辑的值对于编辑器窗口太长，那么可以断开该行以避免滚动。要继续下一行，请使用反斜杠字符和空白连续字符来终止当前行，如以下示例中所示:

STDERR=/example/a/long/path/which/you/would/like\
 /to/break/over/a/line

请勿将多个选项放在同一行上。

包含文件

使用 %INCLUDE=<file_path> 在概要文件中包含文件。此文件可包含公用的系统范围配置，可独立于概要文件进行维护。这样即可共享对多个概要文件公用的配置，从而提供更多的控制权并让维护概要文件变得更容易。

下列规则适用：

<file_path> 必须是 zFS中的标准文件。
- 避免在 <file_path> 开头使用相对目录，例如 . 和 ..。 UNIX 系统服务将它们解释为相对于 Language Environment 当前工作目录，而当前工作目录可能会在处理过程中发生变化。
- 如果 <file_path> 不存在，或者如果 CICS 区域用户标识对 <file_path> 消息 DFHSJ1308 没有读访问权，那么将发出此消息。
<file_path> 可以包含符号，例如 &USSCONFIG;。
- 不允许使用符号 &DATE; 和 &TIME; ，因为这些符号的格式是通过时区选项 (TZ) 设置的，该时区选项可以在 %INCLUDE 伪指令之前或之后。
<file_path> 的内容将替换 %INCLUDE 伪指令。
概要文件可以包含任意数目的 %INCLUDE 伪指令。
循环引用导致消息Skipping duplicate例如， Profile-A 可以包括 Profile-B 和 Profile-B 包括 Profile-C; 但如果 Profile-B 包括 Profile-A ，那么将忽略伪指令。

多个选项实例

如果概要文件中包含同一选项的多个实例，那么将使用找到的最后一个选项的值，并且将忽略先前的值。

UNIX 系统服务目录路径

指定概要文件中的 zFS 文件或目录的值时，请勿使用引号。

特定于 JVM 概要文件的规则

附加值

在变量前使用 + 字符，以使用逗号分隔符将指定的值附加到该变量的现有值，例如:

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

这相当于:

LIBERTY_INCLUDE_XML=/path/file1,/path/file2

CEDA: 无论终端 UCTRAN 设置如何， CEDA 面板都接受 JVMPROFILE 字段的混合大小写输入。但是，在从命令行使用 CEDA 或使用其他 CICS 事务时，必须输入混合大小写的 JVM 概要文件的名称。确保在禁止大写转换的情况下正确配置了终端。您可以使用提供的 CEOT 事务来变更您自己终端的大写转换状态 (UCTRAN) ，仅适用于当前会话。

类路径分隔符: 使用 : (冒号) 字符来分隔在类路径选项 (例如 CLASSPATH_SUFFIX) 上指定的目录路径。

概要文件的名称

JVM 概要文件的名称长度最多可以为 8 个字符。
文件系统上的 JVM 概要文件必须具有文件扩展名 .jvmprofile。文件扩展名设置为小写，不得更改 (仅适用于 JVM 概要文件)。
该名称可以是对 z/OS UNIX System Services中的文件有效的任何名称。请勿使用以 DFH 开头的名称，因为这些字符保留供 CICS使用。
由于概要文件是 UNIX 文件，因此案例很重要。在 CICS 中指定名称时，必须使用与 z/OS UNIX 文件名相同的大小写字母组合输入。

引用环境变量: 可以使用符号表示法语法在 JVM 概要文件中的其他变量中引用环境变量。有关更多信息，请参阅 JVM 概要文件中使用的符号。

存储器大小

在 JVM 概要文件中指定与存储器相关的选项时，请以 1024 字节的倍数指定存储器大小。使用字母 K 表示 KB ，使用字母 M 表示 MB ，使用字母 G 表示 GB。例如，要将 6 291 456 字节指定为堆的初始大小，请通过下列其中一种方法对 -Xms 进行编码:

-Xms6144K
-Xms6M