練習 1.1:選取資源配接器
這個指導教學會透過詳細的步驟,引導您產生 J2C 應用程式,來處理可變長度和多重區段 IMS 交易輸出訊息。
在開始這個指導教學之前,您必須先取得必要的資源:
- IMS 相關資訊:在這個指導教學中,您的應用程式會與 IMS 中的 IMS 應用程式互動。您必須取得某些資訊,例如:IMS Connect 的主機名稱和埠號,以及執行交易時所在之 IMS 資料儲存庫的名稱。請與 IMS 系統管理員聯絡,以取得這項資訊。說得明確一點,如果您要執行 IMS\MultiSegmentOutput IMS 程式,您必須在 IMS 中執行某些設定工作。 以下提供這項資訊。
- COBOL 檔 MSOut.cbl 的複本。您可以在產品安裝目錄中找到這個檔案:\rad\eclipse\plugins\com.ibm.j2c.cheatsheet.content_6.0.0\samples\IMS\MultiSegmentOutput。如果您要將它儲存在本端環境中,您可以從下列檔案複製程式碼:MSOut.cbl
- 全新的工作區。
附註:這個指導教學中使用的 IMS 交易不是 IMS 安裝驗證程式之一。這個指導教學使用的是 DFSDDLT0,這是一種 IMS 應用程式,它會根據控制陳述式資訊,來對 IMS 發出呼叫。
以下提供這個指導教學的 DFSDDLT0 控制陳述式。不過,如果要執行這個指導教學,您必須針對 DFSDDLT0 來配置您的環境,並提供必要的 JCL。這個指導教學利用 SKS2 作為 DFSDDLT0 應用程式的交易碼。
DFSDDLT0 控制陳述式
S11 1 1 1 1 TP 1
L GU
E OK
E Z0017 DATA SKS2 M2 SI1M3 SI1
WTO SEGMENT SI1 RECEIVED
L GN
E QD
WTO END OF INPUT SEGMENTS
L ISRT IW06OUT
L Z0012 DATA *******M1SO1
E OK
WTO SEGMENT SO1 INSERTTED
L ISRT
L Z0027 DATA ********M1SO2*********M2SO2
E OK
WTO SEGMENT SO2 INSERTTED
L ISRT
L Z0048 DATA **********M1SO3***********M2SO3************M3SO3
E OK
WTO SEGMENT SO3 INSERTTED
WTO CURRENT PROGRAM STLDDLT2 TERMINATED
L GU
這個指導教學利用 COBOL 資料結構來說明 IMS 交易的輸入和輸出訊息。請注意,IMS 傳回的輸出訊息由三個固定長度區段組成:
- OUTPUT-SEG1(16 個位元組)
- OUTPUT-SEG2(31 個位元組)
- OUTPUT-SEG3(52 個位元組)
這個特定 IMS 應用程式傳回的輸出訊息有 99 個位元組的固定大小,並由 COBOL 01 結構 OUTPUT-MSG 代表該應用程式。
開發這種多重區段應用程式之方式之一,就是利用 OUTPUT-MSG 這個 COBOL 定義來定義交易的輸出。第二種方式則是建立交易輸出的輸出訊息。
這個指導教學提供的程式碼採用第二種方式,因為它也可以用來建置應用程式,以處理可變長度輸出訊息。個別訊息區段的 COBOL 定義可以繼續用來簡化對個別區段資料的存取權。
選取資源配接器
切換至 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,所以不需要 JNDI 名稱。)接受 com.ibm.connector2.ims.ico.IMSManagedConnectionFactory 這個預設連線類別名稱。在空白欄位中,提供所有必要的連線資訊。必要欄位(以星號 (*) 表示)包括下列項目:
TCP/IP 連線適用:
- 主機名稱:(必要)IMS Connect 的 IP 位址或主機名稱。
- 埠號:(必要)目標 IMS Connect 所用的埠號。
區域選項連線適用:
- IMS Connect 名稱:(必要)目標 IMS Connect 的名稱。
以上兩種連線都適用:
- 資料儲存庫名稱:(必要)目標 IMS 資料儲存庫的名稱。
您可以向 IMS 系統管理員取得連線資訊。當您已提供必要的連線資訊時,請按下一步。
現在您已準備好開始進行練習 1.2:設定 Web 專案及 Java 介面和實作。