Create a CICS service
This scenario shows how you can recreate the CICS
inquireSingle service for the catalog manager example
application using the API toolkit.
To create and test the
Before you begin
inquireSingleservice ensure that the following tasks are complete:
- Install and configure the CICS catalog manager example application. The procedure is described in the scenario Prepare the sample CICS application
- Install IBM z/OS Connect v3.0 or later. For more information, see Installing IBM z/OS Connect.
- Configure and test your IPIC connection to CICS. The procedure is described in the scenario
Create a server and connect to CICS and installs relevant artifacts using the supplied configuration
sampleCicsIpicCatalogManager. This includes the
- Use the z/OS Connect API
inquireSingleservice, and then
About this task
In this scenario we use the API toolkit running on a Windows workstation to recreate the CICS
inquireSingleservice. The service archive file uses an existing CICS COBOL copybook from the catalog manager example application.
- Start IBM Explorer for z/OS and open the z/OS Connect (OpenAPI 2) perspective.
- Right click in the project explorer window and select z/OS Connect Service Project wizard. . Select the
Fill in the sections for the new service project and click Finish.
The IBM z/OS Connect
Service Project Editor dialog opens.
Add the program name DFH0XCMN to the program: input area, as shown.
Click the Configuration tab at the bottom of the screen.
Add the connection reference cicsConn
- Click the Definition tab at the bottom of the screen.
Click Create Service Interface.
Add the service interface name DFH0XCP4 and click OK.
- You have created a new service interface file. In the Service Interface editor, click Import COBOL or PLI data Structures into the service interface .
Locate the DFH0XCP4.si COBOL copybook and import it from the file system.
To import the copybook directly from your CICS installation, select z/OS
system from the Import from: list and locate the copybook from
the Source PDS: list. If the copybook is on your local workstation, select
Local file system from the Import from: list and
locate the copybook from the Source folder: list.
Click Add to Import List to import the DFH0XCP4 data structure from the
copybook, and click OK.
- Unselect the Include checkboxes for FILL_0 and FILL_1 to hide these fields from the user of the service as they are for internal use by the CICS application.
- Save your changes to the service interface DFH0XCP4.
Click Definition tab for the
inquireSingleservice. As there is only one service interface file, DFH0XCP4.si in the service interfaces folder for this project, it is automatically selected in the Request service interface and Response service interface fields.
inquireSinglein the Project Explorer view. Click .
- Click Browse to select the directory where you want to save the service archive file and click OK.
InquireSingle service archive file inquireSingle.sar is
now ready to be deployed.
Deploy and test your newly created
What to do next