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 會快速消耗資源, 所以在使用 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 的 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 陳述式中指定的目錄中找不到檔案:
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