Net.Data 配置变量语句设置配置变量的值。配置变量用于各种不同的目的。有些变量 是语言环境所必需的,以便使它们能够正确地工作,或者以可以替代的方式操作。其它变量控制要 构造的 Web 页面的字符编码或内容。另外,您可以使用配置变量语句来定义特定于应用程序的变量。
您所使用的配置变量取决于您所使用的语言环境,以及其它特定于应用程序的因素。
要更新配置变量语句:
使用您的应用程序所需的配置变量来定制初始化文件。配置变量具有以下语法:
NAME[=]value-string
等号是可选的,由方括号指示。
以下细目描述了您可以在初始化文件中指定的配置变量语句:
以兆字节 (MB) 为单位指出 Net.Data 在高速缓存宏时应使用的内存大小。在超过高速缓存的大小时, Net.Data 将除去旧的被高速缓存的宏,以便为其它宏腾出地方。Net.Data 除去的是最近最少使用的宏。
语法:
DTW_MACRO_CACHE_SIZE [=] size
其中:
例子:指定高速缓存的大小为 16 MB。
DTW_MACRO_CACHE_SIZE 16
向语言环境指出要传递给程序或存储过程的字符参数是否要用空格填充。字符参数 具有数据类型 CHARACTER 或 CHAR。
对于 IN 或 INOUT 参数,如果参数值的长度小于指定的精度,则将在参数值的右侧插入空格, 直至参数值的长度与精度相同。
对于 OUT 参数,参数值被设置为具有精确的空格。
在对程序或存储过程的调用之后,将从 OUT 和 INOUT 参数值中除去所有尾随的空格。
在 Net.Data 初始化文件中设置此变量,以便为所有的宏指定一个值。可以通过宏中的定义覆盖值。如果宏中没有定义 DTW_PAD_PGM_PARMS,它将使用初始化文件中的值。
“直接调用”和 SQL 语言环境支持 DTW_PAD_PGM_PARMS。
语法:
DTW_PAD_PGM_PARMS [=] YES|NO
其中:
覆盖 Net.Data. 宏中 SHOWSQL 设置的效果。
语法:
DTW_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 |
指定 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
指定多用途网际邮件扩展 (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。
| 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_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 语言环境使用 DTW_SQL_ISOLATION 配置语句来确定 DTW_SQL 语言环境所执行的 数据库操作和正在并发执行的进程之间的隔离程度是多少。
语法:
DTW_SQL_ISOLATION locking_method
其中 locking_method 是以下的一个值:
DTW_SQL_NAMING_MODE 配置语句指定了如何在 SQL 语句中指定一个表格的名称。
语法:
DTW_SQL_NAMING_MODE mode
其中 mode 是 以下的一个值:
collection.table
其中 collection 是集合的名称, table 是表格的名称。缺省的限定符是运行那个执行 SQL 语句的进程的用户 ID, 在没有明确限定表格名称且没有指定缺省集合名称的情况下使用这个限定符。SQL_NAMING 是缺省的表格名。
library/file
其中 library 是库名,file 是表格名称。 如果表格名(文件)没有明确受限定并且没有指定缺省的集合名称名称(库),则缺省的搜索路径是用于 非限定表格名称的库列表 (*LIBL)。
指定是关闭 Web 注册表还是保持打开状态。这个变量允许您保持 Web 注册表打开的状态, 这样,访问相同注册表的后继 Net.Data 宏调用就不必重新打开注册表了。
语法:
DTWR_CLOSE_REGISTRIES YES|NO
其中:
性能技巧:您可以使用 DTWR_CLOSE_REGISTRIES 配置语句来改进 访问 Web 注册表(使用 Web 注册表内部)时的性能,这可以通过最少化打开和关闭注册表的次数来实现。 如果多个进程可同时访问注册表(如同有同时的浏览器请求的情况一样),可将 DTWR_CLOSE_REGISTRIES 设置为 YES。