Net.Data 从路径配置语句的设置中确定 Net.Data 宏所使用的文件和可执行程序的位置。路径语句有:
这些路径语句标识了一个或多个 Net.Data 在试图找到宏、文本文件LOB 文件 和包含文件时搜索的目录。您所需的路径语句取决于宏所使用的 Net.Data 的功能。
更新准则:
有些一般准则适用于路径语句。每个路径语句的说明中都注明了例外情况。
以下章节将描述每个路径语句的目的和语法,并提供有效路径语句的示例。 这些示例可能和您的应用程序不同,这取决于操作系统和配置。
此目录配置语句指定当客户机浏览器发送包含某种文件类型的直接请求时, 在服务器上的什么位置中存储上传的文件。未设置此变量时,Net.Data 将不接受文件上传。
语法:
DTW_UPLOAD_DIR [=] path
示例:
DTW_UPLOAD_DIR /usr/lpp/internet/server_root/pub/upload
此路径配置语句标识了一个或多个目录,Net.Data 在其中搜索 EXEC 语句调用的外部程序或可执行变量。目录在路径语句中的顺序确定了 Net.Data 搜索目录的顺序。如果找到程序,则将外部程序名附加到路径说明后,形成一个传送到语言环境执行的 全限定文件名。
语法:
EXEC_PATH [=] path1;path2;...;pathn
示例:以下示例显示了初始化文件中的 EXEC PATH 语句以及调用外部程序的宏中的 EXEC 语句。
Net.Data 初始化文件:
EXEC_PATH /u/user1/prgms;/usr/lpp/netdata/prgms;
Net.Data 宏:
%FUNCTION(DTW_REXX) myFunction() { %EXEC{ myFunction.cmd %} %}
如果在 /usr/lpp/netdata/prgms 目录中找到文件 myFunction.cmd,则程序的限定名为 /usr/lpp/netdata/prgms/myFunction.cmd。
如果在 EXEC_PATH 语句指定的目录中没有找到文件:
http://myserver/cgi-bin/db2www/usr/user1/prgms/myFunction.cmd
Net.Data 将在 /u/user1/prgms/myFunction.cmd 目录路径中搜索文件。
http://myserver/cgi-bin/db2www/myFunction.cmd/report
并且在 EXEC_PATH 指定的所有目录 中都没有找到文件 myFunction.cmd,那么 Net.Data 将试图在当前工作目录中查找该文件。
此路径配置语句标识了一个或多个 Net.Data 搜索的目录, 以它们指定的顺序进行搜索,从中搜索一个平面文件接口 (FFI) 函数引用 的平面文件。
语法:
FFI_PATH [=] path1;path2;...;pathn
示例:以下示例显示了初始化文件中的 FFI_PATH 语句。
Net.Data 初始化文件:
FFI_PATH /u/user1/ffi;/usr/lpp/netdata/ffi;
当调用 FFI 语言环境时,Net.Data 将查看 FFI_PATH 语句中指定的路径。
因为 FFI_PATH 语句用于为那些不在路径语句所含目录中的文件提供安全性, 因此对于没有找到的 FFI 文件提供了特殊措施。参见 Net.Data 参考中 有关 FFI 内部函数一节。
此目录配置语句指定 Net.Data 将大型对象 (LOB) 写入哪个目录。此路径语句只接受一个目录路径。
安装期间,Net.Data 将创建一个名为 tmplobs 的目录, 该目录在 HTML_PATH 路径配置变量指定的目录下。Net.Data 将所有 LOB 文件存储在这个目录中。如果更改 了 HTML_PATH 的值,则将在新的目录下创建一个新的子目录。
语法:
HTML_PATH [=] path
示例:以下示例显示了初始化文件中的 HTML_PATH 语句。
Net.Data 初始化文件:
HTML_PATH /db2/lobs
当查询返回一个 LOB 时,Net.Data 将把它保存在 HTML_PATH 配置语句指定的目录中。
性能提示:在使用 LOB 时请考虑系统限度,因为它们会很块地消耗资源。参见使用大对象以获取更多信息。
此路径配置语句标识了一个或多个 Net.Data 搜索的目录, 以它们指定的顺序进行搜索,从而找到一个 Net.Data 宏中的 INCLUDE 语句 所指定的文件。在找到这个文件之后,Net.Data 将把包含文件的名称附加到路径说明后面,以便产生限定的包含文件名。
语法:
INCLUDE_PATH [=] path1;path2;...;pathn
例 1:以下示例显示了初始化文件中的 INCLUDE_PATH 语句和指定 包含文件的 INCLUDE 语句。
Net.Data 初始化文件:
INCLUDE_PATH /u/user1/includes;/usr/lpp/netdata/includes
Net.Data 宏:
%INCLUDE "myInclude.txt"
如果在 /u/user1/includes 目录中找到文件 myInclude.txt, 则包含文件的全限定名称是 /u/user1/includes/myInclude.txt。
例 2:以下示例显示了 INCLUDE_PATH 语句和带有子目录名称的 INCLUDE 文件。
Net.Data 初始化文件:
INCLUDE_PATH /u/user1/includes;/usr/lpp/netdata/includes
Net.Data 宏:
%INCLUDE "OE/oeheader.inc"
包含文件是在目录 /u/user1/includes/OE 和 /usr/lpp/netdata/includes/OE 中搜索的。如果文件在 /usr/lpp/netdata/includes/OE 中找到,则包含文件的全限定名称 就是 /usr/lpp/netdata/includes/OE/oeheader.inc。
如果在 INCLUDE_PATH 语句指定的目录中没有找到文件:
http://myserver/cgi-bin/db2www/u/user1/includes/oeheader.inc
Net.Data 将在 /u/user1/includes/oeheader.inc 目录路径中搜索文件。
http://myserver/cgi-bin/db2www/my.cmd/report
并且在 INCLUDE_PATH 指定的所有目录 中都没有找到文件 myFunction.cmd,那么 Net.Data 将试图在当前工作目录中查找该文件。
此路径配置语句标识了 Net.Data 搜索 Net.Data 宏的目录。例如,指定 以下 URL 将请求带有路径和文件名 /macro/sqlm.d2w:
http://server/cgi-bin/db2www/macro/sqlm.d2w/report
语法:
MACRO_PATH [=] path1;path2;...;pathn
等号 (=) 是可选的,由方括号指出。
Net.Data 在 MACRO_PATH 配置语句中将路径 /macro/sqlm.d2w 附加到路径后面,从左 至右,直至 Net.Data 找到宏或搜索完所有路径。参见调用 Net.Data以获取有关 调用 Net.Data 宏的信息。
示例:以下示例显示了初始化文件中的 MACRO_PATH 语句以及 调用 Net.Data 的相关链。
Net.Data 初始化文件:
MACRO_PATH /u/user1/macros;/usr/lpp/netdata/macros
HTML 链:
<a href="http://server/cgi-bin/db2www/query.d2w/input">Submit another query.</a>
如果在目录 /u/user1/macros 中找到文件 query.d2w, 那么全限定路径就是 /u/user1/macros/query.d2w。
如果在 MACRO_PATH 语句指定的目录中没有找到文件:
http://server/cgi-bin/db2www/u/user1/macros/myfile.txt/report
Net.Data 将在 /u/user1/macros/myfile.txt 目录路径中搜索文件。
http://server/cgi-bin/db2www/myfile.txt/report
并且 在 MACRO_PATH 指定的所有目录中都没有找到文件 myfile.txt,则 Net.Data 将试图 在根 (/) 目录中查找文件:/myfile.txt