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.