<delete> element

The <delete> element contains details of a delete to be performed by a CICS® management client interface DELETE request on the resources specified by the URI.

Contained by

Contains

Typically a <delete> element does not contain any parameters, and therefore is not required.

If you are deleting a CSD definitional resource, you must include PARAMETER=CSDGROUP in the URI. You can also include <parameter name="CSD"/> in the XML body but this is not required. If you have specified PARAMETER=CSDGROUP in the URI and you do not specify <parameter name="CSD"/> in the XML body, CICS assumes that <parameter name="CSD"/> has been specified.

Examples

The following example shows a delete request for a BAS resource definition with the name ABCD. Only the URI is required for a delete request.
DELETE /CICSSystemManagement/<RESOURCE_NAME>/<CONTEXT>/?CRITERIA=NAME%3DABCD
The following example shows a delete request for a CSD resource definition. Notice that PARAMETER=CSDGROUP is contained in the URI.
DELETE /CICSSystemManagement/<RESOURCE_NAME>/<CONTEXT>/<SCOPE>?CRITERIA=NAME%3DABCD&PARAMETER=CSDGROUP%28GROUP1%29
The following example is equivalent to the previous one, the difference being that the optional <delete> element has been included in the XML body.
DELETE /CICSSystemManagement/<RESOURCE_NAME>/<CONTEXT>/<SCOPE>?CRITERIA=NAME%3DABCD&PARAMETER=CSDGROUP%28GROUP1%29

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