为 CMCI JVM 服务器 配置 CICS 捆绑程序部署应用程序接口

CICS 管理客户端接口 (CMCI) 支持通过 CICS 捆绑包部署 API 将 CICS® 捆绑包部署到区域中。 HTTP （包括 Gradle 或Maven插件）可以使用此API。 要使用 CICS 捆绑部署 API，系统程序员必须对 CMCI JVM 服务器执行额外的配置。

1. 通过在 CMCI JVM 服务器 的 JVM 配置文件中指定 bundles 目录（-Dcom.ibm.cics.jvmserver.cmci.bundles.dir）启用 CICS 捆绑程序集部署 API，也就是说，EYUCMCIJ.jvmprofile 用于 CICSplex 或 EYUSMSSJ.jvmprofile 用于单个 CICS 区域。
   添加以下行：

   -Dcom.ibm.cics.jvmserver.cmci.bundles.dir=<bundles_directory>

   提示：建议在 zFS 上创建一个目录，专门用于使用 API 管理捆绑包。 如果您要为多个单一 CICS 区域 (SMSS) 配置 API，建议您为每个区域创建一个单独的专用捆绑包目录。 推送到 CICS 捆绑部署 API 的捆绑包存储在 bundles 目录中，并由 CICS 目标区域访问。
2. 可选: 在 JVM 概要文件中，您还可以添加有关允许传递 API 的数据的规范。

   -Dcom.ibm.cics.jvmserver.cmci.deploy.timeout= {120000|timeout_limit}

   指定用于部署 CICS 束的超时限制 (以毫秒为单位)。 这包括所有捆绑软件生命周期操作（包括禁用、废弃、安装和启用）的时间。

   缺省值为 120000（120 秒）。

   -Dcom.ibm.cics.jvmserver.cmci.max.file.size= {52428800|max_file_size}

   指定上载的 CICS 束所允许的最大大小 (以字节为单位)。 缺省大小为 52428800 (50 MB)。

   如果任何上载的捆绑软件的大小大于此大小，那么您将收到 400 错误请求消息SRVE8021E: The file being uploaded is too large.

   -Dcom.ibm.cics.jvmserver.cmci.max.request.size= {104857600|max_request_size}

   指定多部分或表单数据请求允许的最大大小（字节）。 缺省大小为 104857600 (100 MB)。

   如果所有已上载文件的整体大小超过此阈值，那么 Web 容器将抛出异常。

3. 在 CLIST 中配置安全级别。

   如果使用 RACF，可以复制并更新 SEYUSAMP 中的示例 CLIST。 在 CICSPlex SM 或 EYU$BNDS forSMSS 中使用 EYU$BUND 样本。

   指定以下必需选项：

   表 1. CICS 捆绑部署 API 设置所需的 CLIST 选项

   必需选项	描述	适用于 CICSPlex SM (EYU$BUND)	适用于单个 CICS 区域 (EYU$BNDS)
   deploy_userid	有权部署捆绑软件的用户标识。 建议您为此目的创建功能标识（例如，DPLYUSR）。 或者，确保您的区域用户标识具有足够的权限，并指定它以代替功能标识。 该选项中指定的 ID 需要被授予访问 RACF® 中 DEPLOYER 子类别事务的权限。	✓	✓
   mngdbndl_access_list	可访问 CICS 捆绑程序部署 API 的用户组，例如 DEVELOPER。	✓	✓
   profile_prefix	包含 CMCI JVM 服务器的区域的 SAF 概要文件前缀，如 JVM 概要文件中所定义。	✓	✓
   区域用户标识	配置了 CMCI JVM 服务器的单个 CICS 区域的用户 ID。	不适用	✓
   wui_region_userid	使用 CMCI JVM 服务器配置的 CICSPlex SM WUI 区域的用户标识，例如 CICSRGN。	✓	不适用
   CMAS	授权 deploy_userid(通常是部署功能标识) 查询的 CMAS。	✓	不适用
   cicsplex	授权 deploy_userid(通常是部署功能标识) 向其查询和部署捆绑软件的 CICSplex。	✓	不适用
   region	授权 deploy_userid(通常是部署功能标识) 在指定 CICSplex 中查询和部署束的目标 CICS 区域。	✓	不适用

   以下选项是可选的。 如果未指定，那么将使用缺省值。

   表 2。 用于 CICS 捆绑部署 API 设置的可选 CLIST 选项

   可选 (非必需) 选项	描述	适用于 CICSPlex SM (EYU$BUND)	适用于单个 CICS 区域 (EYU$BNDS)
   命令类别	RACF 命令分组类的名称。 缺省值为 VCICSCMD。	不适用	✓
   资源类别	RACF 资源分组类的名称。 缺省值为 WCICSRES。	不适用	✓
   NOTIFY	发生访问违例时要通知的 TSO 用户标识。 缺省值为 IBMUSER。	✓	✓
   owner	概要文件所有者的 TSO 用户标识。 缺省值为 IBMUSER。	✓	✓

   然后，运行 CLIST。
4. 使用 UNIX 命令 chmod 或应用访问控制列表 (ACL)，让用户 ID 可以访问 zFS 上的 bundles 目录。 如需了解更多信息，请参阅为 z/OS UNIX 文件实施安全措施和让 CICS 区域访问 z/OS UNIX 目录和文件。
   • deploy_userid CLIST 选项中指定的用户 ID（通常是部署功能 ID）需要对 bundles 目录进行 READ、WRITE 和 EXECUTE 访问。
   • 目标 CICS 区域的区域用户标识需要对目录的 READ 和 EXECUTE 访问权。