The copy book containing the combined interface definition for
the catalog manager is located in the CICS® samples dataset with member name DFH0XCP1.
The inquireSingle Web service uses a subset of the interface definition which
can be found in a separate copy book DFH0XCP4.
You can run the
Create New Service Interface (bottom-up) wizard
against either of these copy books, keeping in mind that if you choose to
go with DFH0XCP1 you should make sure on the first page of the wizard (entitled
Language
structures) to select the redefinition
CA-INQUIRE-SINGLE REDEFINES
CA-REQUEST-SPECIFIC and all of its child elements.
Note: Filler items
are not displayed.
One of the benefits of using Enterprise Service Tools is support for the REDEFINES modifier. You do
not have to factor out your interface definition into separate copy books
for each redefinition.
The Create New Service Interface (bottom-up) wizard
expects that all imported COBOL language structures have a level 01 containing
element declared. You must add the declaration 01 DFH0XCMN to the top of
whichever copy book you decide to use. The name of the level 01 is important
in this case so that the root element name used by the XML converters matches
what is expected by the CICS Web client for the catalog application.
See Locating the CICS application source and copy books for
how to access the copy books mentioned in the workspace.
After the source for the copy books is in the workspace, see Generating the Web services artifacts conversion artifacts for
details on how to generate the XML converters, driver, and WSBind and WSDL
files, using the following inputs to the Create New Service
Interface (bottom-up) wizard.
Follow these steps to use the Create New Service Interface
(bottom-up) wizard:
- Verify that the Navigator view is open. If the Navigator view is not open,
follow these steps to open the Navigator view:
- In the menu bar of the workbench, select .
The Show View wizard opens.
- In the Show View wizard:
- Expand General.
- Select Navigator.
- Click OK.
The Navigator view opens.
- Start the Enterprise Service Tools Wizard Launchpad:
- In the Navigator view, right-click DFH0XCP1.cbl.
- Select Enable Enterprise Web Service.
The Enterprise Service Tools Wizard Launchpad opens.
- Launch the Create New Service Interface (bottom-up) wizard:
- In the Enterprise Service Tools Wizard Launchpad:
- In the Runtime list box, select Web
Services for CICS.
- In the Scenario list box, select Create
New Service Interface (bottom-up).
- In the Conversion type list box, select Compiled
XML Conversion.
- Click Start.
The Create New Service Interface (bottom-up) wizard opens.
- Enter the following values for each page of the
wizard. If a value is not specified for a particular input field or list box
selection, then use the default value already displayed for that field or
list box.
- On the Language structures page:
- Request language structure : CA-INQUIRE-SINGLE
Note: Follow
these steps:
- Expand DFH0XCMN.
- Select CA-INQUIRE-SINGLE
Only CA-INQUIRE-SINGLE and all its child elements should be selected.
- Response language structure : CA-INQUIRE-SINGLE
- On the Generation Options page:
- On the XML Converters tab:
- Service program name : DFH0XCMN
- Request Codpage : Codepage of your CICS system
- Host Codepage : Codepage of your CICS system
- Response Codepage : Codepage of your CICS system
- On the WSDL and XSD tab:
- Endpoint URI : http://yourserver:yourport/exampleApp/inquireSingle
- On the Web Services for CICS page:
- On the Basic Options tab:
- WSBind file name : inquireSingle
- On the File, data set, or member selection page:
- On the XML Converters tab:
- Converter driver file name : DFHXCP4D
- Request Converter file name : DFHXCP4I
- Response Converter file name : DFHXCP4O
- On the WSDL and XSD tab:
- WSDL file name : inquireSingle
The Create New Service Interface (bottom-up) wizard generates the specified
output.