Create an API to invoke the IBM MQ stock query service

Create a stock manager API that calls the IBM MQ stock query application.

1. Start IBM® Explorer for z/OS and open the z/OS Connect (OpenAPI 2) perspective.
2. From the main menu, click File > New > z/OS Connect API Project
   
3. Complete the sections for the new API project and click Finish.
   The IBM z/OS Connect API editor opens.

   
4. Change the value of the path attribute to /stock/items/{item-id}, where {item-id} indicates a path parameter whose value is substituted at runtime.
   For the moment, you use the HTTP GET method of the service only to make stock queries. Delete the other three methods and save the API.

   
5. Import the service archive file that you created in the task Create a two-way IBM MQ service.
   Click Service..., select File System, and find the C:\sars directory and select stockQuery.sar.

   
6. Click Open, OK, OK, and Save.
   The HTTP GET method is now associated with the stockQuery service.
7. Click Mapping... and select Open Both Mappings.
   The Service Interface Mapping editor opens.

   
8. Explore the contents of the Response Mapping editor.
   For this scenario, use the default mapping, which passes the response without modification from the service back to the caller of the API. When you finish exploring, close the Response Mapping editor.
9. Use the Request editor to map the item-id path parameter that you created in step 4 to the item-id in the payload.
   This mapping creates a more natural REST API where the caller of the API will not need to pass any payload in the HTTP GET request.
   1. Left-click and hold on the item-id path parameter, then drag to the item_id integer on the right.
      
   2. Save your changes.