IBM Books

Net.Data 参考


Net.Data 杂项变量

这些是 Net.Data 定义的变量,可用于影响 Net.Data 处理,查找函数调用的状态,并 获取有关数据库查询结果集合的信息,并确定文件位置和日期的信息。在您编写的函数中这些变量非常有用, 您还可以用这些变量测试 Net.Data 宏。

DTW_CURRENT_FILENAME


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).

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).

DTW_DEFAULT_MESSAGE


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 的返回码,则用户见到缺省的错误信息。

DTW_LOG_LEVEL


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"

表 22. DTW_LOG_LEVEL 值
说明
OFF Net.Data 不记录错误。OFF 是缺省。
ERROR Net.Data 记录错误信息。
WARNING Net.Data 记录警告和错误信息。

%DEFINE DTW_LOG_LEVEL="ERROR"

DTW_MACRO_FILENAME


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).

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).

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 可执行文件的路径和名称。根据您的系统,输出看上去如下面例示出的路径和名称:

/usr/lpp/internet/server_root/cgi-bin/db2www

此变量是一个预定义的变量,它的值不能修改。将此变量用作为变量引用。

The Net.Data executable file is $(DTW_MP_PATH).

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 的版本和发行号。输出为如下的格式:

Net.Data 版本 2.1

此变量是一个预定义的变量,它的值不能修改。将此变量用作为变量引用。

This Web application uses $(DTW_MP_VERSION).

DTW_PRINT_HEADER


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"

表 23. DTW_PRINT_HEADER 值
说明
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
%}

DTW_REMOVE_WS


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 用户:

  1. 如果您正在使用 DTW_PRINT_HEADER 生成自己的标题(DTW_PRINT_HEADER="NO"),则必须设置 DTW_REMOVE_WS="NO"

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

DTW_REMOVE_WS="YES"|"NO"

表 24. DTW_REMOVE_WS 值
说明
YES Net.Data 把两个或者更多个空格序列压缩为一个换行 字符,从而生成较短的 HTML 结果页面。
NO Net.Data 不压缩空格。 NO 是缺省。

例 1:压缩空格

DTW_REMOVE_WS="YES"
 

RETURN_CODE


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 的返回码,则显示缺省消息。


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