Using CMCI to get a resource definition

Get or retrieve 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 GET request to retrieve a resource definition; specify the URI for the request, following the instructions in CICS management client interface GET requests and CICS management client interface GET request URI.

Note:

If you are requesting a BAS resource, the SCOPE parameter, if specified in the URI, is ignored.
If you are requesting 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 retrieving the resource. The CSDGROUP parameter is passed to instruct CICSPlex® SM to search in the CSD groups in the specified system.

Example

The following example shows how to retrieve a BAS transaction definition named TRN1.

GET http://exampledomain.com:12345/CICSSystemManagement/
    CICSDefinitionTransaction/<CONTEXT>/
    ?CRITERIA=NAME%3DTRN1

The following example shows a GET request to retrieve a CSD transaction definition named TRN2 that is installed in a CICS region named MYREGION. Note that SCOPE specifies MYREGION and that CSDGROUP(*) is specified in the URI.

GET http://exampledomain.com:12345/CICSSystemManagement/
    CICSDefinitionTransaction/<CONTEXT>/MYREGION/
    ?CRITERIA=NAME%3DTRN2&PARAMETER=CSDGROUP%28%2A%29