这些是 Net.Data 定义的变量，可用于影响 Net.Data 处理，查找函数调用的状态，并 获取有关数据库查询结果集的信息，并确定文件位置和日期的信息。在您编写的函数中这些变量非常有用， 您还可以用这些变量测试 Net.Data 宏。
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
当前输入文件的名称和扩展名。输入文件或是一个 Net.Data 宏，或是 INCLUDE 语句中指定的一 个文件。
此变量是一个预定义的变量，它的值不能修改。将此变量用作为变量引用。
例
<P>This file is <I>$(DTW_CURRENT_FILENAME)</I>, and was updated on $(DTW_CURRENT_LAST_MODIFIED).
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
上次修改当前文件时的日期和时间。当前文件可以是一个 Net.Data 宏或在 INCLUDE 语句 中指定的一个文件。其输出格式是由 Net.Data 运行的系统所确定的。
此变量是一个预定义的变量，它的值不能修改。将此变量用作为变量引用。
例
<P>This file is <I>$(DTW_CURRENT_FILENAME)</I>, and was updated on $(DTW_CURRENT_LAST_MODIFIED).
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X |
| X | X | X | X |
目的
当调用内部函数或语言环境发生错误时，从调用返回的消息文本。
可以在 Net.Data 宏的任何部分使用 DTW_DEFAULT_MESSAGE 变量。
此变量是一个预定义变量，不建议修改它的值。把此变量用作一个变量引用。
例
例 1：一条表示函数是否完成成功的消息
@function1()
%IF ("$(RETURN_CODE)" == "0")
The function completed successfully.
%ELSE
The function failed with the return code $(RETURN_CODE). The error message
returned is "$(DTW_DEFAULT_MESSAGE)".
%ENDIF
例 2：针对函数返回非零返回码时的缺省文本
%MESSAGE{
default: {<h2>Net.Data received return code: $(RETURN_CODE).
Error message is $(DTW_DEFAULT_MESSAGE)</h2> %} : continue
%}
如果函数返回了不是 0 的返回码，则用户见到缺省的错误信息。
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X |
|
| X | X | X |
目的
Net.Data 写入记录文件的消息等级。
可以使用 DEFINE 语句或 @DTW_ASSIGN() 函数指定此变量的值。
要求： 在 Net.Data 初始化文件中定义 DTW_LOG_DIR 以初始化记录；否 则，当您在宏中指定 DTW_LOG_LEVEL 变量时 Net.Data 不记录消息。
值
DTW_LOG_LEVEL="OFF|ERROR|WARNING"
| 值 | 说明 |
|---|---|
| OFF | Net.Data 不记录错误。OFF 是缺省。 |
| ERROR | Net.Data 记录错误信息。 |
| WARNING | Net.Data 记录警告和错误信息。 |
例
%DEFINE DTW_LOG_LEVEL="ERROR"
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
当前 Net.Data 宏文件的名称和扩展名。
此变量是一个预定义的变量，它的值不能修改。将此变量用作为变量引用。
例
<P>This Net.Data macro is <I>$(DTW_MACRO_FILENAME)</I>, and was updated on $(DTW_MACRO_LAST_MODIFIED).
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
上次修改 Net.Data 宏时的日期和时间。其输出格式是由 Net.Data 运行的系统所确定的。
此变量是一个预定义的变量，它的值不能修改。将此变量用作为变量引用。
例
<P>This Net.Data macro is <I>$(DTW_MACRO_FILENAME)</I>, and was updated on $(DTW_MACRO_LAST_MODIFIED).
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X |
| X | X | X |
目的
提供多字节字符集 (MBCS)，支持由“缺省”语言环境使用的字符串和字处理函数。可以在 Net.Data 初始化文件中设置这个变量，但是您可以在宏中使用它来设置或覆盖当前设置。
使用 DEFINE 语句或 @DTW_ASSIGN() 函数指定这个变量的值。
可以在 Net.Data 初始化文件中设置这个变量，但是您可以在宏中使用它来设置或覆盖当前设置。
OS/400 用户： Net.Data for OS/400 自动允许 MBCS 支持功能 ，它不需要这个变量。Net.Data for OS/400 忽略被移植到 OS/400 操作系统上的宏中的这个变量。
此配置变量与 DTW_UNICODE 配置变量一起使用。如果 DTW_UNICODE 使用
缺省值 NO，则将使用 DTW_MBMODE 的值。如果对 DTW_UNICODE 所设置的值不是 NO，则使用它自己的值。
表 23说明了这两个变量的设置如何确定内部函数处理字符串的方式：
表 23. DTW_UNICODE 和 DTW_MBMODE 设置之间的关系
| 如果 DTW_UNICODE 设置为 ... | 如果 DTW_MBMODE=YES | 如果 DTW_MBMODE=NO |
|---|---|---|
| NO | 支持 DBCS 与 SBCS 混合的情况 | 仅支持 SBCS |
| UTF8 | 支持 UTF-8 | 支持 UTF-8 |
值
DTW_MBMODE="YES"|"NO"
| 值 | 说明 |
|---|---|
| YES | 指定 MBCS 支持字符串和字处理函数。 |
| NO | 指定字符串和字处理函数没有 MBCS 支持。NO 是缺省。 |
例
例 1：覆盖 INI 文件中的值
INI 文件：
DTW_MBMODE NO
宏：
%DEFINE DTW_MBMODE = "YES"
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
Net.Data 可执行文件的路径和名称。根据您的系统，输出看上去如下面例示出的路径和名称：
/usr/lpp/internet/server_root/cgi-bin/db2www
此变量是一个预定义的变量，它的值不能修改。将此变量用作为变量引用。
例
The Net.Data executable file is $(DTW_MP_PATH).
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
运行在服务器上的 Net.Data 的版本和发行号。
此变量是一个预定义的变量，它的值不能修改。将此变量用作为变量引用。
例
This Web application uses $(DTW_MP_VERSION).
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
指定用于 HTTP 首部的文本。
必须在 Net.Data 处理任何发送到 Web 浏览器的任何文本之前先设置此变量，因为 Net.Data 是在 输出文本之前一次读取此变量的，以后将不再读。在 Net.Data 把文本发送到浏览器之后，对 DTW_PRINT_HEADER 变量的任何更改 都将被忽略。
如果使用 DTW_PRINT_HEADER 来生成自己的标题 (DTW_PRINT_HEADER="NO")， 则必须将 DTW_REMOVE_WS 设置为 "NO"。
使用 DEFINE 语句或 @DTW_ASSIGN() 函数指定这个变量的值。
值
DTW_PRINT_HEADER="YES"|"NO"
| 值 | 说明 |
|---|---|
| YES | Net.Data 针对 HTTP 标题打印出文本 Content-type: text/html。YES 是缺省。 |
| NO | Net.Data 不打印 HTTP 标题。可以生成定制 HTTP 标题信息。 |
例
这个变量最常用于启用 Net.Data 宏，使它发送 cookie。要设置 cookie，则 DTW_PRINT_HEADER 变量必须设置为 NO，并且前三行必须为 Content-type 标题、 Set-Cookie 语句和一个空行。
例 1：允许 Net.Data 发送 cookie
%DEFINE DTW_PRINT_HEADER="NO"
%HTML(cookie1) {
Content-type: text/html
Set-Cookie: UsrId=56, expires=Friday, 12-Dec-99, 12:00:00 GMT; path=/
<P>
Any text
%}
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
通过压缩由制表程序、空格和换行字符引起的多余空格，减少自动生成的 Web 页面的大小。
在 DEFINE 块中指定这个变量的值。
使用 <PRE></PRE> 标记：把此变量定义为 YES 将影响 打印出的空格数和空格类型。如果此变量设置成 YES，使用 <PRE></PRE> 标记的 HTML 页面部分可能不会如期望的那样显示。
如果使用 DTW_PRINT_HEADER 来生成自己的标题 (DTW_PRINT_HEADER="NO")， 则必须将 DTW_REMOVE_WS 设置为 "NO"。
OS/390 用户：在 Net.Data 初始化文件中设置这个变量， 以便为所有的宏指定一个值。可以通过宏中的定义覆盖值。如果没有在宏中定义 DTW_REMOVE_WS， 则它使用初始化文件中的值。
值
DTW_REMOVE_WS="YES"|"NO"
| 值 | 说明 |
|---|---|
| YES | Net.Data 把两个或者更多个空格序列压缩为一个换行 字符，从而生成较短的 HTML 结果页面。 |
| NO | Net.Data 不压缩空格。NO 是缺省。 |
例
例 1：压缩空格
DTW_REMOVE_WS="YES"
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
调用内部函数或语言环境所返回的返回码。Net.Data 使用这个值来处理 MESSAGE 块。您可以使用 这个值来确定一个函数调用是成功了还是失败了。值 0 表示已成功地完成一个函数调用。
可以在 Net.Data 宏的任何部分引用 RETURN_CODE 变量。
这个值是预定义的；不建议修改它。把它用作一个变量引用。
例
例 1一条表示函数是否完成成功的消息
@function1()
%IF ("$(RETURN_CODE)" == "0")
The function completed successfully.
%ELSE
The function failed with the return code $(RETURN_CODE).
%ENDIF
例 2：返回码不是 0 时的缺省消息
%MESSAGE{
default: "<h2>Net.Data received return code: $(RETURN_CODE)</h2>" : continue
%}
如果函数返回不是 0 的返回码，则显示缺省消息。