定義應用程式進入點

如果您的 CICS® 組合專案是 CICS 應用程式的一部分,則您可以在組合資訊清單中宣告適用的應用程式進入點。應用程式進入點可識別身為應用程式存取點的資源。應用程式進入點可用來控制使用者對平台上部署之不同應用程式版本的存取。

開始之前

您必須在「專案瀏覽器」視圖中具有 CICS 組合專案。

關於這項作業

PROGRAM 和 URIMAP 資源可被識別為應用程式進入點。

對於部署在平台上的應用程式,應用程式進入點可控制使用者對不同應用程式版本的存取。應用程式進入點可設定成讓使用者可使用或無法使用。您可以在任何方便的時間在平台的 CICS 區域內安裝應用程式及其資源,然後啟用 CICS 組合以驗證安裝。當您選擇將應用程式版本提供給使用者時,應用程式進入點及其為應用程式控制的資源即可供呼叫者使用。

每一個應用程式進入點都會在資源上宣告,並指定一項作業。例如,您可以宣告在應用程式中進行建立、讀取、更新或刪除作業的應用程式進入點。
  • 應用程式的一項資源只能宣告為應用程式進入點一次,並指定一項作業。您無法對相同的資源宣告多個應用程式進入點。
  • 作業名稱在應用程式中必須是唯一的。
  • 作業名稱須區分大小寫,因此您可以使用只有大小寫不同的作業名稱。

應用程式進入點的資源不必定義在與應用程式進入點相同的 CICS 組合中。CICS 會在應用程式安裝時,新增應用程式作業至指定的資源。對於宣告為應用程式進入點的 PROGRAM 資源,無論 PROGRAM 資源位於何處,應用程式進入點都會控制使用者對此程式的存取。但對於宣告為應用程式進入點的 URIMAP 資源,則只有在定義 URIMAP 資源的 CICS 組合中宣告該 URIMAP 資源時,應用程式進入點才會控制對該資源的存取。

您可以為未定義於任何 CICS 組合中、但已存在於即將部署該組合的 CICS 區域中的資源,宣告應用程式進入點。您也可以為可在即將部署組合的 CICS 區域中自動安裝的 PROGRAM 資源,宣告應用程式進入點。安裝應用程式時,如果應用程式進入點的目標資源不存在而無法自動安裝,則包含應用程式進入點之宣告的 CICS 組合就不會安裝,並且會標示警告。

作為平台組合的一部分進行安裝或新增至執行中平台的 CICS 組合,在其組合資訊清單中不可包含應用程式進入點的宣告。直接安裝在平台上的 CICS 組合不支援應用程式進入點,且在此情況下,即使已安裝 CICS 組合及其資源,CICS 也不會啟用應用程式進入點。直接安裝在 CICS 區域內的獨立式 CICS 組合可包含應用程式進入點的宣告,以啟用區域層次原則的範圍設定。

應用程式進入點只會控制使用者對應用程式進入點中指定之資源的存取。如果應用程式包含任何未指定為應用程式進入點的公用資源,則在安裝並啟用應用程式時,無論應用程式的可用性狀態如何,這些資源均可由安裝在平台上或 CICS 區域中的其他應用程式存取。應用程式版本的專用資源無法由其他應用程式存取。

定義為應用程式進入點的程式,在您的環境中必須具有唯一的 PROGRAM 資源名稱。這些程式必須是公用資源,才可從應用程式外部呼叫。當您啟用包含專用 PROGRAM 資源之應用程式進入點的應用程式時,指定為應用程式進入點的 PROGRAM 資源將會從專用資源變更為公用資源。因此,PROGRAM 資源可與 CICS 區域中安裝的公用程式同名,或者與其他已安裝的應用程式定義為應用程式進入點的公用程式同名。定義為應用程式進入點的相同程式的多個版本可被載入,以用於相同應用程式的多個版本。

在 CICS 組合中定義 URIMAP 資源時,您可以使用應用程式進入點宣告來控制使用者對 URIMAP 資源所提供之服務的存取。若要使用此功能,請在相同的 CICS 組合中宣告應用程式進入點及定義 URIMAP 資源。在此情況下,當您安裝並啟用應用程式時,由 URIMAP 資源提供的服務尚無法供呼叫者使用。當您選擇將服務提供給使用者時,您會使用 CICS Explorer® 或 EXEC CICS SET BUNDLE 指令,將包含應用程式進入點和 URIMAP 資源的 CICS 組合設為可供使用。此動作將使應用程式進入點以及 URIMAP 資源所提供的服務可供呼叫者使用。

如果您不想讓應用程式進入點控制對 URIMAP 資源所提供之服務的存取,請在不同的 CICS 組合中宣告應用程式進入點及定義 URIMAP 資源。您也可以將 URIMAP 資源宣告為應用程式進入點,該資源於應用程式外部定義並宣告為應用程式的相依關係或匯入項目。在上述任一情況下,只要您安裝並啟用 URIMAP 資源,服務即可供使用者使用。

程序

  1. 展開 CICS 組合專案和 META-INF 資料夾。
  2. 開啟 cics.xml 檔案,以檢視 CICS 組合資訊清單編輯器。
  3. 按一下「進入點」標籤,以開啟組合的應用程式進入點清單。
  4. 按一下新增,以定義應用程式的應用程式進入點。 建立應用程式進入點對話框即會顯示。
    1. 輸入應用程式作業的名稱。 作業名稱須區分大小寫。此名稱可包含字元 a-z、A-Z、0-9._#@-,且最多可包含 64 個字元。 請確定作業名稱在您的應用程式中是唯一的。應用程式若包含重複的作業名稱,則無法設為可供使用。
    2. 選取資源類型。
    3. 輸入 CICS 資源的名稱。
  5. 按一下確定以儲存應用程式進入點。

結果

除了可控制使用者對不同應用程式版本的存取外,應用程式進入點也可用來建立作業的應用程式環境定義。當部署應用程式時,會將作業名稱新增至指定的資源,並為使用資源的作業產生應用程式環境定義資料。

當作業呼叫具有應用程式進入點的資源時,CICS 會建立一個應用程式環境定義,而這會成為與作業相關聯,以及與作業呼叫的任何後續程式和其啟動的作業相關聯的起始應用程式環境定義。應用程式環境定義會識別平台、應用程式、應用程式版本和作業。如果作業已具有應用程式環境定義,那麼這將成為現行應用程式環境定義,儘管呼叫作業的應用程式環境定義可用來監視原則及設定其範圍。應用程式環境定義資料可用於下列用途:
  • 起始應用程式環境定義可用來監視及測量應用程式或特定應用程式作業在多個 CICS 區域和多個作業中使用了多少資源。
  • 起始應用程式環境定義可將原則套用至屬於應用程式的作業,以定義用來管理作業行為的臨界條件。
  • 起始或現行應用程式環境定義可與 CICS Explorer 中的交易追蹤功能搭配使用,以快速識別並診斷應用程式相關問題。