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

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.

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>


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