Rational Developer for System z

Create an UpdateAmount component and service

Create an UpdateAmount component and service for the composite. The component uses the EXUPDAMT program.

Before you begin

You must have created a composite in the FileaAmountServices project, created a componentType file, and generated the Service artifacts for the EXUPDAMT program.

About this task

You can save your progress at any stage during this task by using the keyboard shortcut Ctrl+S.

Procedure

  1. Right-click the FileaAmountServices project and select New > SCA Component. The New component wizard displays.
  2. Complete the New component wizard with the following values:
    1. In the Project field, select FileaAmountServices.
    2. In the Composite field, select the FileaAmountServiceComposite - http://sample.org/fileaamountservice composite from the list.
    3. In the Component Name field, enter UpdateAmount.
    4. In the Interface Type field, select WSDL.
    5. Choose the option to reuse an existing service interface.
    6. In the Interface Name field, use the Select button to search for the interface that you created. The field populates with the value EXUPDAMTPort - file://target.files.
    7. In the Implementation Type field, select CICS.
    8. Choose the option to reuse an existing implementation.
    9. In the Implementation Name field, use the Select button to search for the componentType file that you created. The field populates with the value \FileaAmountServices\EXUPDAMT.componentType
    10. Click the Finish button to create the component in an existing composite.
  3. Using the EST Project Explorer, click SCA content > Composites > http://sample.org/fileaamountservice to expand the folder structures.
  4. Double-click on the FileaAmountServiceComposite composite to open the composite editor.
  5. Select the service icon. The Properties View displays details about the service in a number of tabs. If the view is not displaying, click in the composite diagram editor and select Show Properties View.
  6. On the Core tab, edit the Name field to rename the service for the UpdateAmount component from EXUPDAMTPort to UpdateAmountService.
  7. On the Interface tab, check the values for the Interface type and Interface fields. These values are provided for you based on the values that you entered in the New component wizard.
  8. To add a CICS binding to the service, go to the Binding tab, select Bindings, click Add, and select Webservice.
  9. Set the name of the binding to EXUPDAMT and the URI as /cics/services/EXUPDAMT.
  10. Scroll down to edit the CICS attributes for the binding:
    1. Use the Select button to choose the Web service binding that you created.
    2. Edit the Pipeline attribute to define which PIPELINE resource will handle the Web service request in your CICS region. The pipeline must be configured as a service provider.
  11. Select the component in the composite editor. The Properties View updates to display information about the component.
  12. On the Implementation tab, check the values for the Component type, Program, and Call type fields. These values are provided for you based on the values that you entered in the New component wizard.
  13. Reorganize the components so that they resemble the following figure:
    FileAmountServiceComposite comprises InquireAmount, AddAmount, and UpdateAmount.

What to do next

You have created a component and service that uses the EXADDAMT program.

Feedback