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

About this task

Use a GET request to retrieve a resource definition; specify the URI for the request, following the instructions in CMCI GET requests and CMCI 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