定义应用程序入口点

如果您的 CICS® 束项目属于 CICS 应用程序的一部分,请在束清单中声明合适的应用程序入口点。 应用程序入口点标识了作为应用程序访问点的资源。应用程序入口点用于控制用户对平台上所部署应用程序的不同版本的访问权。

开始之前

您在 Project Explorer 视图中必须具有一个 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 中的事务跟踪功能配合使用,以快速确定并诊断与应用程序相关的问题。