持續巨集函數可經由協助您定義單一異動內哪些巨集區塊是持續的， 來支援 Net.Data 中的異動處理。 使用這些函數，可定義異動的開頭與結尾，哪些 HTML 區塊在整個異動中是持續的、 異動內的變數範圍，以及是否要確定或回捲異動內的變更。
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
|
|
|
|
| X |
|
|
|
目的
定義用來呼叫持續巨集的異動 handle。Net.Data 需要異動 handle 包括在 URL 中， 如此 URL 方可呼叫巨集，為來自 Web 瀏覽器的回應。當一個要求來到 Web 伺服器時， 伺服器會使用異動 handle，將要求遞送到正在處理異動的 CGI 處理。
須在巨集中的每一 HTML 區塊的開頭呼叫異動 handle， 直到最後一個含有 DTW_TERMINATE() 的呼叫的邏輯區塊為止。 在任何文字輸出到瀏覽器之前，若找不到 DTW_ACCEPT() 或 DTW_TERMINATE() 的呼叫， 將發生 Net.Data 錯誤。
您可以指定此頁的逾時值，來置換 @DTW_STATIC() 函數上所指定的逾時值。 Web 伺服器會等待指定的時間量 (秒)，讓使用者回應此要求。
當巨集不在持續狀態時，若呼叫這個函數，將發生 Net.Data 錯誤。
要訣：含有異動 handle 的 URL 可編寫為格式按鈕上的動作， 或呈現給瀏覽器的頁面的超本文鏈結。
格式
@DTW_ACCEPT(handle, timeout)
@DTW_ACCEPT(handle)
值
| 資料類型 | 參數 | 使用 | 說明 |
|---|---|---|---|
| 字串 | handle | IN | 一個變數或文字字串，指定將在 URL 中使用，以便在此持續異動中進行後續巨集呼叫的異動 handle。 |
| 整數 | timeout | IN | 一個變數或文字字串，指定伺服此埠的工作等待回應的時間量 (秒)。 這個值會置換 DTW_STATIC() 函數上所指定的任何逾時值。 |
範例
範例 1：
%DEFINE handle = ""
@DTW_RTVHANLDE(handle)
%HTML(REPORT){
@DTW_ACCEPT(handle)
...
%}
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
|
|
|
|
| X |
|
|
|
目的
使自從上一個確定界限後，在確定控制下對資源所做的任何擱置變更成為永久變更， 並建立新的確定界限。
格式
@DTW_COMMIT()
值
無。
範例
範例 1：指定確定
@DTW_COMMIT()
%HTML(report){
%}
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
|
|
|
|
| X |
|
|
|
目的
重新建立上一個確定界限作為現行確定界限。 自從退出上一個確定界限後，在 Net.Data 執行的處理的確定控制下， 對資源所做的所有變更。
格式
@DTW_ROLLBACK()
值
無。
範例
範例 1：指定回捲
@DTW_ROLLBACK()
%HTML(report){
%}
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
|
|
|
|
| X |
|
|
|
目的
產生並傳回一個異動 handle，它對於經過多個個別呼叫的這個巨集而言是唯一的， 且會依據緒資訊、時間戳記及現行使用者 (若有的話) 的結合來計算它的值。 異動 handle 可用來確定指定為持續異動一部份的 URL 對 HTTP 伺服器是唯一的， 且可穩穩地識別為有效的要求。
格式
@DTW_RTVHANDLE(handle)
值
| 資料類型 | 參數 | 使用 | 說明 |
|---|---|---|---|
| 字串 | handle | OUT | 含有現行持續巨集的唯一異動 handle 的變數。 |
範例
範例 1：定義用來取回異動 handle 的 handle 變數
%DEFINE handle = "" @DTW_RTVHANLDE(handle)
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
|
|
|
|
| X |
|
|
|
目的
指出整個巨集是持續的。它應該是巨集中的第一個陳述式。 在這個函數呼叫後於巨集中定義的所有變數，在多個巨集呼叫之間均是持續的， 除非另有指定，以及直到呼叫 DTW_TERMINATE() 或終止處理為止。
可在函數呼叫上設定逾時值 (秒)，來指出 Net.Data 執行的處理等待瀏覽器回應的時間量。 如果逾時值到期，則處理將終止，且會回捲自從上一個確定界限後， 於確定控制下對資源所做的全部變更。
如果在後續 @DTW_ACCEPT() 呼叫上指定了逾時值，Net.Data 將以後續呼叫中的值置換這個值。如果未在這個呼叫或後續 @DTW_ACCEPT() 呼叫上指定逾時值， 將使用 Web 伺服器的預設逾時值。
格式
@DTW_STATIC(timeout)
@DTW_STATIC()
值
| 資料類型 | 參數 | 使用 | 說明 |
|---|---|---|---|
| 整數 | timeout | IN | 一個變數或文字字串，指定處理此異動的處理應等待回應的時間量 (秒)。 |
範例
範例 1：指定逾時值 60 秒的 DTW_STATIC() 的呼叫
@DTW_STATIC("60")
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
|
|
|
|
| X |
|
|
|
目的
終止持續異動。自從上一個確定界限後，於確定控制下對資源所做的變更均成為永久變更。
在任何文字輸出到瀏覽器之前，於持續異動的上一個邏輯 HTML 區塊的開頭呼叫 DTW_TERMINATE 函數。 如果有任何文字出現在區塊內的函數之前，將發生 Net.Data 錯誤。 請注意，可能有多個上一個邏輯 HTML 區塊，得視應用程式的撰寫方式而定。 當巨集不在持續狀態時，若呼叫這個函數，將發生 Net.Data 錯誤。
格式
@DTW_TERMINATE()
值
無
範例
範例：終止持續異動
%HTML(QUIT){
@DTW_TERMINATE()
...
%}