CICS 管理客户机接口

CICS ® 管理客户机接口 (CMCI) 是使用具象状态传输 (RESTful) 原则设计的系统管理应用程序编程接口，供包括 IBM® CICS Explorer在内的 HTTP 客户机应用程序使用。 您可以使用此接口来开发 HTTP 客户机应用程序，这些应用程序管理由 CICSPlex SM 管理的 CICS 区域上的已安装和定义的 CICS 和 CICSPlex ® SM 资源或独立 CICS 区域上的 CICS 资源。

客户机向 CICS 管理客户机接口发起 HTTP 请求。 如果接口确定请求有效，那么它会构造 CICSPlex SM API 命令，或者在独立 CICS 区域的情况下，构造 CICS 系统命令。 运行该命令后， CMCI 将创建 HTTP 响应。 如果请求成功，那么将采用 HTTP 200 (OK) 响应和包含结果集的 XML 订阅源的形式，该结果集将传递回客户机。 如果请求不成功，那么响应由包含失败详细信息的非 OK HTTP 响应代码组成。

CICS 管理客户机接口 HTTP 请求和响应的格式基于 HTTP/1.1 协议。 有关此协议的更多信息，请参阅 HTTP 协议 。

CICS 管理客户机接口请求采用 HTTP 头的形式，后跟 URI (通用资源标识) ，并在适当情况下采用 XML 主体，其中包含要对 CICS 或 CICSPlex SM 资源进行的任何更改的详细信息。

该头包含下列其中一种 HTTP 方法:
删除
从 CICSPlex SM 数据存储库中除去资源，从 CSD 中除去资源或废弃已安装的资源。
GET
检索有关 CICSPlex SM 数据存储库上的资源的信息，检索有关 CSD 上的资源的信息，或检索有关已安装资源的信息。
POST
在 CICSPlex SM 数据存储库上创建资源或在 CSD 中创建资源。
PUT
更新 CICSPlex SM 数据存储库中的现有资源，更新 CSD 中的现有资源，或者设置属性并对已安装的资源执行操作。 还对 CICSPlex SM 和 CSD 资源执行操作。

URI 包含 CICS 或 CICSPlex SM 资源的名称，并指定一系列参数，这些参数用于优化查询的作用域和性质，以标识指定资源的一个或多个实例。 在 GET 请求中， URI 还指定 API 是保留还是废弃一组结果。 如果 API 保留结果，那么新请求可以对保留的结果执行操作，而不必重复检索操作。 您还可以使用后续请求在一次选择一个或多个记录的保留结果中翻页。 有关保留结果集的更多信息，请参阅 使用保留结果集来提高 GET 请求的性能 。

POST 和 PUT 请求包含 XML 主体。 在 PUT 请求中，主体包含要对资源属性进行的更改的详细信息，或者包含要对目标资源执行的操作。 在 POST 请求中，主体包含要提供给新资源实例的属性值。

GET 和 DELETE 请求不需要 XML 主体。 如果 DELETE 请求需要其他参数，那么这些参数必须包含在 URI 中，并且可以选择添加到 XML 主体中。 例如，如果要删除 CSD 资源定义，那么必须在 URI 中包含 PARAMETER=CSDGROUP(csdgrp) ，并且可以选择将 <parameter name="CSD"/> 添加到 XML 主体。

您可以在 CICSPlex SM 环境或单个 CICS 区域 (SMSS) 中使用 CMCI。

如果将 CMCI 与 CICSPlex SM 配合使用，那么可以在 CICSPlex SM 管理的所有区域中管理定义，操作和 CSD 资源。

如果在独立 CICS 区域中使用 CMCI ，那么只能管理与该区域关联的操作资源和 CSD 资源。 如果在独立 CICS 区域中使用 CMCI ，那么会将上下文指定为该 CICS 区域的应用程序标识。