目的
替 Net.Data 巨集的函數製作文件。因為 COMMENT 區塊可以用在巨集中的任何部份, 所以沒有在其它語法圖內加以陳述。
COMMENT 區塊也可用在 Net.Data 起始設定檔中。
語法
>>-%{---本文---%}----------------------------------------------><
值
上下文
備註可放置在 Net.Data 巨集或 Net.Data 起始設定檔中任何兩個 Net.Data 語言結構之間
限制
接受任何本文或字元;但是備註區塊不可為巢狀。
範例
範例 1:基本備註區塊
%{ 這是備註區塊。不限制行數及字元。Net.Data 不處理它的內容。 %}
範例 2: FUNCTION 區塊中的備註
%function(DTW_REXX) getAddress(IN name, %{ 客戶名稱 %} IN phone, %{ 客戶電話號碼 %} OUT address %{ 客戶地址 %} ) { .... %}
範例 3:HTML 區塊中的備註
%html(report) { %{ 執行查詢並儲存結果於表格 %} @myQuery(resultTable) %{ 建置套表以顯示一頁資料 %} <form method="POST" action="report"> %{ 傳送表格給 REXX 函數,以傳送資料輸出 %} @displayRows(START_ROW_NUM, submit, resultTable, RPT_MAX_ROWS) %{ 將 START_ROW_NUM 作為隱藏變數傳給下一筆呼叫 %} <input name="START_ROW_NUM" type="hidden" value="$(START_ROW_NUM)" /> %{ 建置下一個或前一個按鈕 %} %if (submit == "both" || submit == "next_only") <input name="submit" type="submit" value="next" /> %endif %if (submit == "both" || submit == "prev_only") <input name="submit" type="submit" value="previous" /> %endif </form> %}
範例 4: DEFINE 區塊中的備註
%define { START_ROW_NUM = "1" %{ 輸出表格的起始列列號 %} RPT_MAX_ROWS = "25" %{ 表格列數的最大值 %} resultTable = %table %{ 保留查詢結果的表格 %} %}
範例 5:Net.Data 起始設定檔中的備註
%{ 變更︰已除去 RETURN_CODE 參數及 DTW_DEFAULT ENVIRONMENT 陳述 %} ... ENVIRONMENT (DTW_SQL) dtwsql (IN LOCATION, DB2SSID, DB2PLAN, TRANSACTION_SCOPE) ENVIRONMENT (DTW_ODBC) odbcdll (IN LOCATION, TRANSACTION_SCOPE) ENVIRONMENT (DTW_PERL) perldll () ENVIRONMENT (DTW_REXX) rexxdll () ENVIRONMENT (DTW_FILE) filedll () ENVIRONMENT (DTW_APPLET) appldll () ENVIRONMENT (DTW_SYSTEM) sysdll ()