Generating the request mapping session file

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

To generate the request mapping session file:

1. Right-click the COBOL copybook in your project and select Enable Enterprise Web Service.
   The Enterprise Service Tools Wizard launchpad opens.
2. In the Enterprise Service Tools Wizard launchpad,
   1. Select the following settings:

      Figure 1. Selections in the Enterprise Service Tools Wizard Launchpad

      

      • Host runtime: IMS Enterprise Suite SOAP Gateway
      • Development scenario: Map an Existing Service Interface (meet-in-middle)
      • Application mode: web Service Requestor
      • Conversion type: Compiled XML Conversion
   2. Click Start.
   The Map an Existing Service Interface wizard opens.
3. Create a request 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, the name of the copybook that you right-clicked 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 WSDL file for the web service that your IMS application is calling out to.
      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.
      1. Adjust the values if they are not what you want by selecting from the selection lists.
      2. Ensure that the correct source language structure is selected.
      3. Click Next.
   3. Create a new XML to COBOL mapping session.

      Figure 3. Creating request message mapping session file

      

      1. In the Mapping file folder field, specify the path for the folder in which you want the new request mapping session file to be created.
      2. In the Map file name field, type a name for the new request 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, 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.

   Figure 4. Request message mapping in the mapping editor