新增資源至 CICS 組合專案

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

開始之前

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

關於這項作業

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

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

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

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

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

程序

  1. 在「專案瀏覽器」視圖中,用滑鼠右鍵按一下 CICS 組合專案,然後按一下新建
  2. 從功能表中選取您要新增的資源,例如程式、檔案庫、交易或 URI 對映定義。
    提示: CICS 組合支援大小寫混合的資源名稱,因為 CICS 中支援這些資源。不過,您的檔案系統可能不容許名稱相同但大小寫不同的檔案位於相同的 CICS 組合專案中。如果您需要使用不同大小寫的重複資源名稱,請在個別 CICS 組合專案中定義這些資源。
  3. 完成精靈中的必要欄位。
    1. 對於 CICS 資源的子集,如果資源是應用程式的進入點,則您可以新增應用程式作業。
    2. 對於 JVM 伺服器,您可以選擇使用其中一個提供的範本(OSGi、Axis2 或 Liberty)來建立 JVM 設定檔,或使用 CICS 組合中的現有 JVM 設定檔,或者從工作區中的其他位置或從本端檔案系統,將現有 JVM 設定檔匯入至 CICS 組合。儲存 JVM 設定檔的目錄,其目錄名稱限制為 240 個字元,相同的限制也適用於未定義在 CICS 組合中的 JVM 設定檔。完成精靈之後,請依照編輯 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 TS 5.4.0 版產品說明文件)
      • 若要讓 URIMAP 資源成為應用程式進入點,請選取建立應用程式進入點勾選框,並輸入唯一的作業名稱。或者,您可以開啟 CICS 組合資訊清單編輯器,並切換至進入點標籤,然後指定唯一作業名稱、URIMAP 資源類型和 URIMAP 資源名稱,以新增進入點。
  4. 按一下完成
  5. 如果您想要在建立資源之後立即檢視並編輯其屬性,請選取開啟編輯器勾選框,以在您完成精靈後開啟資源編輯器。 如果您想要在稍後執行此動作,則可以從「專案瀏覽器」視圖中開啟資源編輯器。

結果

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

下一步

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

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