練習 1.1:選取資源配接器
這個指導教學會透過詳細的步驟,引導您產生 J2C 應用程式,來處理輸入和輸出資料含有陣列的 IMS 交易。
在開始這個指導教學之前,您必須先取得必要的資源:
- IMS 環境的相關資訊:在這個指導教學中,您的應用程式會與 IMS 中的應用程式互動。您必須取得某些資訊,例如:IMS Connect 的主機名稱和埠號,以及執行交易時所在之 IMS 資料儲存庫的名稱。請與 IMS 系統管理員聯絡,以取得這項資訊。此外,如果您要執行這個範例,您必須在 IMS 中執行某些設定工作。以下提供這項資訊。
- COBOL 檔 InEqualsOut.cbl 的複本。您可以在產品安裝目錄中找到這個檔案:\rad\eclipse\plugins\com.ibm.j2c.cheatsheet.content_6.0.0\samples\IMS\InOutArray。如果您要將它儲存在本端環境中,您可以從下列檔案複製程式碼:InEqualsOut.cbl。
- 全新的工作區。
這個指導教學利用 COBOL 資料結構來說明 IMS 交易的輸入和輸出訊息。輸入訊息和輸出訊息相同,且包含客戶元素陣列,其後接著包含函數碼的單一欄位。這個陣列最多可以有八個元素,不過,在這個指導教學中,只將三個元素輸入 IMS 應用程式,且 IMS 應用程式只傳回四個元素。
這個指導教學所用的 IMS 交易不是 IMS 安裝驗證程式之一。它使用的是 DFSDDLT0,這是一種 IMS 應用程式,它會根據控制陳述式資訊,來對 IMS 發出呼叫。
以下提供這個指導教學的 DFSDDLT0 控制陳述式。不過,如果您要執行這個指導教學,您必須配置 DFSDDLT0 的環境,
並提供必要的 JCL。這個指導教學利用 SKS2 作為 DFSDDLT0 應用程式的交易碼。
DFSDDLT0 控制陳述式
S11 1 1 1 1 TP 1
L GU
E OK
E Z0088 DATA SKS2 03CN001Cathy Tang CN002Haley Fung X
CN003Steve Kuo 123456
WTO IC4JINOU:收到來自 JITOC 的單一區段
L GN
E QD
WTO IC4JINOU:來自 JITOC 的輸入區段結尾
L ISRT JITOC53
L Z0113 DATA TRNCD04CN001Cathy T. CN002Haley F. X
CN003Steve K. CN004Kevin F. 65432X
1E OK
WTO IC4JINOU:所插入的單一區段 - 3 個元素 !!!!!!!!!!!!!
L GU
選取資源配接器
切換至 J2EE 視景
如果工作區右上方的標籤中沒有出現 J2EE 圖示
,您必須切換至 J2EE 視景。
- 從功能表列中,選取視窗 > 開啟視景 > 其他。這時會開啟「選取視景」視窗。
- 選取 J2EE。
- 按一下確定。這時會開啟 J2EE 視景。
連接至 IMS 伺服器
- 在 J2EE 視景中,選取檔案 > 新建 > 其他。
- 在「新建」頁面中,選取 J2C > J2C Java Bean。按下一步
附註:如果精靈清單中沒有出現 J2C 選項,您必須啟用 J2C 功能。
- 從功能表列中,按一下視窗 > 喜好設定。
- 在「喜好設定」視窗的左邊,展開「工作台」。
- 按一下功能。這時畫面上會顯示「功能」窗格。如果您希望在第一次使用某個需要啟用功能的特性時收到提示,請選取在啟用功能時提示。
- 展開 Enterprise Java。
- 選取 Enterprise Java。這時會啟用必要的 J2C 功能。此外,您也可以選取 Enterprise Java 功能資料夾來啟用資料夾包含的所有功能。如果要將已啟用功能的清單設回它在產品安裝時的狀態,請按一下還原預設值。
- 如果要儲存變更,請按一下套用,然後按一下確定。啟用 Enterprise Java 功能,會自動啟用開發及除錯 J2C 應用程式時所需的任何其他功能。
在資源配接器選擇頁面中,選取 J2C 1.0 或 J2C 1.5 IMS 資源配接器。請針對這個指導教學選取 IMS Connector for Java(IBM:9.1.0.1.2):按下一步。
在 Connection 內容頁面中,取消選取「受管理連線」勾選框,然後選取非管理的連線。(在這個指導教學中,您會利用非管理的連線直接存取 IMS。)接受 com.ibm.connector2.ims.ico.IMSManagedConnectionFactory 這個預設連線類別名稱。在空白欄位中,輸入所有必要的連線資訊。必要欄位(以星號 (*) 表示)包括下列項目:
TCP/IP 連線適用:
- 主機名稱:(必要)IMS Connect 的 IP 位址或主機名稱。
- 埠號:(必要)目標 IMS Connect 所用的埠號。
區域選項連線適用:
- IMS Connect 名稱:(必要)目標 IMS Connect 的名稱。
以上兩種連線都適用:
- 資料儲存庫名稱:(必要)目標 IMS 資料儲存庫的名稱。
您可以向 IMS 系統管理員取得連線資訊。當您已提供必要的連線資訊時,請按下一步。
現在您已準備好開始進行練習 1.2:設定 Web 專案及 Java 介面和實作。