编码 JVM 概要文件的规则

您可以使用任何标准文本编辑器来编辑 JVM 概要文件。 对 JVM 概要文件进行编码时,请遵循以下规则。

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

为 JVM 概要文件中的目录指定值时,请勿使用引号。

CEDA

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

区分大小写

所有参数关键字和操作数都区分大小写,并且必须完全按照 CICS 环境中 JVM 的选项JVM 系统属性中所示进行指定。

类路径分隔符

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

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

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

备注

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

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

概要文件解析代码将除去基于类似 UNIX 的 shell 处理的内联注释,因此改进了样本 JVM 概要文件的文档过程。 内联注释定义如下:
  • 注释以 # 符号开头
  • 它前面有一个或多个空格 (或制表符)
  • 未包含在带引号的文本中
表 1. 内联注释示例
代码 结果
MYVAR=myValue # Comment MYVAR=myValue
MYVAR=#myValue # Comment MYVAR= #myValue
MYVAR=myValue "# Quoted comment" # Comment MYVAR=myValue "# 引用注释"
字符转义序列
您可以对 表 2 中显示的转义序列进行编码
表 2。 转义序列
转义序列 字符值
\b 退格空间
\t 水平选项卡
\n 换行符
\r 回车符
\" 双引号
\' 单引号
\\ 反斜杠
\xxx 对应于八进制值 xxx的字符,其中 xxx 介于值 000-377 之间
\uxxxx 编码为 xxxx的 Unicode 字符,其中 xxxx 是 1-4 十六进制数字。 (请参阅注释以获取更多信息。)
注: Unicode \u 转义与其他转义类型不同。 在 表 2中描述的其他转义序列之前处理 Unicode 转义序列。 Unicode 转义是表示在非 Unicode 系统上可能无法显示的字符的替代方法。 但是,字符转义可以通过阻止对这些字符的通常解释的方式来表示特殊字符。
多个选项实例

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

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