IBM Books

Net.Data 管理与程序设计指南,OS/2、Windows NT 以及 UNIX 版

定制路径配置语句

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

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

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

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

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

HTML_PATH 配置语句指定了 Net.Data 将大型对象 (LOB) 写入哪个目录。这个值可以通过 配置初始化文件来更改。此路径语句只接受一个目录路径。

语法:

HTML_PATH [=] path

例:以下例子显示了初始化文件中的 HTML PATH 语句。

Net.Data 初始化文件:

HTML_PATH = /pub/htm

当查询返回一个 LOB 时,Net.Data 将把它保存在 HTML_PATH 配置语句指定的目录中。

性能技巧:在使用 LOB 时请考虑系统限度,因为它们会很块地消耗资源。请参阅使用大型对象, 以获取更多信息。


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