Using CMCI to delete a resource definition

Delete a BAS or CSD resource definition using the CICS® Management Client Interface (CMCI).

Before you begin

You must have a connection with the CMCI. For more information, see Setting up CMCI.

About this task

Use a DELETE request to delete a resource definition; specify the URI for the request, following the instructions in CMCI DELETE requests and CMCI DELETE request URI.

If you want to delete a resource that has parameters, you must specify the parameters for the resource in the URI.

Note:
  • If you are deleting a BAS resource, the SCOPE parameter, if specified in the URI, is ignored.
  • If you are deleting a CSD resource, you must specify the SCOPE and PARAMETER=CSDGROUP(value) in the URI.

    The SCOPE must be the CICS system from which you are deleting the resource. The CSDGROUP parameter is passed to instruct CICSPlex SM to search in the CSD groups in the specified system.

Optionally, you can specify the details of your request in the XML body; however, these details in the XML body are not required to perform a delete request. The XML body comprises a <delete> element inside a <request> element. Not all clients can parse the XML body; for that reason, you must add the parameter to the URI to specify which resource to delete.

Example

The following example shows how to delete a BAS transaction definition. In this example, all transactions named AAAA are deleted. 
DELETE http://exampledomain.com:12345/CICSSystemManagement/
       CICSDefinitionTransaction/?CRITERIA=NAME%3DAAAA
The following example shows how to delete a CSD transaction definition named TRN1 in CSD group GRP1 in a CICS system named MYREGION. A delete request does not require an XML body. Note that SCOPE specifies MYREGION and that PARAMETER=CSDGROUP(GRP1) is specified in the URI. 
DELETE http://exampledomain.com:12345/CICSSystemManagement/
       CICSDefinitionTransaction/<CONTEXT>/MYREGION/
       ?CRITERIA=NAME%3DTRN1&PARAMETER=CSDGROUP%28GRP1%29
The following delete request for the CSD transaction TRN1 includes an XML body; it is equivalent to the previous request.
DELETE http://exampledomain.com:12345/CICSSystemManagement/
       CICSDefinitionTransaction/<CONTEXT>/MYREGION/
        ?CRITERIA=NAME%3DTRN1&PARAMETER=CSDGROUP%28GRP1%29

<request>
   <delete>
      <parameter name="CSD"/>
   </delete>
</request>