IBM Books

Net.Data 參考手冊

Net.Data 雜項變數

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

DTW_CURRENT_FILENAME


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

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

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

範例 

<P>這個檔案為 <I>$(DTW_CURRENT_FILENAME)</I>，
且已在 $(DTW_CURRENT_LAST_MODIFIED) 上更新。

DTW_CURRENT_LAST_MODIFIED


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

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

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

範例 

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

DTW_DEFAULT_MESSAGE


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT




X


目的

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

您可在 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


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X

X X X

目的

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 值
值 說明
OFF Net.Data 不會記錄錯誤。 OFF 是預設值。
ERROR Net.Data 會記錄錯誤訊息。
WARNING Net.Data 記錄警告及錯誤訊息。

範例 

%DEFINE DTW_LOG_LEVEL="ERROR"

DTW_MACRO_FILENAME


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

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

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

範例 

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

DTW_MACRO_LAST_MODIFIED


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

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

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

範例 

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

DTW_MP_PATH


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

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

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

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

範例 

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

DTW_MP_VERSION


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

在伺服器上執行之 Net.Data 的版本和版次號碼。 其輸出格式如下： 

Net.Data 版本 2.1

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

範例 

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

DTW_PRINT_HEADER


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

指定 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"

表 23. DTW_PRINT_HEADER 值
值 說明
YES Net.Data 列出 HTTP 表頭的文字 Content-type: text/html。YES 是預設值。
NO Net.Data 不要列出 HTTP 表頭。 您可以製作自定的 HTTP 表頭資訊。

範例

這個變數最常見的用法，是啟用 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


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

藉由壓縮定位、白色空間及換行字元引起的額外空間，減少動態產生的 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"

表 24. DTW_REMOVE_WS 值
值 說明
YES Net.Data 壓縮兩格以上連續的白色空間，成為一個換行字元， 以產生較少的 HTML 結果網頁。
NO Net.Data 不會壓縮白色空間。 NO 是預設值。

範例

範例 1：壓縮白色空間 

DTW_REMOVE_WS="YES"

RETURN_CODE


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

由一呼叫傳回給內建函數或語言環境的回覆碼。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， 則畫面會出現預設的訊息。

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