練習 1.3:建立訊息緩衝區類別
開始之前,您必須先完成練習 1.2:設定 Web 專案及 Java 介面和實作。
練習 1.3 會引導您建立訊息緩衝區類別。在這個練習中,您將執行下列動作:
- 建立訊息緩衝區類別
- 利用 Doclet 註釋來編輯訊息緩衝區類別
- 建立輸入和輸出連結作業
- 建立輸出區段資料對映
建立訊息緩衝區類別
- 展開 MultiSegOutput 專案,展開 Java 資源,然後展開 JavaSource。
- 用滑鼠右鍵按一下 sample.ims 套件,然後選取新建 > 類別,來啟動「新建類別」精靈。
- 輸入 CCIBuffer,作為類別名稱。接受所有預設值。
- 按一下完成。這時會在 Java 編輯器中開啟 CCIBuffer 類別。
- 在 CCIBuffer 類別的註解區段中,新增 @type-descriptor.message-buffer 標示。
- 按下 CTRL-S 來儲存變更。請注意,CCIBuffer.java 中會自動產生新程式碼。
建立方法來執行 IMS 交易和輸入訊息資料類型
- 在「專案瀏覽器」視圖中,用滑鼠右鍵按一下 MSOImpl.java,然後選取程式碼 > 將方法新增至 J2C Java Bean。
- 在「新建 Java 方法」頁面中,按一下新增。
- 輸入 runMultiSegOutput,作為 Java 方法名稱。按下一步。
- 按一下新建按鈕,來定義輸入類型。
- 選取 COBOL_to_Java 對映。按一下瀏覽按鈕。
- 尋找 MSO.cbl COBOL 檔。按一下開啟。
- 按下一步。
- 在「COBOL 匯入器」頁面中,按一下顯示進階。
- 選取下列選項:
參數
|
值 |
平台名稱
|
Z/OS
|
字碼頁
|
037 |
浮點數格式名稱
|
IBM 390 十六進位
|
外部十進位符號
|
EBCDIC
|
排列法名稱
|
Big
|
遠端整數排列法名稱
|
Big
|
引號名稱
|
DOUBLE
|
Trunc 名稱
|
STD |
Nsymbol 名稱
|
DBCS
|
- 按一下查詢按鈕,來載入資料。
- 這時會顯示資料結構清單。在資料結構欄位中,選取 INPUT-MSG。按下一步。
- 在「儲存內容」頁面中,預設的 Java 類別名稱是 INPUTMSG。
將 Java 類別名稱改寫為 InputMsg。
按一下完成。
建立輸出訊息資料類型
- 按一下瀏覽,來定義輸出類型。
- 在選取資料類型欄位中輸入 CC,這時相符的類型欄位中會出現 CCIBuffer。選取 CCIBuffer 作為輸出類型。按一下完成。
- 在「Java 方法」頁面上,按一下完成,完成方法定義。
- 在「Java 方法」頁面中,確定 interactionVerb 已設為 SYNC_SEND_RECEIVE (1),來指出與 IMS 的互動涉及一項傳送作業,其後會有一項接收互動。
- 按一下完成來結束作業。
建立輸出區段資料對映
如果要完成這個步驟,您需要使用獨立式資料對映精靈,以便讓您只建立資料對映檔。
建立 OutputSeg1.java
- 前往檔案 > 新建 > 其他 > CICS/IMS Java 資料連結,來呼叫「資料連結」精靈。
- 按下一步。
- 在選擇對映清單中,選取 COBOL_To_Java。針對 COBOL 檔,瀏覽並尋找 MSO.cbl COBOL 記錄定義檔。按下一步。
- 在「COBOL 匯入器」頁面中,按一下顯示進階。
- 選取下列選項:
參數
|
值 |
平台名稱
|
Z/OS
|
字碼頁
|
037 |
浮點數格式名稱
|
IBM 390 十六進位
|
外部十進位符號
|
EBCDIC
|
排列法名稱
|
Big
|
遠端整數排列法名稱
|
Big
|
引號名稱
|
DOUBLE
|
Trunc 名稱
|
STD |
Nsymbol 名稱
|
DBCS
|
- 按一下查詢按鈕,來載入資料。
- 這時會顯示資料結構清單。在資料結構欄位中,選取 OUTPUT-SEG1。按下一步。
- 在「儲存內容」精靈中,按一下瀏覽,來選取您先前建立的 MultiSegOutput 專案。
- 按一下瀏覽,來選取套件名稱:sample.ims。
- 將「Java 類別名稱」從 OUTPUTSEG1 變更為 OutputSeg1。
- 按一下完成。
建立 OutputSeg2.java
- 前往檔案 > 新建 > 其他 > J2C > CICS/IMS 資料連結,來呼叫「資料連結」精靈。
- 按下一步。
- 在「選擇對映」清單中,選取 COBOL_To_JAVA。針對 COBOL 檔,瀏覽並尋找 MSO.cbl COBOL 記錄定義檔。按下一步
- 在 COBOL 匯入器頁面中,按一下顯示進階。
- 選取下列選項:
參數
|
值 |
平台名稱
|
Z/OS
|
字碼頁
|
037 |
浮點數格式名稱
|
IBM 390 十六進位
|
外部十進位符號
|
EBCDIC
|
排列法名稱
|
Big
|
遠端整數排列法名稱
|
Big
|
引號名稱
|
DOUBLE
|
Trunc 名稱
|
STD |
Nsymbol 名稱
|
DBCS
|
- 按一下查詢按鈕,來載入資料。
- 這時會顯示資料結構清單。在資料結構欄位中,選取 OUTPUT-SEG2。按下一步。
- 在「儲存內容」精靈中,按一下瀏覽,來選取您先前建立的 MultiSegOutput 專案。
- 按一下瀏覽,來選取套件名稱:sample.ims。
- 將「Java 類別名稱」從 OUTPUTSEG2 變更為 OutputSeg2。
- 按一下完成。
建立 OutputSeg3.java
- 前往檔案 > 新建 > 其他 > J2C > CICS/IMS 資料連結,來呼叫「資料連結」精靈。
- 按下一步。
- 在「選擇對映」清單中,選取 COBOL_To_Java。針對 COBOL 檔,瀏覽並尋找 MSO.cbl COBOL 記錄定義檔。按下一步
- 在 COBOL 匯入器頁面中,按一下顯示進階。
- 選取下列選項:
參數
|
值 |
平台名稱
|
Z/OS
|
字碼頁
|
037 |
浮點數格式名稱
|
IBM 390 十六進位
|
外部十進位符號
|
EBCDIC
|
排列法名稱
|
Big
|
遠端整數排列法名稱
|
Big
|
引號名稱
|
DOUBLE
|
Trunc 名稱
|
STD |
Nsymbol 名稱
|
DBCS
|
- 按一下查詢按鈕,來載入資料。
- 這時會顯示資料結構清單。在資料結構欄位中,選取 OUTPUT-SEG3。按下一步。
- 在「儲存內容」精靈中,按一下瀏覽,來選取您先前建立的 MultiSegOutput 專案。
- 按一下瀏覽,來選取套件名稱:sample.ims。
- 將「Java 類別名稱」從 OUTPUTSEG3 變更為 OutputSeg3。
- 按一下完成。
現在您已準備好開始進行練習 1.4:建立 Java Proxy 類別來測試應用程式。