Net.Data 从路径配置语句的设置中确定 Net.Data 文件所使用的文件和可执行程序的位置。 路径语句有:
这些路径语句标识了一个或多个 Net.Data 在试图找出宏文件、文本文件LOB 文件 和包含 文件时搜索的目录。您所需的路径语句取决于宏所使用的 Net.Data 的功能。
更新准则:
有些一般准则适用于所有路径语句。
技巧:Net.Data 搜索所有指定的目录,但不包括子目录。例如,如果 以下目录中有 Net.Data 宏,则必须在路径语句中指定各子目录。
/usr/test/client /usr/test/assoc /usr/test/partner
您的 MACRO_PATH 语句看起来可能是这样的:
MACRO_PATH [=] /usr/test/client;usr/test/assoc;usr/test/partner
以下章节将描述每个路径语句的目的和语法,并提供有效路径语句的示例。这些 例子可能和您的应用程序不同,这取决于操作系统和配置。
MACRO_PATH 配置语句标识了 Net.Data 搜索 Net.Data 宏文件的目录。例如,指定 以下 URL 将请求带有路径和文件名 macro/sqlm.d2w 的 Net.Data 宏:
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/SYSADM/macros 中找到文件 query.d2w, 那么全限定路径就是 /u/SYSADM/macros/query.d2w。
EXEC_PATH 配置语句标识了一个或多个目录,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。
INCLUDE_PATH 配置语句标识了一个或多个 Net.Data 搜索的目录, 以它们指定的顺序进行搜索,从而找到一个 Net.Data 宏中的 INCLUDE 语句所指定的文件。 在找到这个文件之后,Net.Data 将把包含文件的名称附加到路径说明后面,以便产生限定的包含文件名。
语法:
INCLUDE_PATH [=] path1;path2;...;pathn
技巧:如果从本地的 Web 服务器包含 HTML 文件,可以 使用 INCLUDE_URL 结构,如 Net.Data 参考中用于 INCLUDE_URL 的 本地 Web 服务器示例中所示。 通过使用演示的语法,您不必更新 INCLUDE_PATH 来指定 Web 服务器已知的目录。
例 1:以下例子显示了初始化文件中的 INCLUDE_PATH 语句和指定 包含文件的 INCLUDE 语句。
Net.Data 初始化文件:
INCLUDE_PATH = /u/SYSADM/includes;/usr/lpp/netdata/includes;
Net.Data 宏:
%INCLUDE "myInclude.txt"
如果在目录 /u/SYSADM/includes 中找到文件 myInclude.txt, 则包含文件的全限定名称是 /u/SYSADM/includes/myInclude.txt。
例 2:以下例子显示了 INCLUDE_PATH 语句和由子目录全限定的 INCLUDE 文件。
Net.Data 初始化文件:
INCLUDE_PATH = /u/SYSADM/includes;/usr/lpp/netdata/includes;
Net.Data 宏:
%INCLUDE "/OE/oeheader.inc"
包含文件是从目录 /u/SYSADM/includes/OE 和 /usr/lpp/netdata/includes/OE 中搜索的。如果文件在 /usr/lpp/netdata/includes/OE 中找到,则包含文件的全限定名称 就是 /usr/lpp/netdata/includes/OE/oeheader.inc。
FFI_PATH 配置语句标识了一个或多个 Net.Data 搜索的目录, 以它们指定的顺序进行搜索,从中搜索一个平面文件接口 (FFI) 函数引用 的平面文件。
语法:
FFI_PATH [=] path1;path2;...;pathn
例:以下例子显示了初始化文件中的 FFI PATH 语句。
Net.Data 初始化文件:
FFI_PATH = /u/SYSADM/ffi;/usr/lpp/netdata/ffi;
当调用 FFI 语言环境时,Net.Data 将查看 FFI_PATH 语句中指定的路径。
HTML_PATH 配置语句指定了 Net.Data 将大型对象 (LOB) 写入哪个目录。这个值可以通过 配置初始化文件来更改。此路径语句只接受一个目录路径。
语法:
HTML_PATH [=] path
例:以下例子显示了初始化文件中的 HTML PATH 语句。
Net.Data 初始化文件:
HTML_PATH = /pub/htm
当查询返回一个 LOB 时,Net.Data 将把它保存在 HTML_PATH 配置语句指定的目录中。
性能技巧:在使用 LOB 时请考虑系统限度,因为它们会很块地消耗资源。请参阅使用大型对象, 以获取更多信息。