这些是 Net.Data 定义的变量,可用于影响 Net.Data 处理,查找函数调用的状态,并 获取有关数据库查询结果集合的信息,并确定文件位置和日期的信息。在您编写的函数中这些变量非常有用, 您还可以用这些变量测试 Net.Data 宏。
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
|
|
|
| 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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X | X | X | X | X | X |
目的
运行在服务器上的 Net.Data 的版本和发行号。输出为如下的格式:
Net.Data 版本 2.1
此变量是一个预定义的变量,它的值不能修改。将此变量用作为变量引用。
例
This Web application uses $(DTW_MP_VERSION).
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X | X | X | X | X | X |
目的
指定文件标题的文本。
必须在 Net.Data 处理任何发送到 Web 浏览器的任何文本之前先设置此变量,因为 Net.Data 是在 输出文本之前一次读取此变量的,以后将不再读。在 Net.Data 把文本发送到浏览器之后,对 DTW_PRINT_HEADER 变量的任何更改 都将被忽略。
OS/390 用户:如果您正在使用 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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X | X | X | X | X | X |
目的
通过压缩由制表程序、空格和换行字符引起的多余空格,减少自动生成的 Web 页面的大小。
在 DEFINE 块中指定这个变量的值。
使用 <PRE></PRE> 标记:把此变量定义为 YES 将影响 打印出的空格数和空格类型。 如果此变量设置成 YES,使用 <PRE></PRE> 标记的 HTML 页面部分可能不会如期望的那样显示。
OS/390 用户:
值
DTW_REMOVE_WS="YES"|"NO"
值 | 说明 |
---|---|
YES | Net.Data 把两个或者更多个空格序列压缩为一个换行 字符,从而生成较短的 HTML 结果页面。 |
NO | Net.Data 不压缩空格。 NO 是缺省。 |
例
例 1:压缩空格
DTW_REMOVE_WS="YES"
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
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 的返回码,则显示缺省消息。