IBM Books

管理与程序设计指南,OS/400 版

配置变量语句

Net.Data 配置变量语句设置配置变量的值。配置变量用于各种不同的目的。有些变量 是语言环境所必需的,以便使它们能够正确地工作,或者以可以替代的方式操作。其它变量控制要 构造的 Web 页面的字符编码或内容。另外,您可以使用配置变量语句来定义特定于应用程序的变量。

您所使用的配置变量取决于您所使用的语言环境,以及其它特定于应用程序的因素。

要更新配置变量语句:

使用您的应用程序所需的配置变量来定制初始化文件。配置变量具有以下语法:

NAME[=]value-string

等号是可选的,由方括号指示。


以下细目描述了您可以在初始化文件中指定的配置变量语句:

DTW_MACRO_CACHE_SIZE:宏高速缓存尺寸变量

以兆字节 (MB) 为单位指出 Net.Data 在高速缓存宏时应使用的内存大小。在超过高速缓存的大小时, Net.Data 将除去旧的被高速缓存的宏,以便为其它宏腾出地方。Net.Data 除去的是最近最少使用的宏。

语法:

DTW_MACRO_CACHE_SIZE [=] size

其中:

size
以兆字节 (MB) 的数量指定高速缓冲存储器的大小。缺省值是 5 MB,通常是启用高速缓存的。 如果 size 是 0,则不对任何宏进行高速缓存。如果 size 是 1 - 4,将使用缺省值 5。

例子:指定高速缓存的大小为 16 MB。

DTW_MACRO_CACHE_SIZE 16

DTW_PAD_PGM_PARMS:参数填充配置变量

向语言环境指出要传递给程序或存储过程的字符参数是否要用空格填充。字符参数 具有数据类型 CHARACTER 或 CHAR。

对于 IN 或 INOUT 参数,如果参数值的长度小于指定的精度,则将在参数值的右侧插入空格, 直至参数值的长度与精度相同。

对于 OUT 参数,参数值被设置为具有精确的空格。

在对程序或存储过程的调用之后,将从 OUT 和 INOUT 参数值中除去所有尾随的空格。

在 Net.Data 初始化文件中设置此变量,以便为所有的宏指定一个值。可以通过宏中的定义覆盖值。如果宏中没有定义 DTW_PAD_PGM_PARMS,它将使用初始化文件中的值。

“直接调用”和 SQL 语言环境支持 DTW_PAD_PGM_PARMS。

语法:

DTW_PAD_PGM_PARMS [=] YES|NO

其中:

YES
指定所有的 IN 和 INOUT 字符参数值都将留待调整,并在将参数传递到程序或存储过程之前 根据定义的参数精度填充空格。 在对程序或存储过程的调用之后,将除去尾随空格。

NO
指定在将参数传递到程序或存储过程时不对字符参数值(以 NULL 结束的值)添加补空。 在调用程序或存储过程之后不除去尾随空格。这是缺省值。

DTW_SHOWSQL:启用或禁用 SHOWSQL 配置变量

覆盖 Net.Data. 宏中 SHOWSQL 设置的效果。

语法:

DTW_SHOWSQL YES|NO

其中:

YES
在所有将 SHOWSQL 的值设置为 YES 的宏中启用 SHOWSQL。

NO
在宏中禁用 SHOWSQL,即使变量 SHOWSQL 被设置为 YES。NO 是缺省值。

表 1描述 Net.Data 初始化文件和宏中的设置如何确定对于特定的宏 是否要启用或禁用 SHOWSQL 变量。

表 1. Net.Data 初始化文件和宏中对 SHOWSQL 的设置之间的关系
DTW_SHOWSQL 的设置 设置 SHOWSQL 显示 SQL 语句
NO NO NO
NO YES NO
YES NO NO
YES YES YES

DTW_SMTP_CCSID:电子邮件 SMTP CCSID 变量

指定 ASCII 编码字符集标识符 (CCSID),它与 DTW_SMTP_CHARSET 中指定的 多用途网际邮件扩展 (MIME) 字符串相关联。在把 DTW_SENDMAIL 函数上指定的数据从 EBCDIC 转换为 ASCII 时, 将使用 CCSID。

如果指定了 DTW_SMTP_CCSID,也必须指定 DTW_SMTP_CHARSET。指定 CCSID 时,请确保它 对于 DTW_SMTP_CHARSET 中指定的 MIME 字符集是适当的,并且系统支持该 CCSID。表 2列出了公用 MIME 字符集以及相关联的 ASCII CCSID。 如果没有 设置 DTW_SMTP_CCSID,Net.Data 将使用与 MIME 字符集 ISO-8859-1 相关联的 CCSID 819。

语法:

DTW_SMTP_CCSID [=] ascii_ccsid

其中 ascii_ccsid 是在从 EBCDIC 转换 为 ASCII 时要使用的 ASCII CCSID (一个范围在 1-65534 内的数字)。

例子:

DTW_SMTP_CCSID 912

这个 ASCII CCSID 对应于 MIME 字符集 ISO-8859-2

DTW_SMTP_CHARSET:电子邮件 SMTP 字符集变量

指定多用途网际邮件扩展 (MIME) 字符集将由 DTW_SENDMAIL 函数在电子邮件消息 中使用。如果指定了 DTW_SMTP_CHARSET,则必须指定 DTW_SMTP_CCSID。在指定 MIME 字符集的情况下, 请确保该字符集有效,因为 Net.Data 不会对为此变量指定的值进行确认。 如果没有设置 DTW_SMTP_CHARSET,Net.Data 将 使用 MIME 字符集 ISO-8859-1,相关联的 CCSID 是 819。

表 2列出了公用 MIME 字符集以及相关联的 ASCII CCSID。


表 2. Net.Data 支持的字符集
MIME 标准字符集 ASCII CCSID 说明
US-ASCII 367 美国英语
ISO-2022-JP 5052 日本 MBCS
ISO-8859-1 819 拉丁-1
ISO-8859-2 912 拉丁-2
ISO-8859-5 915 西里尔语
ISO-8859-6 1089 阿拉伯语
ISO-8859-7 813 希腊语
ISO-8859-8 916 希伯来语
ISO-8859-9 920 拉丁-5

语法:

DTW_SMTP_CHARSET character_set

其中,character_set 是要使用的 MIME 字符集。

例子:

DTW_SMTP_CHARSET iso-8859-2

这个 MIME 字符集对应 912 ASCII CCSID。

DTW_SMTP_SERVER:电子邮件 SMTP 服务器变量

指定使用 DTW_SENDMAIL 内部函数用于发送电子邮件消息的 SMTP 服务器。这个变量的值可以是一个主机名,或是一个 IP 地址。 如果没有设置这个变量,则 Net.Data 把本地主机用作 SMTP 服务器。

语法:

DTW_SMTP_SERVER server_name

其中 server_name 是要用于发送电子邮件消息的 SMTP 服务器的主机名或 IP 地址。

性能技巧:对此值指定一个 IP 地址以防止 Net.Data 在 检索指定的 SMTP 服务器的 IP 地址时连接到一个域名服务器。

例子:

DTW_SMTP_SERVER 9.5.34.5

DTW_SQL_ISOLATION:DB2 隔离变量

DTW_SQL 语言环境使用 DTW_SQL_ISOLATION 配置语句来确定 DTW_SQL 语言环境所执行的 数据库操作和正在并发执行的进程之间的隔离程度是多少。

语法:

DTW_SQL_ISOLATION locking_method

其中 locking_method 是以下的一个值:

DTW_SQL_NO_COMMIT
指定不使用确认控制。对于 OS/400 操作系统,如果关系数据库是在关系数据库目录中指定的 并且该关系数据库在一个非 OS/400 系统上的,那么不要指定这个值。

DTW_SQL_READ_UNCOMMITTED
对于 SQL ALTER、COMMENT ON、CREATE、DROP、GRANT、LABEL ON 和 REVOKE 语句中引用的对象指定锁定, 并且对于已更新、删除和插入的行指定锁定。这些对象一直锁定到工作单元(事务)结束为止。 可以看到其它进程中未提交的更改。

DTW_SQL_READ_COMMITTED
对于 SQL ALTER、COMMENT ON、CREATE、DROP、GRANT、LABEL ON 和 REVOKE 语句中引用的对象指定锁定, 并且对于已更新、删除和插入的行指定锁定。这些对象一直锁定到工作单元(事务)结束为止。 选定但未更新的行是锁定的,直到选择下一行为止。其它进程中未提交的更改是无法看到的。

DTW_SQL_REPEATABLE_READ
对于 SQL ALTER、COMMENT ON、CREATE、DROP、GRANT、LABEL ON 和 REVOKE 语句中引用的对象指定锁定, 并且对于已选定、更新、删除和插入的行指定锁定。这些对象一直锁定到工作单元(事务)结束为止。 其它进程中未提交的更改是无法看到的。

DTW_SQL_SERIALIZABLE
对于 SQL ALTER、COMMENT ON、CREATE、DROP、GRANT、LABEL ON 和 REVOKE 语句中引用的对象指定锁定, 并且对于已选定、更新、删除和插入的行指定锁定。这些对象一直锁定到工作单元(事务)结束为止。 其它进程中未提交的更改是无法看到的。所有在 SELECT、UPDATE、DELETE 和 INSERT 语句中引用的表格是锁定的, 直到工作单元(事务)结束为止。

DTW_SQL_NAMING_MODE:SQL 表格命名变量

DTW_SQL_NAMING_MODE 配置语句指定了如何在 SQL 语句中指定一个表格的名称。

语法:

DTW_SQL_NAMING_MODE mode

其中 mode 是 以下的一个值:

SQL_NAMING
指定集合名称以如下形式限定表格:
collection.table

其中 collection 是集合的名称, table 是表格的名称。缺省的限定符是运行那个执行 SQL 语句的进程的用户 ID, 在没有明确限定表格名称且没有指定缺省集合名称的情况下使用这个限定符。SQL_NAMING 是缺省的表格名。

SYSTEM_NAMING
指定库名以如下形式限定文件:
library/file

其中 library 是库名,file 是表格名称。 如果表格名(文件)没有明确受限定并且没有指定缺省的集合名称名称(库),则缺省的搜索路径是用于 非限定表格名称的库列表 (*LIBL)。

DTWR_CLOSE_REGISTRIES:打开 Web 注册表变量

指定是关闭 Web 注册表还是保持打开状态。这个变量允许您保持 Web 注册表打开的状态, 这样,访问相同注册表的后继 Net.Data 宏调用就不必重新打开注册表了。

语法:

DTWR_CLOSE_REGISTRIES YES|NO

其中:

YES
指定在处理完一个 Net.Data 宏之后关闭所有打开的 Web 注册表。

NO
指定在处理完一个 Net.Data 宏之后使所有打开的 Web 注册表保持打开状态。NO 是缺省值。

性能技巧:您可以使用 DTWR_CLOSE_REGISTRIES 配置语句来改进 访问 Web 注册表(使用 Web 注册表内部)时的性能,这可以通过最少化打开和关闭注册表的次数来实现。 如果多个进程可同时访问注册表(如同有同时的浏览器请求的情况一样),可将 DTWR_CLOSE_REGISTRIES 设置为 YES。


[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 ]