新增資源至 CICS 組合專案

當您新增資源定義至 CICS® 組合專案時,CICS 會在您於 CICS 區域中部署和安裝組合時,為您動態建立資源。

開始之前

您必須建立 CICS 組合專案,然後才能新增資源至其中。如需相關資訊,請參閱建立 CICS 組合專案

關於這項作業

CICS 資源的部分性質會變更,因為它們定義在 CICS 組合中,並動態建立為組合部署的一部分。若沒有 BUNDLE 資源,無法管理以此方式建立的 CICS 資源的生命週期。它們必須透過 CICS 組合來管理。由於組合與資源的生命週期是相互依存的,因此應用程式架構設計者必須仔細考量,哪一組應用程式資源的生命週期應與 CICS 組合的生命週期產生關聯。若要深入瞭解定義 CICS 組合中資源的潛在含意,請參閱組合資源的性質

您可以參照應用程式組合中的一個或多個 CICS 組合。以此方法包裝應用程式,即可將應用程式及其組合當作單一實體部署至 CICS 中,以更輕鬆地在 CICS 中更新及管理應用程式。如果 CICS 組合僅包含可使用多重版本管理的資源,便可由多個應用程式安裝在 CICS 區域中。

部署在使用以專用資源形式受到支援之 CICS 資源平台上的應用程式,結合針對應用程式而設計的其他資源和匯入的資源,均可使用多重版本管理。多重版本管理的應用程式中可納入下列資源:
  • 屬於應用程式的 CICS 組合中所定義的 PROGRAM 資源
  • 屬於應用程式的 CICS 組合中所定義的 LIBRARY 資源
  • 原則
  • 應用程式進入點的陳述式
  • 任何定義為應用程式的相依關係或匯入項目的資源

包含其他資源類型的 CICS 組合,無法納入至已在平台的相同 CICS 區域中安裝的其他應用程式,且若已針對應用程式而安裝,則無法新增至平台。如果您的應用程式所需的某項資源不支援多重版本管理,且已有安裝在平台的目標區域類型中的 CICS 組合使用該項資源,請建立新的 CICS 組合專案。在資訊清單檔中指定匯入,將資源宣告為新 CICS 組合的相依關係。然後,將新的 CICS 組合專案併入您的應用程式專案中。如需將資源宣告為相依關係的指示,請參閱定義組合相依關係

當您在 CICS 組合中定義 TRANSACTION 資源,並將 CICS 組合部署為應用程式的一部分時,或是將 CICS 組合新增至平台時,不支援自動安裝交易的起始程式。 若為在部署為應用程式一部分的 CICS 組合中定義的 TRANSACTION 資源,您必須將該交易之起始程式的 PROGRAM 資源,定義並部署為同一個應用程式的一部分。若為隨平台部署的 CICS 組合中定義的 TRANSACTION 資源,您必須以下列其中一種方式來定義並部署該交易之起始程式的 PROGRAM 資源:
  • 在隨平台部署的 CICS 組合中。
  • 作為在平台上部署之應用程式的一部分。
  • 在屬於平台一部分的 CICS 區域中(使用獨立式 CICS 組合、CICS CSD 或 CICSPlex® SM 資料儲存庫)。

若要在 CICS 組合專案中定義資源,請遵循下列步驟:

程序

  1. 在「專案瀏覽器」視圖中,用滑鼠右鍵按一下 CICS 組合專案,然後按一下新建
  2. 從功能表中選取您要新增的資源,例如程式、檔案庫、交易或 URI 對映定義。
    提示: CICS 組合支援大小寫混合的資源名稱,因為 CICS 中支援這些資源。不過,您的檔案系統可能不容許名稱相同但大小寫不同的檔案位於相同的 CICS 組合專案中。如果您需要使用不同大小寫的重複資源名稱,請在個別 CICS 組合專案中定義這些資源。
  3. 完成精靈中的必要欄位。
    1. 對於 CICS 資源的子集,如果資源是應用程式的進入點,則您可以新增應用程式作業。
    2. 對於 JVM 伺服器,您可以選擇使用其中一個提供的範本(OSGi、Axis2 或 Liberty)來建立 JVM 設定檔,或使用 CICS 組合中的現有 JVM 設定檔,或者從工作區中的其他位置或從本端檔案系統,將現有 JVM 設定檔匯入至 CICS 組合。完成精靈之後,請依照編輯 CICS 組合專案中所定義的資源中的指示編輯 JVM 設定檔,以符合您的系統需求。
    3. 對於管線,您可以選擇使用 CICS 提供的其中一個範例管線配置檔來建立管線配置檔,或者從本端檔案系統或本端工作區匯入現有的配置檔。完成精靈之後,請依照編輯 CICS 組合專案中所定義的資源中的指示編輯管線配置檔,以新增要在納入此配置檔中的訊息處理程式、標頭處理程式和應用程式處理程式。
    4. 對於 Web 服務,您可以從本端檔案系統或本端工作區匯入 Web 服務連結檔,以建立 WEBSERVICE 定義。您可以選擇匯入要包裝在組合中的 WSDL 文件或 WSDL 保存檔,而對於服務提供者,您可以選取要在組合中納入 PROGRAM 定義的勾選框。 請注意,Web 服務會以不需要完整驗證 SOAP 訊息的預設值建立,但是您可以在安裝資源後,在資源編輯器中或 CICS 中變更此設定。
    5. 建立 WEBSERVICE 定義後,您可以用滑鼠右鍵按一下該定義並啟動精靈,以產生用於 Web 服務的 URIMAP 定義,並建立別名交易:
      • URIMAP 的路徑會根據 Web 服務連結檔預先填入,但您可以視需要輸入不同的路徑。
      • URIMAP 的主機名稱和埠號會根據 Web 服務連結檔預先填入。如果無法擷取主機名稱,則 CICS Explorer 會顯示一則警告訊息,且您必須在主機欄位中輸入值。如果無法擷取埠號,則 CICS Explorer 會根據 URI 綱目提供預設值 80 或 443。
      • 預設別名交易為 CPIH,但您可以變更此交易,並可選取用以產生交易定義的勾選框。請注意,即使選取此勾選框,也不會為 CPIH 或 CPIQ 產生交易定義。以 C 開頭的其他交易名稱是保留給 CICS 的名稱。
      • 若要使 URIMAP 資源成為應用程式進入點,您可以開啟 CICS 組合資訊清單編輯器,並切換至進入點標籤,然後指定唯一作業名稱、URIMAP 資源類型和 URIMAP 資源名稱,以新增進入點。
    6. 對於 URIMAP 資源,您可以透過新建 URI 對映定義對話框來建立 URIMAP 配置檔。請指定主機、路徑,並選擇用法。
      • 對於使用 HFS 檔案提供靜態回應的 URIMAP 定義而言,該檔案必須連同 URIMAP 資源一起包裝在 CICS 組合中。指定相對於 CICS 組合之根目錄的相對檔案路徑。對於相對檔案路徑,請勿在路徑開頭處使用斜線。可以使用絕對路徑,但強烈建議不要這樣做。
      • 選取用法:
        • 若要為作為 HTTP 伺服器的 CICS 建立 URIMAP 定義,請選取伺服器。此類型的 URIMAP 定義會用來將 Web 用戶端送入之 HTTP 要求的 URI 與 CICS 資源對映。可提供由應用程式產生的回應或靜態回應。
        • 若要為作為 HTTP 用戶端的 CICS 建立 URIMAP 定義,請選取用戶端。此類型的 URIMAP 定義會在 CICS 要求伺服器上的 HTTP 資源時使用,如此,您就無需在應用程式中識別 URI。
        • 若要建立 Web 服務的 URIMAP 定義,請選取管線。此類型的 URIMAP 定義會用於進入的 Web 服務要求;也就是用戶端據以呼叫 CICS 中之 Web 服務的要求。送入要求的 URI 會與 WEBSERVICE 和 PIPELINE 資源產生關聯;這些資源會指定要對訊息執行的處理。
        • 若要建立 Atom 資訊來源的 URIMAP 定義,請選取 Atom。此類型的 URIMAP 定義可用於 CICS 以 Atom 資訊來源形式供使用之資料的送入要求。URIMAP 定義會將要求 URI 與定義 Atom 文件的 ATOMSERVICE 資源定義對映。
        • 若要為在 JVM 伺服器中執行的 Web 應用程式建立 URIMAP,請選取 JVM 伺服器。此類型的 URIMAP 會用來將送入的應用程式要求與 CICS 交易對映。如果沒有任何 URIMAP 符合送入要求的 URI,則 CICS 會使用 CJSA 交易。
        • 若要配置 URIMAP 以提供靜態回應,請選取檔案,然後選取 HFS 檔案範本名稱。用法屬性會設為 USAGE(SERVER)。
      • 若要讓 URIMAP 資源成為應用程式進入點,請選取建立應用程式進入點勾選框,並輸入唯一的作業名稱。或者,您可以開啟 CICS 組合資訊清單編輯器,並切換至進入點標籤,然後指定唯一作業名稱、URIMAP 資源類型和 URIMAP 資源名稱,以新增進入點。
  4. 按一下完成
  5. 如果您想要在建立資源之後立即檢視並編輯其屬性,請選取開啟編輯器勾選框,以在您完成精靈後開啟資源編輯器。 如果您想要在稍後執行此動作,則可以從「專案瀏覽器」視圖中開啟資源編輯器。

結果

資源定義會建立在 CICS 組合專案中,而且組合資訊清單會更新。

下一步

若要在資源編輯器中編輯資源,請遵循編輯 CICS 組合專案中所定義的資源中的指示。

當完成了您的資源定義時,您可以將 CICS 組合專案部署至 zFS,或包裝組合以搭配應用程式或平台組合進行部署。如需相關資訊,請參閱部署 CICS 組合