管理与程序设计指南

配置变量语句

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

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

要更新配置变量语句:

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

NAME[=]value-string

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


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

高速缓存管理器配置变量

如果高速缓存管理器不是在 Net.Data 宏所运行的机器上运行,则将使用两个可选的配置变量:

如果高速缓存管理器在本地机上运行,那么 UNIX 域套接字或已命名管道将用于通信,并且不需要进行配置。

高速缓存管理器只在 AIX 和 Windows NT 机器上运行。 参见Net.Data 高速缓存,以了解 Net.Data 高速缓存。

DTW_CACHE_PORT:高速缓存管理器端口变量
指定高速缓存管理器正在监听的 TCP/IP 端口。此端口号码必须与高速缓存管理器配置文件中指定的端口号码相匹配,这样 Net.Data 就可以与高速缓存管理器通信。如果没有指定, 高速缓存管理器将使用缺省的端口 7175。

语法:

 DTW_CACHE_PORT [=] port_number

参数:

port_number
为高速缓存管理器分配的唯一的端口号码,用于服务高速缓存请求。缺省值为 7175。

表 3描述了为这些变量指定机器 ID 和端口号码的选项。

表 3. 高速缓存管理器配置变量:配置选项
缺省的连接管理器值 如果指定了高速缓存机器 ... 如果没有指定高速缓存机器 ...
如果指定了高速缓存端口... Net.Data 使用指定的端口在指定的机器上连接到高速缓存管理器。 Net.Data 使用指定的端口在本地机上连接到高速缓存管理器。
如果没有指定高速缓存端口 ... Net.Data 使用缺省的端口 7175 在指定的机器上连接到高速缓存管理器。 Net.Data 使用缺省的端口 7175 在本地机上连接到高速缓存管理器。

DTW_CACHE_HOST:高速缓存管理器机器 ID 变量
指定高速缓存管理器所驻留的机器。如果没有指定,Net.Data 将假定它就是本地机。

语法:

DTW_CACHE_HOST [=] host_name

参数:

host_name
运行高速缓存管理器的本地或远程机器的限定 TCP/IP 主机名。缺省值是本地机的主机名。

DB2INSTANCE:DB2 实例变量

指定 SQL 语言环境所使用的 DB2 实例。当 Net.Data 连接到在 Windows NT、OS/2 和 UNIX 操作系统上运行的 DB2 时需要这个变量值。

OS/2、Windows NT 和 UNIX 操作系统上的 DB2 需要将 DB2INSTANCE 定义为一个环境变量。如果 Net.Data 检测到 DB2INSTANCE 没有定义为环境变量,那么它将把 DB2INSTANCE 环境变量设置为试图连接到 DB2 之前在初始化文件中找到的 DB2INSTANCE 的值。

语法:

DB2INSTANCE [=] instance_name

DTW_CM_PORT:Live Connection 端口号码变量

指定 Net.Data 用于 Live Connection 的唯一的端口号码。

语法:

DTW_CM_PORT [=] port_number

其中 port_number 指定了用于 Live Connection 的唯一的端口号码。

DTW_DEFAULT_ERROR_MESSAGE:指定类属错误信息

使用 DTW_DEFAULT_ERROR_MESSAGE 配置变量来为处于生产状态的应用程序指定类属错误信息。此变量为任何 MESSAGE 块中未捕捉的错误状态提供了一个类属信息。

如果您仍希望查看 Net.Data 生成的实际错误信息, 可使用错误信息日志来捕捉这些信息。参见Net.Data 记录,以了解如何使用错误日志。

如果未指定配置变量,则 Net.Data 会对错误状态显示它自己提供的信息。

语法:

DTW_DEFAULT_ERROR_MESSAGE [=] "message"

示例: 指定类属信息

DTW_DEFAULT_ERROR_MESSAGE "This site is temporarily unavailable."

DTW_DIRECT_REQUEST:启用直接请求变量

启用或禁用 Net.Data 直接请求调用。在缺省情况下,直接请求被禁用。

调用 Net.Data 的直接请求方式允许用户指定 SQL 语句的执行,或直接在 URL 中指定 Perl、REXX 或 C 程序。禁用直接请求的时侯,用户必须使用宏请求方式来调用 Net.Data, 允许用户只执行那些 SQL 语句和已经定义的或在宏中调用的函数。参见使用 Net.Data 机制,以获取使用 DTW_DIRECT_REQUEST 时与安全性相关的建议。

语法:

DTW_DIRECT_REQUEST [=] YES|NO

其中:

YES
启用 Net.Data 直接请求。

NO
禁用 Net.Data 直接请求。NO 是缺省值。

DTW_INST_DIR:Net.Data 安装目录变量

在 Net.Data 执行过程中定位某些文件。您可以在安装时设置这个变量来指定主目录 <inst_dir> (Net.Data 安装在这个目录中)。安装之后不要更改这个值。

DTW_LOG_DIR 和 DTW_LOG_LEVEL:错误日志变量

DTW_LOG_DIR 指定存储错误日志的目录。除非同时设置了此变量和 DTW_LOG_LEVEL 变量,否则将不记日志。

参见记录 Net.Data 错误信息,以了解关于这些变量和记录 Net.Data 的错误信息日志的详情。

语法:

DTW_LOG_DIR [=] \inst_dir\path
 

示例:初始化文件配置

DTW_LOG_DIR \inst_dir\mylogfiles\
 

DTW_LOG_LEVEL:错误日志级别变量

DTW_LOG_LEVEL 指定要记录在错误日志中的错误的级别。除非同时设置了此变量和 DTW_LOG_DIR 变量,否则将不记日志。

参见记录 Net.Data 错误信息,以了解关于这些变量和记 Net.Data 的错误信息日志的详情。

语法:

DTW_LOG_LEVEL [=] off|warning|error

示例:初始化文件配置

DTW_LOG_LEVEL error

DTW_MBMODE:本机的语言支持变量

对字处理和字符串函数激活国家语言支持。当这个变量的值为 YES 时,所有的字符串函数和字处理函数都将通过把字符串作为混合数据(即, 作为可能同时包含来自单字节字符集和双字节字符集的字符的字符串)来正确地处理 MBCS 字符。缺省值为 NO。您可以通过在 Net.Data 宏中设置 DTW_MBMODE 变量来覆盖初始化文件中值的设置。

此配置变量与 DTW_UNICODE 配置变量一起使用。如果 DTW_UNICODE 使用缺省值 NO,则将使用 DTW_MBMODE 的值。如果对 DTW_UNICODE 所设置的值不是 NO,则使用它自己的值。 表 4说明了这两个变量的设置如何确定内部函数处理字符串的方式:

表 4. DTW_UNICODE 和 DTW_MBMODE 设置之间的关系
如果 DTW_UNICODE 设置为 如果 DTW_MBMODE=YES 如果 DTW_MBMODE=NO
NO 支持 MBCS 与 SBCS 混合使用 仅支持 SBCS
UTF8 支持 UTF-8 支持 UTF-8

语法:

DTW_MBMODE [=] NO|YES

DTW_REMOVE_WS:用于除去额外空格的变量

如果此变量设置为 YES,则 Net.Data 会除去 HTML 输出中的多余空白。通过压缩空白,这个变量压缩了要发送给 Web 浏览器的数据量, 从而改进了性能。缺省值为 NO。

可以在宏中使用 DEFINE 语句来覆盖这个变量。

提示:如果正在使用 DTW_PRINT_HEADER 来生成自己的标题 (DTW_PRINT_HEADER "NO"),则不要将 DTW_REMOVE_WS 设置为 YES。

语法:

DTW_REMOVE_WS [=] YES|NO

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

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

语法:

DTW_SHOWSQL [=] YES|NO

其中:

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

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

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

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

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 us.ibm.com

DTW_UNICODE:Unicode 变量

指定 Net.Data 在以下事物中是否支持 Unicode:

Net.Data 在宏、表数据以及内部函数中支持 UTF-8 Unicode 格式, 并且输出通常是 UTF-8。Net.Data 可以访问包含 UTF-16 数据的数据库,并将这些数据转换为 UTF-8。

当设置为 UTF8 时,DTW_UNICODE 会告诉 Net.Data 在 Unicode 环境中运行。然后 Net.Data 生成 UTF-8 格式的页面,并期望任何输入数据都是 UTF-8 格式的(或者,如果是 DB2 数据库数据的话,UCS-2 也可以)。输入数据包括宏文件的内容、 从浏览器发送的表单数据,以及所有其他来自外部数据源的数据。

DB2 Unicode 数据库需求:除了设置 DTW_UNICODE 变量之外,还需在 Net.Data 的运行环境中将 DB2 特定环境变量 DB2CODEPAGE 设置为 1208。例如,对于 Apache Web 服务器,向 HTTPD.CONF 文件添加下面这一行:

SetEnv DB2CODEPAGE 1208

参见 Web 服务器文档,以确定如何为 CGI 脚本、Web 服务器 API、Fast-CGI 程序或小服务程序设置环境变量。

当在 Unicode 环境中运行时,Net.Data 使用的是英文信息目录。

DTW_UNICODE 配置变量与 DTW_MBMODE 配置变量一起使用。在处理单词或字符串内部函数时,DTW_UNICODE 配置变量的值将覆盖 DTW_MBMODE 变量的设置。但是,如果 DTW_UNICODE 被设置为 NO 或未设置,则使用 DTW_MBMODE 的值。表 4说明了这两个变量的设置如何确定内部函数处理字符串的方式:

语法:

DTW_UNICODE [=] NO|UTF8

其中:

NO
指定遵从 DTW_MBMODE 变量的值。表 4描述了根据 DTW_MBMODE 的值 对 Net.Data 的支持

UTF8
指定支持 UTF-8 代码页并忽略 DTW_MBMODE 配置变量的值。UTF-8 由可变的字节数来表示字符, 对 ASCII 字符没有影响。

DTW_VARIABLE_SCOPE:变量作用域变量

指定 Net.Data 如何对待局部变量的作用域:局部变量是否仍为局部变量,或者局部变量是否可在创建它们的函数块外部使用。 此变量的作用是提供与 Net.Data 先前版本的向后兼容性,但不可用于 Net.Data 的 OS/390 或 OS/400 版本。

语法:

DTW_VARIABLE_SCOPE = LOCAL|GLOBAL

其中:

LOCAL
指定局部变量仍然为局部变量。这种特性是在 Net.Data 版本 2.0 中出现的,是缺省情况。

GLOBAL
指定局部变量可在创建该变量的函数块之外使用。它的作用是提供与 Net.Data 先前版本的向后兼容性;LOCAL 是建议的设置值。


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