CMCI DELETE 请求数

CICS® 管理客户机接口 (CMCI) 使用 HTTP DELETE 方法从数据存储库中除去资源，或者从 CICS 或 CICSPlex ® SM 中废弃已安装的资源。

客户机使用由以下部分组成的 HTTP 头来构成 DELETE 请求:
  • 方法名称，在本例中为 DELETE
  • 标识要删除的资源的 URI
  • HTTP 版本
  • 授权凭证 (如果需要)

DELETE 请求可以对已安装的资源或定义的资源执行操作。 该接口在对操作资源执行操作时构造 CICS DISCARD 命令，在对定义资源执行操作时构造 CICSPlex SM REMOVE 命令。

例如，要删除 CICSplex PLEX1 中具有以 TR 开头的名称和以 P 开头的程序的所有事务定义，客户机将构造以下 HTTP 头:
DELETE /CICSSystemManagement/CICSDefinitionTransaction/PLEX1?CRITERIA=NAME%3DTR%2A%20
AND%20PROGRAM%3DP%2A HTTP/1.1
Host: example.com:23792
Authorization: Basic RlJFRDpQQVNTVzBSRA==
初始行有三个部分，用空格分隔:
  • 方法名称

  • 请求 URI ，指定为绝对路径，以 /CICSSystemManagement/ 开头，后跟外部名称，该外部名称用于标识资源以及用于确定要删除该资源的哪些实例的参数和过滤器。 为了使 URI 适合由 CICS 管理客户机接口处理，客户机会将某些受限字符 (例如，空格和星号) 替换为转义序列。

    请参阅 CMCI DELETE 请求 URI 以获取 DELETE 请求 URI 的详细描述。

  • HTTP 版本，在连接到 CICS 管理客户机接口时，始终为 HTTP/1.1

第二行标识以 URI 中指定的冒号分隔的目标系统的主机名和端口号。 此行以回车符结尾，后跟换行符。

可选的第三行包含授权凭证。 如果系统正在使用 CICS 系统初始化参数 SEC 作为 YES运行，那么必须在基本认证头中提供 base-64 中的用户标识和密码。 在此示例中，用户标识为 李华明 ，密码为 PASSWORD。

然后，通过最终回车符和换行符在单独一行上最终确定 HTTP 头。

对 DELETE 请求的响应

DELETE 请求完成后，客户机将接收来自 CMCI 的响应，该响应由 HTTP 头和包含已删除资源的结果摘要和详细信息的 XML 订阅源组成。

头由 HTTP 响应代码，日期和时间以及服务器和内容类型的详细信息组成。 以下示例显示了成功 DELETE 请求的头:
HTTP/1.1 200 OK
Cache-Control: no-store
Date: Tue, 02 Jun 2009 14:51:37 GMT
Server: IBM_CICS_Transaction_Server/4.1.0(zOS)
Content-Type: application/xml; charset=UTF-8
Transfer-Encoding: chunked

请参阅 CICS 管理客户机接口错误消息 以获取所有响应代码的描述。

The body of the response consists of a <response> root element containing a <resultsummary> element displaying summarized information about the request, for example:
<response xmlns="http://www.ibm.com/xmlns/prod/CICS/smw2int" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.ibm.com/xmlns/prod/CICS/smw2int 
http://example.com:30061/CICSSystemManagement/schema/CICSSystemManagement.xsd" version="1.0" 
connect_version="0410">
<resultsummary api_response1="1024" api_response1_alt="OK"
api_response2="0" api_response2_alt="" recordcount="1" successcount="1" />
</response>

请参阅 <response> element ，以获取有关 DELETE 请求响应中的 XML 元素的更多信息。

安全注意事项

使用 HTTP 方法时，请注意，出于安全考虑，某些防火墙不允许 HTTP PUT 或 DELETE 流量通过防火墙。 为了适应此限制，您可以使用 CICS 管理客户机接口 POST 请求通过 POST 请求来隧道 DELETE 请求。 有关 CICS 管理客户机接口 POST 请求的更多信息，请参阅 CICS 管理客户机接口 POST 请求。