OS/400 版的 Net.Data 管理與程式設計手冊

路徑架構陳述式

Net.Data 根據路徑架構陳述式的設定，來決定 Net.Data 巨集檔所使用之檔案和可執行程式的位置。路徑陳述式如下：

MACRO_PATH
EXEC_PATH
INCLUDE_PATH
FFI_PATH

這些路徑陳述式識別 Net.Data 在嘗試尋找下列檔案時所搜尋的一個或多個目錄：巨集檔、可執行檔、文字檔、以及併入檔。您需要的路徑陳述式視巨集使用的 Net.Data 功能而定。

更新準則：

許多一般準則適用於所有路徑陳述式。

每一個設定目錄都是以分號 (;) 區隔開來。
斜線 (/) 與反斜線 (\) 則視為一樣。
每一個路徑陳述式可以設定多重路徑。路徑是從左到右依設定次序搜尋。此種多路徑功能，可讓您在多重目錄中組織檔案。例如，您可以將每一個 Web 應用程式於在自己的目錄中。
建議使用絕對路徑陳述式。

要訣： 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/sqlm.d2w 附加到 MACRO_PATH 架構陳述式的路徑中 (從左到右)，直到 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">提出另一個查詢。</A>

如果在目錄 /u/user1/macros 中找到檔案 query.d2w，則完整的路徑為 /u/user1/macros/query.d2w。

如果在 MACRO_PATH 陳述式中設定的目錄中找不到檔案，則 Net.Data 將在根 (/) 目錄中搜尋檔案。例如，如果提出下列的 URL：

http://myserver/cgi-bin/db2www/myfile.txt/report

且在 MACRO_PATH 中設定的任何目錄中找不到檔案 myfile.txt，Net.Data 會嘗試在根 (/) 目錄中尋找檔案：

/myfile.txt

EXEC_PATH

EXEC_PATH 架構陳述式會識別一個或多個目錄，Net.Data 將搜尋它 (它們) 來取得 EXEC 陳述式或可執行變數呼叫的外部程式。一旦找到該程式，則會將外部程式的名稱附加到路徑設定中，形成完整的檔名以便傳遞給語言環境準備執行。

語法：

EXEC_PATH [=]
path1;path2;...;pathn

範例： 下列範例顯示在起始設定檔中的 EXEC PATH 陳述式，以及巨集檔中呼叫外部程式的 EXEC 陳述式。

Net.Data 起始設定檔：

EXEC_PATH = /qsys.lib/programs.lib;/qsys.lib/rexx.lib/rexxpgms.file;

Net.Data 巨集：

%FUNCTION(DTW_REXX) myFunction() {
  %EXEC{ myFunction.mbr %}
%}

如果在 /qsys.lib/rexx.lib/rexxprgms.file 目錄中找到檔案 myFunction.mbr，則程式的完整名稱為 /qsys.lib/rexx.lib/rexxpgms.file/myFunction.mbr。

如果在 EXEC_PATH 陳述式中設定的目錄中找不到檔案：

如果設定的路徑是絕對的，Net.Data 將在設定的路徑中搜尋檔案。例如，如果設定了下列 EXEC 陳述式：
```
%EXEC{/qsys.lib/programs.lib/rpg1.pgm %}
 
```
Net.Data 將在 /qsys.lib/programs.lib 目錄中搜尋檔案 rpg1.pgm。
如果設定的路徑是相對的，Net.Data 將搜尋現行工作目錄。例如，如果設定了下列 EXEC 陳述式：
```
%EXEC { rpg1.pgm %}
```
Net.Data 將嘗試在現行工作目錄中尋找檔案 rpg1.pgm。

INCLUDE_PATH

INCLUDE_PATH 架構陳述式定義 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 陳述式中設定的目錄中找不到檔案：

如果設定的路徑是絕對的，Net.Data 將在設定的路徑中搜尋檔案。例如，如果設定了下列 INCLUDE 陳述式：
```
%INCLUDE "/u/user1/includes/oeheader.inc
 
```
Net.Data 將在 /u/user1/includes 目錄中搜尋檔案 oeheader.inc。
如果設定的路徑是相對的，Net.Data 將搜尋現行工作目錄。例如，如果設定了下列 INCLUDE 陳述式：
```
%INCLUDE "oeheader.inc"
 
```
Net.Data 將嘗試在現行工作目錄中尋找檔案 oeheader.inc。

FFI_PATH

FFI_PATH 架構陳述式定義 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 內建函數段落。

[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]