管理及程式設計指南

Net.Data 起始設定、控制和巨集檔的一般區段

Net.Data 起始設定檔、架構檔及巨集檔的某些部份必須一致, 才能讓 Net.Data 的全部元件完整地運作。 下列表格彙總必須相配的這些檔案的區域。

表 2. Net.Data 架構檔和巨集的一致性需求
檔案 一般區段 附註
Net.Data INI 檔案 環境陳述式 使用「現場連線」的語言環境必須在其環境陳述式中設定資料庫 cliette 名稱。
「現場連線」架構變數 使用「Net.Data 現場連線」時,請設定「現場連線」埠 DTW_CM_PORT。 此變數值須符合「現場連線」架構檔中的 MAIN_PORT 值。
快取架構變數 使用 Net.Data 快取時,可以選用性地包括埠號和機器名稱變數。這些值必須符合「快取管理程式」架構檔已使用的值。
「現場連線」架構檔 Cliette 定義 每一個 cliette 定義必須符合 INI 檔案中對應的定義。 此外,MAIN_PORT 值須符合 INI 檔中的 DTW_CM_PORT 變數值。
「快取管理程式」架構檔 「快取管理程式」架構變數 使用 Net.Data 快取時,您可以選用性地包括埠號和機器名稱變數。這些值必須符合 INI 檔案中已使用的值。

下列片斷說明巨集、Net.Data 起始設定檔和「現場連線」架構檔之間的關係。 兩個 cliette 是由巨集 (DTW_SQL:SAMPLE, DTW_SQL:CELDIAL ) 使用, 並存取兩個 DB2 資料庫,稱為 SAMPLECELDIAL。 「現場連線」架構檔含有 cliette 名稱與定義。 Net.Data 起始設定檔案中的 ENVIRONMENT 陳述式代表 cliette 名稱。 LOGIN 和 PASSWORD 的值,是在「現場連線」架構檔中設定。

圖 2 顯示巨集的片斷,它包含 @DTW_ASSIGN 陳述式, 定義要用來存取資料庫的 cliette。

圖 2. Net.Data 巨集片斷






<3*********************************************>
<3** 這是 HTML 備註 **>
<3** 使用 cliette DTW_SQL:SAMPLE 來存取 **>
<3** SAMPLE 資料庫 **>
<3*********************************************>
@DTW_ASSIGN (DATABASE, " SAMPLE ")
@insert_customer
(customer_name, customer_street, customer_city, customer_state,
customer_country, customer_zip, customer_credit, customer_expiry)
<3*********************************************>
<3** 這是 HTML 備註 **>
<3** 使用 cliette DTW_SQL:CELDIAL **>
<3** 來處理 CELDIAL 資料庫 **>
<3*********************************************>
@DTW_ASSIGN (DATABASE, " CELDIAL ")
@insert_customer
(customer_name, customer_street, customer_city, customer_state,
customer_country, customer_zip, customer_credit, customer_expiry)


請注意,DATABASE 架構變數會被取代為起始設定檔中的 ENVIRONMENT 陳述式來建立 cliette 名稱。 這容許您從同一巨集中存取多個資料庫。

圖 3 顯示 Net.Data 起始設定檔案中含有 ENVIRONMENT 陳述式與相關聯的 cliette 類型的片斷。 在起始設定檔中, 每一個 cliette 類型都有一個 ENVIRONMENT 陳述式。對於每一個資料庫 cliette 類型而言, ENVIRONMENT 陳述式設定一個 cliette 名稱。名稱是由 cliette 類型及在執行時將被解析的變數參照 $(DATABASE) 所構成。使用「現場連線」的每一個語言環境, 在 ENVIRONMENT 陳述式中必須包括 cliette 定義。

圖 3. Net.Data 起始設定檔片斷






ENVIRONMENT (DTW_SQL)
(IN DATABASE, LOGIN, PASSWORD, TRANSACTION_SCOPE, SHOWSQL,
ALIGN, START_ROW_NUM, DTW_SET_TOTAL_ROWS)
CLIETTE "DTW_SQL:$(DATABASE)"


圖 4 顯示「現場連線」架構檔的一個片斷, 其中含有 DTW_SQL:CELDIAL 和 DTW_JAVAPPS 的 cliette 定義。

圖 4. 「現場連線」架構檔片斷






CONNECTION_MANAGER{
MAIN_PORT=7100
ENCRYPTION=OFF
}
###############################################################
# 這是現場連線的備註。
# 備註以 # 字元開始,
# 在行尾結束,除非下一行
# 另設定 # 字元,否則不換行。
# 您可以在行尾加備註,包含
# 現場連線關鍵字,但不可在通行碼行尾加備註。
# 您無法在任何含有通行碼關鍵字
# 的行內加備註。
# 您不能在任何名稱,如 cliette 名稱或資料庫 cliette
# 通行碼內加空格與 # 字元。
###############################################################
CLIETTE DTW_SQL:CELDIAL{
MIN_PROCESS=1
MAX_PROCESS=5
EXEC_NAME=./dtwcdb2
DATABASE=CELDIAL
LOGIN=marshall
PASSWORD=stlpwd
}
CLIETTE DTW_JAVAPPS{
MIN_PROCESS=1
MAX_PROCESS=5
EXEC_NAME=./javaapp
}



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