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 access for CICS Explorer.

About this task

Complete the following steps to delete a resource definition using the CMCI:

Procedure

  1. Use a DELETE request to delete a resource definition. For more information about DELETE requests, see CICS management client interface DELETE requests.
  2. Specify the URI for the request. If you are deleting a CSD resource, you must specify the SCOPE in the URI, unless you are working in a stand-alone CICS region. For more information about specifying the URI for a DELETE request, see CICS management client interface DELETE request URI.
  3. If you want to delete a resource that has parameters, you must specify the parameters for the resource in the URI.

    For example, if you want to delete a CSD resource, you must specify the CSDGROUP parameter in the URI PARAMETER=CSDGROUP(group).

  4. Optional: You can also specify the details of your request in the XML body. Note that these details are not required in the XML body 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 you what to specify to delete a BAS transaction definition. In this example, all resources named "AAAA" are deleted.
DELETE http://exampledomain.com:12345/CICSSystemManagement/
       CICSDefinitionTransaction/?CRITERIA=NAME%3DAAAA
A delete request for a CSD resource does not require an XML body.
DELETE http://exampledomain.com:12345/CICSSystemManagement/
       <RESOURCE_NAME>/<CONTEXT>/<SCOPE>/
       ?CRITERIA=NAME%3Dname&PARAMETER=CSDGROUP%28group%29
This delete request for a CSD resource that includes an XML body is equivalent to the previous request.
DELETE http://exampledomain.com:12345/CICSSystemManagement/
       <RESOURCE_NAME>/<CONTEXT>/<SCOPE>/
        ?CRITERIA=NAME%3Dname&PARAMETER=CSDGROUP%28group%29


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


deleteCSDresource.html | Timestamp icon Last updated: Monday, 5 June 2017