您可以使用每一個 Servlet 範例隨附的 CICS® 組合專案,將應用程式部署至 CICS 中執行的 Liberty JVM 伺服器。
開始之前
您必須建立範例 Web 應用程式,如
開始使用 Servlet 範例中所述。您也必須有權限在區域中建立和安裝 CICS 資源。您還應該安裝 Websphere
Developer Tooling OSGi 應用程式開發特性 8.5.5 版,請參閱
設定開發環境。
若要部署「CICS
Java™ 資料庫連線功能 (JDBC)」範例,您必須完成一個額外的必要步驟:
- 建立並安裝 DB2CONN CICS 資源定義,並確定其狀態為 connected。CICS DB2CONN 定義中指定的 DB2 計劃,應該與下列指定的套件清單連結:
PKLIST(NULLID.*)
關於這項作業
CICS 會從 zFS 載入並執行 Java 應用程式,因此您必須將已編譯的應用程式部署至 zFS 中可供 CICS 區域存取的目錄。在 DB2® 範例中,您也必須有範例 DB2 資料庫可用。
建議使用 CICS 組合專案來部署及安裝應用程式。利用這個方法,您接著可以使用 CICS 機能來管理這些組合專案應用程式資源。CICS 組合專案將一組外掛程式專案、動態 Web 專案及 CICS 資源包裝起來,在邏輯上形成一個單元來部署和管理。您可以對簡單的 Web 應用程式採用這種方法,例如 Hello World 範例,也可以用在更複雜的 Web 應用程式,例如其他 Servlet 範例。
部署及安裝應用程式的另一種方法是使用 Liberty 部署機制來部署 WAR 或 EBA 檔。
您可以將專案匯出為 WAR 或 EBA 檔,並使用 FTP 將檔案複製到 Liberty JVM 伺服器的 dropins 目錄。您可以對簡單的 Web 應用程式採用這種方法,例如 Hello World 範例。
程序
- 若要使用 CICS 組合專案來部署範例,您可以使用 CICS Explorer SDK。
- 在組合專案上按一下滑鼠右鍵,然後按一下將組合專案匯出至 z/OS UNIX 檔案系統。
- 遵循精靈將組合部署至 zFS 中可供 CICS 區域存取的位置。 若要使用範例群組 DFH$WLP 中的範例 BUNDLE 資源定義,請使用 /tmp/cicsts52 作為 zFS 上的上層目錄。 CICS Explorer SDK 會將 CICS 組合及相關聯的專案部署至 zFS。若 CICS 組合包含 .osgibundle 或 .warbundle 構件,則相關聯的專案會根據其專案建置內容來建置,而且也會匯出。
- 在 CICS Java 資料庫連線功能 (JDBC) 範例中,有一個組合專案需要部署。請對此組合專案執行步驟 1 和 2。
- 編輯範例 DFHWLP.jvmprofile,使用 -Dcom.ibm.cics.jvmserver.wlp.autoconfigure=true 系統內容來開啟自動配置選項。server.xml 會自動產生,並可以在 WLP_USER_DIR/servers/server_name 目錄中找到。
您可以使用「z/OS® UNIX 檔案」視圖來瀏覽目錄結構,以編輯檔案。您應該根據自己的環境指定 -Dcom.ibm.cics.jvmserver.wlp.server.host 及 -Dcom.ibm.cics.jvmserver.wlp.server.http.port 或 -Dcom.ibm.cics.jvmserver.wlp.server.https.port 的值。對於 JDBC 範例,請將 -Dcom.ibm.cics.jvmserver.wlp.jdbc.driver.location 內容設為 DB2 JDBC 驅動程式位置。 如需相關資訊,請參閱為 Liberty 手動配置 CICS DB2 JDBC 類型 2 驅動程式資料來源。
- 在 CICSplex Explorer 視圖中,選取要執行 Servlet 範例的 CICS 區域。
- 安裝位於範例群組 DFH$WLP 中的 JVMSERVER 資源 DFHWLP。 範例資源會在 CICS 區域中建立 Liberty JVM 伺服器。
Liberty JVM 伺服器會在 zFS 中建立目錄結構,包括 Web 應用程式的 server.xml 檔及 dropins 目錄。您可以按一下,以檢查 JVM 伺服器的狀態。
- 按一下,以開啟「組合定義」視圖。 此視圖會列出 CICS 區域的所有組合定義。
- 安裝範例群組 DFH$WLP 中的範例組合資源定義。 CICS Hello World 範例需要範例組合資源定義 WLPHELLO。CICS 暫時儲存體佇列 (TSQ) 範例需要 WLPTSQ。JDBC 範例需要 WLPJDBC。範例定義會指定 /tmp/cicsts52 作為部署 CICS 組合的位置。
- 如果您配置了 cicsts:security-1.0 特性,或正在使用自動配置,請確保您還配置了所需的安全規則。請參閱配置 Liberty JVM 伺服器的安全。
- 選擇性的: 您可能要變更所提供的範例。如果先前已部署同一個範例,而現在正在重新部署,您必須停用再重新啟用組合,以執行新版的範例。
WAR 或 EBA 檔(視範例而定)會載入 Liberty 設定檔伺服器,且所有 OSGi 組合都登錄在 OSGi 架構中。
- 若要部署遵循 Liberty 部署模型的簡單範例,您必須在 CICS 中配置並啟用 JVM 伺服器。 啟用 JVM 伺服器會建立 dropins 目錄。
- 編輯 DFHWLP.jvmprofile,使用 -Dcom.ibm.cics.jvmserver.wlp.autoconfigure=true 系統內容來開啟自動配置。
- 在 CICSplex Explorer 視圖中,選取要執行 Servlet 範例的 CICS 區域。
- 安裝位於範例群組 DFH$WLP 中的 JVMSERVER 資源 DFHWLP。 範例資源會在 CICS 區域中建立 Liberty JVM 伺服器。
Liberty JVM 伺服器會在 zFS 中建立目錄結構,包括 Web 應用程式的 server.xml 檔及 dropins 目錄。您可以按一下,以檢查 JVM 伺服器的狀態。
- 在「資源」視景中,在動態 Web 專案上按一下滑鼠右鍵,以 WAR 或 EBA 檔形式將它匯出至本端工作站。
- 使用 FTP,以二進位模式將 WAR 或 EBA 檔複製到 dropins 目錄。
- 您可以編輯 server.xml 檔來變更主機名稱及埠號。
結果
您已將包含 Servlet 及 JSP 頁面的 Web 應用程式部署至 CICS 中執行的 Liberty JVM 伺服器,且已配置 Liberty JVM 伺服器來使用主機名稱及埠號。
下一步
您可以從 Web 瀏覽器存取 Web 應用程式,以檢查 Liberty JVM 伺服器的配置,如
執行 Servlet 範例中所述。