onconfig 文件的格式

当要新增或修改 onconfig 文件的内容时,必须遵循该文档的编译规则。

对参数的描述和其可以赋的值都阐述在 onconfig.std 文件的注释中。

以下显示了参数行的语法：

PARAMETER_NAME parameter_value comments

onconfig文件内容的格式规定如下：

一行只能命名一个参数。
注释行以 # 为标志并位于行的开头。
onconfig 文件的最大行限制为 512 字节，超出此限制的行将被截断，而且可能导致配置问题。
参数名、参数值和可选注释之间必须放置空格（制表符和/或空格）。请不要再参数值内部使用任何制表符或空格。在参数值和空格之后的字符串都将被视为注释，不论这些字符串的开头是否以 # 标记。
onconfig 文件中的参数及其值是区分大小写的，参数名总是大写的，如果值项使用大写字母描述的，那么您必须使用大写（例如： NETTYPE 参数的 CPU 值）。
大多数参数只能有一个有效的项。在 onconfig 文件中，如果一些参数有多项，系统将默认第一项有效。然而，一些参数可以有多个项，例如 DBSERVERALIASES 参数。另一些参数，例如 VPCLASS 可以出现多次。
未识别的参数可以被保存，但是会被忽略并且不会报错。
复制但忽略未识别的参数，且不会报错。

提示：如果您在 onconfig.std 模板文件中运行一个像 grep 的程序，那么指定新行字符（^）只返回配置参数的名称和值。若没有新行字符，参数的描述也将会被返回。

例如：下面的命令不仅返回配置参数的描述，也返回它的值：

grep "MSGPATH" onconfig.std
# MSGPATH      - The path of the IDS message log file
MSGPATH $GBASEDBTDIR/tmp/online.log

然而，下面的命令只返回配置参数的值：

grep "^MSGPATH" onconfig.std
MSGPATH $GBASEDBTDIR/tmp/online.log

环境变量的约定

在环境变量适用的任何配置参数中，您可以输入一个环境变量作为值。例如：对于 DBSERVERNAME 配置参数您可以指定以下的环境变量来代替您数据库服务器的名称。

DBSERVERNAME     $MY_DBSERVERNAME

重要：如果您输入一个环境变量作为值，您必须在任何可执行程序或读取 onconfig 文件的实用程序的环境中设置该环境变量。读取 onconfig 文件的实用程序包括 oninit、oncheck、onbar、ontape、onlog 和 archecker。