Generating the response mapping session file

Create a response (web service response to the callout request from an IMS application) mapping session file with the web service WSDL file as the source, and the IMS application source file as the target to map the data structures between the IMS application and the web service for the response message.

To generate the response mapping session file:

1. Right-click the web service WSDL file and select Enable Enterprise Web Service.
   The Enterprise Service Tools Wizard launchpad opens.
2. In the Enterprise Service Tools Wizard launchpad, select the following options:

   Figure 1. Selections in the Enterprise Service Tools Wizard Launchpad

   

   • Host runtime: IMS Enterprise Suite SOAP Gateway (Rational® Developer for System z® Version 8.0.3.2 or later), or IMS SOAP Gateway in earlier versions.
   • Development scenario: Map an Existing Service Interface (meet-in-middle)
   • Application mode: Web Service Requestor
   • Conversion type: Compiled XML Conversion

   Click Start.
3. Create a response mapping session file.
   1. On the New XML to COBOL or PL/I Mapping Session page of the wizard:

      Figure 2. Specifying the mapping source and target

      

      1. In the Mapping source field, ensure that the name of the WSDL file is listed. If this is not the file you want to use for the source, click Browse and choose a different source file.
      2. In the Mapping target field, specify the source file for the IMS application that issues the callout request.
      3. Click Next.
   2. On the Root XML Element and Language Structure Selection page of the wizard, the fields are automatically completed based on the COBOL copybook source and the WSDL target file that you specified. Check the values.

      Figure 3. Specifying the root XML element and language structure

      

      1. Adjust the values if they are not what you want by selecting from the selection lists.
      2. Ensure that the correct target language structure is selected.
      3. Click Next.
   3. Create a new XML to COBOL mapping session.

      Figure 4. Creating the response message mapping session file

      

      1. In the Mapping file folder field, specify the path for the folder in which you want the new response mapping session file to be created.
      2. In the Map file name field, type a name for the new response mapping session file.
      3. Click Finish.
      A mapping session file with a mapping extension is created in the file folder that you specified.
4. Use the mapping editor to create data mappings:
   1. Double-click the mapping session file that you want to edit.
      The mapping editor opens.
   2. In the mapping editor:
      1. For each mapping that you want to create, drag an element in the source data to an element in the target data. The editor displays a connecting line between the source element and the target element to indicate that a mapping exists.
      2. When you are finished creating the mapping, close the mapping editor.

   Figure 5. Creating the response message mapping