Rational Developer for System z

Generating Web services artifacts for the inquireSingle Web service

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:
  1. Verify that the Navigator view is open. If the Navigator view is not open, follow these steps to open the Navigator view:
    1. In the menu bar of the workbench, select Window > Show View > Other. The Show View wizard opens.
    2. In the Show View wizard:
      1. Expand General.
      2. Select Navigator.
      3. Click OK.
    The Navigator view opens.
  2. Start the Enterprise Service Tools Wizard Launchpad:
    1. In the Navigator view, right-click DFH0XCP1.cbl.
    2. Select Enable Enterprise Web Service.
    The Enterprise Service Tools Wizard Launchpad opens.
  3. Launch the Create New Service Interface (bottom-up) wizard:
    1. In the Enterprise Service Tools Wizard Launchpad:
      1. In the Runtime list box, select Web Services for CICS.
      2. In the Scenario list box, select Create New Service Interface (bottom-up).
      3. In the Conversion type list box, select Compiled XML Conversion.
      4. Click Start.
      The Create New Service Interface (bottom-up) wizard opens.
  4. 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.
    1. On the Language structures page:
      • Request language structure : CA-INQUIRE-SINGLE
        Note: Follow these steps:
        1. Expand DFH0XCMN.
        2. Select CA-INQUIRE-SINGLE
        Only CA-INQUIRE-SINGLE and all its child elements should be selected.
      • Response language structure : CA-INQUIRE-SINGLE
    2. 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
    3. On the Web Services for CICS page:
      • On the Basic Options tab:
        • WSBind file name : inquireSingle
    4. 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.


Feedback