參考手冊

Net.Data 雜項變數

這些變數由 Net.Data 定義，用來影響 Net.Data 處理程序、尋找函數呼叫的狀態、 與取得關於資料庫查詢結果的資訊，也用來決定關於檔案位置和日期的資訊。 您可能會覺得這些變數用在您所寫的函數當中， 或者用在測試 Net.Data 巨集時，相當得心應手。

• DTW_CURRENT_FILENAME

• DTW_CURRENT_LAST_MODIFIED

• DTW_DEFAULT_MESSAGE

• DTW_LOG_LEVEL

• DTW_MACRO_FILENAME

• DTW_MACRO_LAST_MODIFIED

• DTW_MBMODE

• DTW_MP_PATH

• DTW_MP_VERSION

• DTW_PRINT_HEADER

• DTW_REMOVE_WS

• RETURN_CODE

DTW_CURRENT_FILENAME

目的

現行輸入檔的名稱及副檔名。此輸入檔可能是 Net.Data 巨集， 也可能 INCLUDE 陳述式所指定的檔案。

這是一種預設變數，其數值無法修改。 使用這種變數作為變數參照。

範例

<P>這個檔案是 <I>$(DTW_CURRENT_FILENAME)</I>,
它是在 $(DTW_CURRENT_LAST_MODIFIED) 時更新。

DTW_CURRENT_LAST_MODIFIED

目的

前次修改現行檔案的日期和時間。 現行檔案可能是一個 Net.Data 巨集， 也可能是 INCLUDE 陳述式中所指定的檔案。輸出格式是根據 Net.Data 執行的系統而定。

這是一種預設變數，其數值無法修改。 使用這種變數作為變數參照。

範例

<P>這個檔案是 <I>$(DTW_CURRENT_FILENAME)</I>,
它是在 $(DTW_CURRENT_LAST_MODIFIED) 時更新。

DTW_DEFAULT_MESSAGE

目的

包含當錯誤發生時，由某次呼叫傳給內建函數或語言環境的訊息文字。

您可在 Net.Data 巨集中的任何部分使用 DTW_DEFAULT_MESSAGE 變數。

這是一個已事先定義好的變數，建議您不要修改它的值。 將它作為一個變數參照使用。

範例

範例 1： 告知函數是否順利完成的訊息

@function1()
%IF ("$(RETURN_CODE)" == "0")
 函數已經順利完成。
%ELSE
函數失敗，傳回的回覆碼為 $(RETURN_CODE)。傳回的錯誤訊息為
"$(DTW_DEFAULT_MESSAGE)"。
%ENDIF

範例 2： 當函數傳回一個非零回覆碼時的預設文字

%MESSAGE{
default: {<h2>Net.Data 收到回覆碼: $(RETURN_CODE).
錯誤訊息是 $(DTW_DEFAULT_MESSAGE)</h2> %} : continue
%}

如果函數所傳回的回覆碼不是 0， 則使用者會看見預設的錯誤訊息。

DTW_LOG_LEVEL

目的

Net.Data 寫入日誌檔的訊息層次。

您可以使用 DEFINE 陳述式或 @DTW_ASSIGN() 函數，來指定這個變數的值。

需求： 您必需在 Net.Data 起始設定檔中定義 DTW_LOG_DIR 來起始記載日誌； 否則當您在巨集中設定 DTW_LOG_LEVEL 變數時，Net.Data 不會記錄訊息。

值

DTW_LOG_LEVEL="OFF|ERROR|WARNING"

表 22. DTW_LOG_LEVEL 值

範例

%DEFINE DTW_LOG_LEVEL="ERROR"

DTW_MACRO_FILENAME

目的

現行 Net.Data 巨集檔的名稱與副檔名。

這是一種預設變數，其數值無法修改。 使用這種變數作為變數參照。

範例

<P>這個 Net.Data 巨集是 <I>$(DTW_MACRO_FILENAME)</I>,
它是在 $(DTW_MACRO_LAST_MODIFIED) 時更新。

DTW_MACRO_LAST_MODIFIED

目的

前次修改 Net.Data 巨集的日期和時間。 輸出格式是依 Net.Data 執行的系統而定。

這是一種預設變數，其數值無法修改。 使用這種變數作為變數參照。

範例

<P>這個 Net.Data 巨集是 <I>$(DTW_MACRO_FILENAME)</I>,
它是在 $(DTW_MACRO_LAST_MODIFIED) 時更新。

DTW_MBMODE

目的

提供多位元字集支援給預設語言環境所使用的字串及字組函數。 您可以在起始設定檔中設定這個變數， 但也可以在巨集中使用它來設定或置換現行的設定。

使用 DEFINE 陳述式或 以 @DTW_ASSIGN() 函數來設定這個變數值。

您可以在起始設定檔中設定這個變數， 但也可以在巨集中使用它來設定或置換現行的設定。

OS/400 的使用者請注意： Net.Data for OS/400 會自動啟用 MBCS 支援的函數， 所以不需要這個變數。Net.Data for OS/400 不處理被移到 OS/400 作業系統的巨集內所含的此變數。

這個架構變數使用 DTW_UNICODE 架構變數。 若 DTW_UNICODE 使用預設值 NO，則使用 DTW_MBMODE 的值。若 DTW_UNICODE 設定的值不是 NO，則使用其值。 表 23 說明這兩個變數決定內建函數處理字串的方式：

表 23. DTW_UNICODE 與 DTW_MBMODE 設定之間的關係

值

DTW_MBMODE="YES"|"NO"

表 24. DTW_MBMODE 值

範例

範例 1： 置換 INI 檔案中的值

INI 檔：

DTW_MBMODE NO

巨集：

 %DEFINE DTW_MBMODE = "YES"

DTW_MP_PATH

目的

Net.Data 可執行檔的路徑與名稱。依照不同的系統， 其輸出路徑與名稱看起來會像以下所示的樣本：

/usr/lpp/internet/server_root/cgi-bin/db2www

這是一種預設變數，其數值無法修改。 使用這種變數作為變數參照。

範例

Net.Data 可執行檔是 $(DTW_MP_PATH)。

DTW_MP_VERSION

目的

在伺服器上執行之 Net.Data 的版本和版次號碼。

這是一種預設變數，其數值無法修改。 使用這種變數作為變數參照。

範例

這個 Web 應用程式是使用 $(DTW_MP_VERSION)。

DTW_PRINT_HEADER

目的

指定 HTTP 表頭的文字。

您必須先設定這個變數，才能讓 Net.Data 處理任何傳到 Web 瀏覽器的文字， 因為 Net.Data 會在顯示文字之前，先讀取這個變數， 之後便不會再察看它。一旦 Net.Data 將文字傳給瀏覽器之後， 任何對 DTW_PRINT_HEADER 變數所做的變更，一律不予處理。

如果您使用 DTW_PRINT_HEADER 製作自己的表頭 (DTW_PRINT_HEADER="NO")， 則您必需設定 DTW_REMOVE_WS="NO"。

使用 DEFINE 陳述式或 以 @DTW_ASSIGN() 函數來設定這個變數值。

值

DTW_PRINT_HEADER="YES"|"NO"

表 25. DTW_PRINT_HEADER 值

範例

這個變數最常見的用法，是啟用 Net.Data 巨集來傳送 cookies。 要設定 cookies，必須將 DTW_PRINT_HEADER 變數設為 NO, 而前三行必須是 Content-type 表頭、 Set-Cookie 陳述式、然後是一個空行。

範例 1：啟用 Net.Data 傳送 cookie

%DEFINE DTW_PRINT_HEADER="NO"
 
%HTML(cookie1) {
Content-type: text/html
Set-Cookie: UsrId=56, expires=Friday, 12-Dec-99, 12:00:00 GMT; path=/
 
<P>
任何文字
%}

DTW_REMOVE_WS

目的

藉由壓縮定位、白色空間及換行字元引起的額外空間，減少動態產生的 Web 網頁大小。

在 DEFINE 陳述式中指定這個變數的值。

使用<PRE></PRE>標籤： 將這個變數定義為 YES 時，會影響列印出來的白色空間數量和類型。 如果將該變數設定為 YES，則使用 <PRE></PRE> 標籤的 HTML 頁面會有一部份可能無法如預期地顯示。

如果您使用 DTW_PRINT_HEADER 製作自己的表頭 (DTW_PRINT_HEADER="NO")， 您必需設定 DTW_REMOVE_WS="NO"。

OS/390 使用者：在起始設定檔案中設定這個變數， 來指定一個值給您所有的巨集。您可以在巨集中定義這個值，將它置換。 如果巨集中沒有定義 DTW_REMOVE_WS，則使用起始設定檔案中的值。

值

DTW_REMOVE_WS="YES"|"NO"

表 26. DTW_REMOVE_WS 值

範例

範例 1：壓縮白色空間

DTW_REMOVE_WS="YES"
 

RETURN_CODE

目的

由一呼叫傳回給內建函數或語言環境的回覆碼。Net.Data 是使用此值來處理 MESSAGE 區塊。您可以使用這個變數， 來判斷函數呼叫的結果是成功還是失敗。如果其值為零，表示函數呼叫已經順利完成。

您可在 Net.Data 巨集中的任何部分參照 RETURN_CODE 變數。

這個值是一個預設值；建議您不要修改它。 將它作為一個變數參照使用。

範例

範例 1：告知函數是否順利完成的訊息

@function1()
%IF ("$(RETURN_CODE)" == "0")
 函數已經順利完成。
%ELSE
函數失敗，其回覆碼為 $(RETURN_CODE)。
%ENDIF

範例 2：當回覆碼為 0 時的預設訊息

%MESSAGE{
default: "<h2>Net.Data 收到回覆碼： $(RETURN_CODE)</h2>" : continue
%}

如果函數所傳回的回覆碼不是 0， 則畫面會出現預設的訊息。