當您針對應用程式的元件來變更 CICS® 組合時,請更新 CICS 組合、應用程式組合以及應用程式連結的版本,並在平台上部署新版本。
開始之前
當您更新部署在平台上的應用程式時,從您在 CICSPlex 中停用並捨棄舊版應用程式的已安裝 APPLCTN 資源開始,到您安裝新的 APPLDEF 資源定義並啟用新版本的應用程式為止,使用者都無法使用該應用程式。請計劃可安全發生此狀況的適當時間,或者計劃一個替代方案,供應用程式的使用者在該期間使用。
若要更新應用程式,您需要編輯應用程式專案及應用程式連結專案。如果您沒有已版本化的備份系統可讓您回復到舊版的專案,您可能偏好將現有的專案複製到另一個專案,然後編輯新的副本,而非如這些指示所述,直接編輯現有專案。
關於這項作業
您可使用版本控制來管理對應用程式的變更。
每一個 CICS 組合、應用程式組合及應用程式連結都有一個 ID 及版本資訊來進行唯一識別。版本會使用主要、次要及微 ID,因此您可以指出變更的重要性,以及管理組合之間的相依關係。此概念稱為語意版本化,取自 OSGi Alliance。雖然其著重於 Java™ 套件,但是一般而言,您可以將相同的原則套用至組合。
語意版本化提供一個方法來增加版本的主要、次要或微部分,以指出與舊版組合的相容性或不相容性。例如,錯誤修正程式可能會增加版本的微部分,相容的變更會增加版本的次要部分,以及不相容的變更會增加版本的主要部分。如需語意版本化的相關資訊,請參閱語意版本化技術白皮書。
您必須將版本化原則套用至您的 CICS 組合及管理組合,才能部署及管理 CICS 環境中的更新。您不能使用現有版本的應用程式組合來安裝應用程式的新版本 CICS 組合,也不能搭配使用現有版本的應用程式連結與新版本的應用程式組合。每當您更新應用程式的 CICS 組合時,就必須更新應用程式組合及應用程式連結。
當您變更管理組合的版本時,根據語意版本化的原則,新版本應該反映包括在管理組合的 CICS 組合中的最大變更。例如,您可能將應用程式的一個 CICS 組合從 1.0.1 版變更成 1.0.2 版(此為微版本變更),並將應用程式的另一個 CICS 組合從 1.2.0 版變更成 1.3.0 版(此為次要版本變更)。因此,包括這兩個 CICS 組合的應用程式組合應該有次要版本變更,這樣一來,如果應用程式組合先前為 2.5.1 版,則應該變更成 2.6.0 版。
程序
- 按一下,以開啟「專案瀏覽器」視圖。
- 尋找應用程式專案、展開應用程式專案的 META-INF 資料夾,然後按兩下 application.xml 檔案或 bundles.xml 檔案。 即會開啟應用程式編輯器。如需使用應用程式編輯器的指引,請參閱應用程式編輯器。
提示: 如果 CICS Explorer® 在應用程式組合的 XML 檔案中找到錯誤,或另一個重要問題,則會在「問題」視圖中顯示錯誤或問題的相關資訊。
- 若要在應用程式組合中包括進一步的 CICS 組合,請按一下新增。 從工作區中可用的 CICS 組合清單中,選取適當的 CICS 組合。
- 若要移除目前包括在應用程式組合中的 CICS 組合,請選取 CICS 組合,然後按一下移除。
- 若要編輯內含在應用程式組合中的任何 CICS 組合,請在應用程式編輯器中的清單上按兩下 CICS 組合的名稱,以開啟組合資訊清單編輯器。
- 使用組合資訊清單編輯器來新增或移除 CICS 組合的相依關係、建立新的應用程式進入點,以及定義原則範圍。
- 若要編輯定義在 CICS 組合中的資源,請使用資源編輯器,如編輯 CICS 組合專案中所定義的資源中所述。
- 更新 CICS 組合之後,請使用組合資訊清單編輯器,根據您的版本化原則,增加 CICS 組合的主要、次要或微版本號碼,然後儲存變更。
- 從應用程式組合中移除舊版本的 CICS 組合,方法是在應用程式編輯器中,選取該 CICS 組合,然後按一下移除。 更新 CICS 組合的版本號碼時,CICS Explorer 會在應用程式編輯器中標示舊版本有錯誤。
- 在應用程式編輯器中按一下新增,然後從工作區中可用的 CICS 組合清單中,選取新版本的 CICS 組合,即可在應用程式組合中包括已更新的 CICS 組合。
- 若要編輯應用程式的任何進入點,請在應用程式編輯器中的清單上按兩下應用程式進入點的名稱,以開啟組合資訊清單編輯器。 更新應用程式進入點之後,請使用組合資訊清單編輯器,根據您的版本化原則,增加 CICS 組合的主要、次要或微版本號碼,然後儲存變更。 將包含應用程式進入點的已更新 CICS 組合包括在應用程式組合中,然後移除舊版本。
- 完成應用程式的更新之後,請使用應用程式編輯器中的版本欄位,根據您的版本化原則,增加應用程式的主要、次要或微版本號碼,然後儲存變更。
- 接下來,您可以更新現有的應用程式連結以指定新版本的應用程式,或者為新版本的應用程式建立新應用程式連結。
- 若要為新版本的應用程式建立新應用程式連結,請在應用程式編輯器中按一下建立應用程式連結,以開啟應用程式連結精靈,然後遵循精靈中的步驟。
- 若要更新現有的應用程式連結,請在「專案瀏覽器」視圖中,尋找應用程式的現有應用程式連結、展開應用程式連結專案的 META-INF 資料夾,然後按兩下 application.xml、bundles.xml 或 deployment.xml 檔案。即會開啟應用程式連結編輯器。如需使用應用程式連結編輯器的指引,請參閱應用程式連結編輯器。
- 在應用程式連結編輯器中,按一下依應用程式名稱瀏覽,然後選取新版本的應用程式。
- 對與應用程式連結一起部署的 CICS 組合,進行任何所需的變更。
- 按一下新增或移除,以變更選擇要與應用程式連結一起部署的 CICS 組合。
- 按兩下任何 CICS 組合,以進行編輯。利用針對應用程式之 CICS 組合的 5 中所述的相同方法,更新及回復 CICS 組合,以及新增版本至應用程式連結。
- 若要編輯與應用程式連結一起部署的任何原則,請在應用程式編輯器中的清單上按兩下原則的名稱,以開啟組合資訊清單編輯器。 更新原則之後,請使用組合資訊清單編輯器,根據您的版本化原則,增加 CICS 組合的主要、次要或微版本號碼,然後儲存變更。 將包含原則的已更新 CICS 組合包括在應用程式連結中,然後移除舊版本。
- 在應用程式連結編輯器的部署標籤上,檢查應用程式的每一個 CICS 組合,以及與應用程式連結一起部署的每一個 CICS 組合,是否都連結至適當的區域類型。 使用切換按鈕
在處理區域類型及處理 CICS 組合之間進行切換。- 尚未連結至任何區域類型的任何 CICS 組合都會標示字母 X。使用 CICS 組合,選取每一個新的 CICS 組合,並使用勾選框來指定要將該組合部署至哪些區域類型。
- 如果應用程式連結中已指定任何區域類型,但是在與該應用程式連結相關聯的現行版本「平台」專案中找不到那些區域類型,則它們會標示驚嘆號。請檢查您是否使用正確版本的「平台」專案。如果您已從平台中移除區域類型,或者已變更成不包括區域類型的平台,則請清除應用程式連結專案。使用區域類型,選取每一個不想要的區域類型,然後取消勾選針對該區域類型所指定的所有 CICS 組合。
- 完成應用程式連結的更新之後,請使用應用程式連結編輯器中的版本欄位,根據您的版本化原則,增加應用程式連結的主要、次要或微版本號碼,然後儲存變更。
提示: 應用程式連結的版本號碼不需要與應用程式的版本號碼相同。然而,根據語意版本化的原則,您應該更新應用程式連結的版本號碼,以反映應用程式中的最大變更,或者與應用程式連結一起部署之 CICS 組合中的最大變更。
- 在應用程式編輯器或應用程式連結編輯器中,按一下匯出精靈,以將已更新的應用程式及應用程式連結部署至 z/OS® UNIX 上的平台起始目錄。 新的版本號碼會用作目錄名稱的一部分,因此,舊版的應用程式及應用程式組合會保留在平台起始目錄中。
- 建立新的 APPLDEF 資源定義,以指向已更新的應用程式目錄。 若要在匯出程序期間建立 APPLDEF 資源定義,請在匯出精靈中選取勾選框。
- 停用並捨棄代表舊版應用程式的已安裝 APPLCTN 資源。
- 安裝新的 APPLDEF 資源定義。
結果
新版本的應用程式即會部署在平台上。
包括在新版本應用程式組合中的 CICS 組合會安裝在適當的 CICS 區域中,且定義在 CICS 組合內的資源會動態建立在 CICS 區域中。