建立 CICS 平台專案

「CICS® 平台」專案會定義平台組合,這是一種說明平台的管理組合類型。平台組合指定平台的區域類型。

開始之前

在您建立 CICS 平台專案之前,請先在 zFS 中設定平台的平台起始目錄。最佳作法是使用預設平台起始目錄,也就是 /var/cicsts/CICSplex/platform1,其中 CICSplex 是將安裝平台的 CICSplex 名稱,platform1 是平台的名稱。如果您需要使用不同目錄作為平台起始目錄,您可以在建立 CICS 平台專案之後,使用平台編輯器來變更為替代目錄名稱。如需在 zFS 中建立平台起始目錄的指示,請參閱在 zFS 中建立平台起始目錄(CICS TS 5.2 版產品說明文件)

如果您要在平台的層次上部署 CICS 組合,您可以先建立組合,供您在建立 CICS 平台專案時新增。例如,您可以部署 CICS 組合,其中包含平台中所有 CICS 區域都需要的資源,或部署原則以適用部署在平台上的多個應用程式。如果您尚未對平台設定任何應用程式、資源或原則,您可以在建立平台之後將 CICS 組合新增至平台,或在部署之後隨時新增。如需建立 CICS 組合的指示,請參閱使用組合

關於這項作業

平台包含一個以上的區域類型。區域類型用於根據類型來分類和包含 CICS 區域。例如,處理 DB2® 連線的所有 CICS 區域可能屬於相同的群組。您可以在相同平台中的區域類型之間,或與其他平台中的區域類型之間,共用 CICS 區域。

您可以建立要用於平台的新區域類型。也可以選擇採用現有的 CICS 系統群組 (CSYSGRP) 作為平台中的區域類型。單一平台可以包含建立的區域類型及採用的區域類型。

建立的區域類型可以指定它們包含的 CICS 區域的內容。您可以指定區域類型層次的屬性,以複製某個區域類型中所有 CICS 區域的某些區域屬性值。只有定義中那些屬性具有相同指定值,或屬性沒有指定任何值的 CICS 區域,才可以成為該區域類型的一部分。您可以指定區域類型層次的下列區域屬性值:
適合作為遞送區域(WLMSTATUS 屬性)
當 CICS 區域啟動時,這個 CICS 區域是否會以遞送區域參與其關聯的工作量。
適合作為目標區域(DYNROUTE 屬性)
在 CICS 啟動時,這個 CICS 區域是否會當作目標區域作用,並接受其本身為目標之工作量的工作。
啟用 BAS 安裝(AUTOINST 屬性)
當 MAS 連接至 CMAS 時,透過資源說明與 CICS 區域相關聯的資源是否應自動安裝。
BAS 安裝失敗動作(AINSFAIL 屬性)
萬一發生 BAS 安裝失敗時所要採取的動作。
如果平台的架構需要某個區域類型中的所有 CICS 區域,都能在這些區域中有特定功能或限制,請指定區域類型層次的適當值。如果建立的區域類型對於屬性沒有任何特殊需求,請勿指定該屬性的任何值,這樣才能在 CICS 區域中接受任何設定。指定區域類型層次的區域屬性值時,該屬性值會被鎖定,且後續無法在屬於該區域類型的 CICS 區域中變更。
如果您要將現有 CICSPlex® SM 拓蹼重新實作為平台,您可以採用現有的 CICS 系統群組 (CSYSGRP) 作為採用的區域類型。您採用作為平台一部分的每一個 CSYSGRP 都必須符合下列需求:
  • 群組尚未被已安裝的平台所採用。如果群組已有相關聯的平台,則不能採用它來作為區域類型。
  • 群組不包含任何子群組。
  • 群組不需要修改(例如,內含在 WLM 或 RTA 中的群組)。平台需要鎖定作為區域類型的群組。
  • 群組中的所有 CICS 區域都必須指定 CICSPlex SM 系統參數 MASPLTWAIT(YES)。「商業應用程式服務」也需要 MASPLTWAIT(YES)。起始設定 CICS 區域時,需要此參數來自動安裝應用程式或平台的資源。
如果有 CICS 區域在不符合這些需求的 CSYSGRP 中,且您想要使用該 CICS 區域作為平台的一部分,則請將其系統定義 (CSYSDEF) 新增至您特別為平台所建立的新 CSYSGRP 中。

程序

  1. 從 CICS Explorer® 功能表列中,按一下檔案 > 新建精靈 > 其他,以開啟「新建專案」精靈。
  2. 展開 CICS 資源資料夾,按一下 CICS 平台專案,然後按下一步
  3. 專案名稱欄位中,輸入「CICS 平台」專案的名稱,並指定平台本身的名稱和說明。 專案位置指定「CICS 平台」專案在本端工作區中的儲存位置。 按下一步
  4. 按一下新增,將區域類型新增至平台。在名稱欄位中,輸入區域類型的名稱。新的區域類型可以是建立的區域類型,或是採用的區域類型。若要採用現有的 CICS 系統群組 (CSYSGRP) 作為採用的區域類型,您必須有 CICS SM 連線。
    • 對於已建立的區域類型,請按一下建立系統群組。在 ID 欄位中,為即將針對區域類型建立的 CICS 系統群組 (CSYSGRP),輸入不超過八個字元的名稱。
    • 對於採用的區域類型,請按一下使用現有的系統群組。選取現有的 CICS 系統群組 (CSYSGRP)(從它所在的 CICSplex 中)。
    按一下確定,將區域類型新增至平台。
  5. 請重複此步驟,以新增平台所需的其他任何建立的或採用的區域類型。 新增區域類型之後,您可以編輯其內容:區域類型的名稱及(僅限建立的區域類型)CSYSGRP 的 ID。您也可以移除誤加的任何區域類型。 完成指定平台的區域類型之後,請按下一步
  6. 選擇性的: 指定要隨平台部署的任何 CICS 組合。 系統會從您的本端工作區中,探索 CICS 組合的清單。選取適當的 CICS 組合,按下一步,然後指定將部署每一個 CICS 組合的區域類型。 如果您沒有任何可以隨平台部署的 CICS 組合,請跳過此階段。
    當您在 CICS 組合中定義 TRANSACTION 資源,並將 CICS 組合部署為應用程式的一部分時,或是將 CICS 組合新增至平台時,不支援自動安裝交易的起始程式。 若為隨平台部署的 CICS 組合中定義的 TRANSACTION 資源,您必須以下列其中一種方式來定義並部署該交易之起始程式的 PROGRAM 資源:
    • 在隨平台部署的 CICS 組合中。
    • 作為在平台上部署之應用程式的一部分。
    • 在屬於平台一部分的 CICS 區域中(使用獨立式 CICS 組合、CICS CSD 或 CICSPlex SM 資料儲存庫)。
  7. 按一下完成,以建立專案。如果您要部署 CICS 組合與平台,則必須先指定其部署範圍,才能按一下完成 即會建立「CICS 平台」專案,並顯示在 CICS Cloud 視景的「專案瀏覽器」視圖中。
  8. 使用 CICS Explorer 中的平台編輯器來編輯「CICS 平台」專案,以檢查並完成平台組合的規格。 建立平台專案之後,即會自動開啟平台編輯器。若要在稍後開啟平台編輯器,請按兩下平台組合的任何 .xml 檔,但 manifest.xml 檔除外。 如需使用平台編輯器的指引,請參閱平台編輯器
  9. 在平台編輯器的概觀標籤中,驗證或編輯平台的名稱及說明。如果您需要使用預設平台起始目錄以外的不同目錄,請按一下瀏覽,找出您已設定的起始目錄,並選取它作為平台起始目錄。
  10. 在平台編輯器的概觀標籤上,請在區域類型區域中驗證平台的區域類型,並視需要使用新增移除按鈕,新增或移除建立的或採用的區域類型。 若要新增採用的區域類型,您必須有 CICS SM 連線。 當平台已安裝且在作用中之後,您可以在區域類型中新增和移除個別的 CICS 區域。不過,您無法在已安裝的平台中修改區域類型,所以,在安裝平台之前,請先完成區域類型。
  11. 在平台編輯器的概觀標籤上,請在 CICS 組合區域中驗證要針對應用程式部署的 CICS 組合,並視需要使用新增移除按鈕,新增或移除組合。 若要編輯任何 CICS 組合,請按兩下組合名稱,在組合資訊清單編輯器中開啟它。 安裝平台之後,當您開發應用程式和原則時,您可以在平台層次上部署其他 CICS 組合。
  12. 在平台編輯器的區域類型標籤上,選取平台中每一個建立的區域類型,以檢視區域類型內容。在區域類型內容區域中,指定在區域類型的所有 CICS 區域中必須套用的任何必要設定。 只有可接受必要設定的 CICS 區域,才能成為該區域類型的一部分。如果建立的區域類型對於屬性沒有任何特殊需求,請勿指定該屬性的任何值,這樣才能在 CICS 區域中接受任何設定。
  13. 在平台編輯器的區域類型標籤中,選取平台中每一個建立的區域類型,然後按一下新增區域按鈕,針對將成為區域類型的 CICS 區域,新增一個以上 CICS 區域定義。 系統會為已建立的區域類型提供預設的 CICS 區域定義,您必須將其取代為區域類型中的 CICS 區域的實際定義。您可以選取預設 CICS 區域定義,並在區域內容區域中以您專屬的屬性來取代預設屬性。或者,您可以在建立的區域類型中,建立新的 CICS 區域定義,然後刪除預設的 CICS 區域定義。
    1. 區域內容區域中,針對新的 CICS 區域,指定 CICS 系統定義 (CSYSDEF) 的名稱(最多 8 個字元)。 CSYSDEF 名稱在 CICSplex 內必須是唯一的。
    2. CICS Explorer 會提供 APPLID 給新的 CICS 區域(符合您指定的名稱),這是最佳作法。APPLID 是交互通訊網路中用來識別 CICS 區域的名稱,也就是網路名稱。必要時請變更 APPLID,使其符合您專屬網路的需求。
    3. 指定 SYSID 給新的 CICS 區域。 SYSID(也稱為 SYSIDNT)是 1-4 個字元的名稱,可供其他 CICS 區域據以識別此 CICS 區域。
    4. 在平台中指定一個以上建立的區域類型,其中將會包括新的 CICS 區域。 如果您要在區域類型之間共用 CICS 區域,則您為這些區域類型指定的任何必要設定,都必須相符且不能有衝突。
    5. 選擇性的: 如果 CICS 區域是要使用 IPIC 系統鏈結 (SYSLINK) 來連接其他 CICS 區域,請指定 CICS 區域的字元主機名稱或 IPv4 或 IPv6 位址、網路 ID,以及出埠要求的埠號。 網路 ID 是 z/OS® Communications Server NETID。
    您無法使用平台編輯器在採用的區域類型中新增、移除或共用 CICS 區域。您只能在建立的區域類型中使用 CICS 區域定義。
  14. 在平台編輯器的部署標籤中,驗證或編輯每一個 CICS 組合都要針對應用程式部署的區域類型。
  15. 儲存「CICS 平台」專案。
    註: 建立「CICS 平台」專案後,您必須確保適當地管理工作區中建立的專案資料夾。您不能從 zFS 中匯出的資料重新建構「CICS 平台」專案,且工作站故障可能會造成資料流失。請確定您的專案已移入原始碼管理系統。當使用與 Eclipse 整合的原始碼管理系統時,您可以在您於 CICS Explorer 中工作時,移入和移出專案。

結果

「CICS 平台」專案的 META-INF 資料夾包含下列 XML 檔:
  • bundles.xml 說明隨平台部署的 CICS 組合。
  • deployment.xml 說明用來將 CICS 組合部署至平台的規則。
  • manifest.xml 是平台組合的資訊清單檔,並將其識別為 CICS 管理組合。
  • platform.xml 說明平台,包括其名稱、說明、區域類型及平台起始目錄。
  • regions.xml 說明專案中建立的 CICS 區域。
  • regionTypes.xml 包含每一個區域類型的 meta 資料,包括其名稱、說明、區域類型及系統群組的 ID。
  • regionTypeLinks.xml 說明建立的區域至區域類型的鏈結。

下一步

將專案匯出至 zFS,設定 CICS 區域,使其符合您在平台中的區域類型中所建立的每一個 CICS 區域定義,然後,將平台安裝在 CICSplex 中,讓它變成可用。請參閱部署 CICS 平台專案