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 inquireSingle
service 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
template
sampleCicsIpicCatalogManager
. This includes the
inquireSingle
service.
- Use the z/OS Connect API
toolkit to
Stop
the inquireSingle
service, and then Remove
the inquireSingle
service.
About this task
In this scenario we use the API toolkit running on a Windows workstation to recreate the CICS
inquireSingle
service. 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 . Select the z/OS Connect Service Project wizard.
-
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
inquireSingle
service. 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.
Save the InquireSingle
service.
-
Right click
inquireSingle
in the Project Explorer view.
Click .
-
Click Browse to select the directory where you want to save the service
archive file and click OK.
The InquireSingle
service archive file inquireSingle.sar is
now ready to be deployed.
What to do next
Deploy and test your newly created InquireSingle
service.