Test the IPIC connection

You can test your connection to your CICS® region by invoking the catalog API directly from z/OS® Connect API toolkit by using the "Try it out!" function in the Swagger UI that is embedded in the editor.

Procedure

Start CICS and ensure that the TCPIPService is open.

Start your IBM® z/OS Connect server. For more information, see Starting and stopping IBM z/OS Connect.

Check the messages.log file for the following messages that confirm that the services are installed.

    BAQR7043I: z/OS Connect service archive placeOrder installed successfully.    
    BAQR7043I: z/OS Connect service archive inquireSingle installed successfully. 
    BAQR7043I: z/OS Connect service archive inquireCatalog installed successfully.

Check the messages.log file for the following message that confirms that the API is installed.
```
    BAQR7000I: z/OS Connect API archive file catalog installed successfully.
```

In the z/OS Connect Servers view under the APIs folder, double-click on the catalog API.
The API is opened in the Swagger UI.
Click List Operations to see available operations in the API.

Figure 1. Operations in the API
Test inquiring on an item by clicking GET /items/{itemID} .
1. Specify a value of 10 for the itemID.
  
  Figure 2. Testing the GET request
2. Click Try it out!.
  Information about the request URL, request headers, response body, response code, and response headers are provided. The response body contains the output message:
  - "CA_SNGL_DESCRIPTION": "Ball Pens Black 24pk"

Results

You have verified your IPIC connection to CICS is working.

What to do next

Follow the steps in Create a CICS service or Sample for creating a CICS service with a properties file to see how to create a service for yourself.