IBM Books

Net.Data 參考手冊

Net.Data 巨集檔語法

Net.Data 巨集是一個純文字檔案，含有一系列的 Net.Data 巨集語言結構，可用於：

每個陳述式是由一個或多個語言結構所組成，換句話說，就是由 關鍵字、特殊的字元、字串、名稱、和變數所組成。下圖描述了 語法上有效之 Net.Data 巨集的整體結構。 關於整體結構中每一個元素的詳細資訊，請參閱Net.Data 巨集語言結構。 

   .---------------------------.
   V                           |
>>----+---------------------+--+-----html 區塊------------------>
      +-備註區塊------------+
      +-define 陳述式-------+
      +-define 區塊---------+
      +-函數區塊------------+
      +-macro if 區塊-------+
      +-macro_function 區塊-+
      +-include 陳述式------+
      +-include_url 陳述式--+
      '-訊息區塊------------'
 
      .-------------------------------------------.
      V                                           |
>--------+---------------------+---+-----------+--+------------><
         +-備註區塊------------+   '-html 區塊-'
         +-define 陳述式-------+
         +-define 區塊---------+
         +-函數區塊------------+
         +-macro if 區塊-------+
         +-macro_function 區塊-+
         +-include 陳述式------+
         +-include_url 陳述式--+
         '-訊息區塊------------'

Net.Data 巨集包含兩個部分：宣告部分以及 HTML 部分。 您可以任何順序來多次使用這些部分。

圖 1顯示宣告及巨集檔的 HTML 部份。

圖 1. 巨集檔結構


Figure dtwa1107 not displayed.

必須先定義在宣告或 HTML 部份中使用的變數及函數， 這些變數及函數才可被用於變數參照或函數呼叫。

圖 2 示範巨集檔的部份。 宣告部份包含 DEFINE 及 FUNCTION 定義區塊。 HTML 區塊有如輸入和輸出區塊。

圖 2. 巨集檔模版格式

%{ **********************       Define 區塊        ************************%}
%DEFINE {
   page_title="Net.Data 巨集模版"
%}
 
%{ ********************** 函數定義區塊 ************************%}
%FUNCTION(DTW_REXX) rexx1 (IN input) returns(result)
    { %EXEC{ompsamp.cmd %}
%}
 
%FUNCTION(DTW_REXX) today () RETURNS(result)
  {
      result = date()
%}
 
%{ **********************      HTML 區塊：輸入    ************************%}
%HTML(INPUT){
<html>
<head>
<title>$(page_title)<title>
</head><body>
<h1>輸入格式</h1>
今天是@today()
 
<FORM  METHOD="post" ACTION="output">
請輸入一些要傳給 REXX 程式的資料：
<INPUT NAME="input_data" TYPE="text" SIZE="30">
<p>
<INPUT TYPE="submit" VALUE="Enter">
 
<hr>
<p>[<a href="/">首頁]
</body></html>
%}
 
%{ **********************    HTML 區塊：輸出     ************************%}
%HTML (OUTPUT) {
<html>
<head>
<title>$(page_title)</title>
</head><body>
<h1>輸出頁</h1>
<p>@rexx1(input_data)
<p><hr>
<p>[<a href="/">首頁</a> |
<a href="input">前一頁</a>]
</body></html>
%}

Net.Data 巨集語言是自由格式的語言，可讓您有彈性地撰寫您的巨集。除非特別指示，否則會忽略額外的空白字元。 每一個 Net.Data 巨集語言結構，及其他幾個您可以使用來定義結構的元素，將在下列部分說明。 Net.Data 巨集語言支援 DB2 WWW Connection 語言元素以便能夠與先前的版 本相容。 雖然這些語言元素已說明於附錄 A. DB2 WWW 連線，但仍建議您使用 Net.Data 語言結構。

這些範例顯示許多有關語言結構、變數、函數、和在您巨集檔案中的 其他元素之使用方式。您可從 Net.Data Web 網頁中下載 樣本及示範程式，以獲得更多的範例：

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