Using CMCI to perform actions on a resource definition

Perform actions on 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 .

About this task

Complete the following steps to perform actions on a resource definition using the CMCI:

Procedure

  1. Use a PUT request to perform actions on a resource definition.
    For more information about using HTTP PUT requests, see CICS management client interface PUT requests.
  2. Specify the URI for the request.
    If you are performing actions on a CSD resource, specify the SCOPE and PARAMETER=CSDGROUP in the URI.

    For more information about specifying the URI for a PUT request, see CICS management client interface PUT request URI.

  3. Add an XML body containing the parameters and attributes for the resource.
    The XML body comprises an <action name="action_name"> element inside a <request> element.
    If the action requires parameters, you must specify these in <parameter> elements inside the <action> element.
  4. Specify the action that you want to perform.
    Each resource table includes a list of the actions that you can perform. For more information, see the CICSPlex System Manager Resource Tables Reference Vol 1.

Example

The following example shows an INSTALL request that is applied to all BAS transaction definitions in the scope that have a name that starts with AA.
PUT http://exampledomain.com:12345/CICSSystemManagement/
    CICSDefinitionTransaction/<CONTEXT>/
    ?CRITERIA=NAME%3DAA*

<request>
   <action name="INSTALL">
      <parameter name="FORCEINS" value="NO"/>
      <parameter name="USAGE" value="LOCAL"/>
   </action>
</request>
The following example shows you what to specify for a CSDINSTALL action request. The parameters that you can specify for an action on a CSD resource are listed in the command description.
PUT http://exampledomain.com:12345/CICSSystemManagement/
    CICSDefinitionTransaction/<CONTEXT>/<SCOPE>/
    ?CRITERIA=NAME%3DAA*&PARAMETER=CSDGROUP%28group%29 

<request>
   <action name="CSDINSTALL">
   </action>
</request>