管理及程式設計指南

路徑架構陳述式

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

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

更新準則:

有些一般規則適用於路徑陳述式。例外狀況將會在每一路徑陳述式的說明中提到。

下列各節說明每一個路徑陳述式的目的和語法, 並提供有效路徑陳述式的範例。範例可能與您的應用程式不同, 需根據您的作業系統和架構而定。

DTW_UPLOAD_DIR

此目錄架構陳述式指定伺服器上的一個位置, 當從屬站瀏覽器送出一個含有檔案類型的直接要求時, 可用來儲存上載的檔案。 如果未設定此變數,Net.Data 將不接受上載檔案。

語法:

DTW_UPLOAD_DIR [=] path

範例:

DTW_UPLOAD_DIR /usr/lpp/internet/server_root/pub/upload

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

如果在 EXEC_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 內建函數一節。

HTML_PATH

此目錄架構陳述式指定一個目錄,供 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 時,需考慮到系統限制問題。 詳細資訊,請參閱使用大型物件

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 陳述式中設定的目錄中找不到檔案:

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 陳述式中指定的目錄中找不到檔案:


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