部署 JCICS 範例

您可以使用 CICS Explorer® SDK 中的 CICS® 組合範例,將 JCICS 範例部署至 CICS 區域。

開始之前

您必須建立 JCICS 範例專案(如開始使用 JCICS 範例中所述)。

關於這項作業

CICS 會從 zFS 載入並執行 Java 應用程式,因此您必須將已編譯的應用程式部署至 zFS 中的適當目錄。您可以使用 CICS Explorer 中的 z/OS® 視景,在 zFS 中建立合適的目錄。CICS 必須具備此目錄的讀取權和執行權。

CICS Explorer SDK 支援將 CICS 軟體組專案中的 Java 應用程式部署至 zFS。CICS 軟體組專案將邏輯上以單一單元來部署和管理的一組 OSGi 軟體組分成一組。您可以使用 CICS 軟體組專案範例,將 JCICS 範例部署至 CICS 區域。

程序

  1. 在 Eclipse IDE 中開啟 Java 視景。
  2. 使用下列其中一種方式,開啟「新建範例」精靈:
    • 在 Eclipse 功能表列中,按一下檔案 > 新建 > 範例
    • 按一下新建精靈圖示上的下移鍵,然後按一下範例
    • 在「專案瀏覽器」視圖中,按一下滑鼠右鍵,然後按一下新建 > 範例
  3. CICS Java 資料夾中,選取 CICS 軟體組 OSGi 範例,然後按下一步
  4. 專案名稱欄位中,輸入新專案的名稱。 依預設,Eclipse 建立名稱,此名稱是工作區中範例的資料夾位置,後面接範例名稱。例如,CICS 組合的預設專案名稱是 com.ibm.cics.server.examples
  5. 按一下完成 Eclipse 會建立 CICS 軟體組專案,其中包含一個資訊清單和三個資源。這些資源參照三個 OSGi 軟體組。程式檔案也是軟體組專案範例的一部分,您可使用它來將專案部署至 CICS 並安裝組合。
  6. 開啟 web.osgibundle 檔案以檢查其內容。 此檔案為 XML 格式,其中包含 OSGi 軟體組的符號名稱及版本。也包含範例 JVM 伺服器的名稱。JVM 伺服器是 CICS 中 Java 應用程式的執行時期環境。建立您的專屬應用程式時,必須在此檔案中提供目標 JVM 伺服器的名稱。
  7. 將 CICS 組合部署至 zFS:
    1. 用滑鼠右鍵按一下 CICS 軟體組專案,然後選取匯出至 z/OS UNIX 檔案系統
    2. 選取匯出至檔案系統中的特定位置,然後按下一步
    3. 視需要輸入 FTP 認證。 如果您之前沒有設定連線,則可能需要建立連至目標主機的連線。
    4. 瀏覽至您要部署 CICS 組合的目錄,然後按一下完成
    即在指定的目錄中部署 CICS 組合。
  8. 開啟 CICS SM 視景。在 CICSplex Explorer 視圖中,選取要執行 JCICS 範例程式的 CICS 區域。
  9. 安裝位於範例群組 DFH$OSGI 中的 JVMSERVER 資源 DFH$JVMS。 此資源會在含有 OSGi 架構的 CICS 區域中,建立 JVM 伺服器範例。此資源名稱符合 CICS 組合的資訊清單中所指定的 JVM 伺服器名稱。您可以按一下作業 > Java > JVM 伺服器,以檢查 JVM 伺服器的狀態。
  10. 按一下定義 > 組合定義,以開啟「組合定義」視圖。 此視圖會列出 CICS 區域的所有組合定義。
  11. 在「資源群組定義」視圖中,選取所提供的 DFH$OSGI 群組。 如果此視圖未開啟,請選取視窗 > 顯示視圖,以在 Eclipse 視景中開啟它。 即會過濾「組合定義」視圖,以顯示 DFH$OSGB 資源定義。
  12. 將資源定義複製到新群組,以編輯屬性:
    1. 用滑鼠右鍵按一下 DFH$OSGB,然後選取複製
    2. 在「資源群組定義」視圖中的任何位置按一下滑鼠右鍵,然後選取貼上
    3. 輸入新的群組名稱,然後按一下確定
  13. 編輯新群組中的 BUNDLE 資源定義,來變更組合目錄以符合已部署 CICS 組合的位置。
  14. 用滑鼠右鍵按一下定義,以安裝 BUNDLE 資源。 您可以按一下作業 > 組合,以檢查處於 ENABLED 狀態的已安裝 BUNDLE。您也可以按一下作業 > Java > OSGi 軟體組,以檢查 OSGi 軟體組的清單。
  15. 若要在 JVM 伺服器中執行範例,請在 CICS 區域中安裝 DFH$OSGI 範例群組。 此群組包含所有範例的資源定義。這裡沒有安裝範例 BUNDLE 及 JVMSERVER 資源,因為您已建立同名的資源。 當您安裝群組時,CICS 會建立執行範例所需要的資源。

結果

您已順利將 CICS 組合範例部署至 zFS,並已建立執行 JCICS 範例所需要的 CICS 資源。

下一步

您可以執行 JCICS 範例,如執行 JCICS 範例中所述。