When the service component is MDB (WS-R), you must acquire both the queue information and service type of the service component from the developer. You use the acquired information when defining a service adapter.

The following types of information must be acquired:

• Queue name
• Destination address (if network communication between an adapter and a service component is used)
• User name and password for the basic authentication (if network communication between an adapter and a service component is used, and the basic authentication is used)
• Message type

In the case of MDB (WS-R), you need to create and set up a message format of the service component.

For details about how to create a service component message format, see 4.3.4 Creating a Service Component Message (for MDB (WS-R or DB Queue)) in the manual Service Platform Basic Development Guide.

If the message format of service requester and message format of service component invoked by the service adapter is different, data transformation is required.

For performing data transformation, specify the message entered from the service requester in the standard message using the Service Adapter Definition screen, and then define data transformation in the Data Transformation Definition screen.

For details about data transformation, see 6. Defining Data Transformation) in the manual Service Platform Basic Development Guide.

You can specify the method to invoke a service component to be used. You can choose either remote or local invocation. If you choose remote invocation, specify the number of maximum messages. Also, set a basic authentication as required.

If you specify remote invocation as a service component invocation method, you can specify the number of messages that can be processed at the same time, with a number changed from the initial value. You can set a value in a range from 1 to 65535.

If you specify remote invocation as a service component invocation method, and when user authentication is required in MDB (WS-R) message transfer, the basic authentication (user name and password) settings will be needed.

To define an adapter for MDB (WS-R):

1. Open the Service Adapter Definition screen.
   For details about how to open the Service Adapter Definition screen, see 3.3.1(4) Displaying the service adapter settings screen.
   
2. Edit Service name, Service ID, and The number of the maximum instances in the HCSC component control information as and when required.
3. Specify an address for the HCSC component control information.
   For Address, specify the queue name acquired in 3.3.3(1) Acquiring queue information and message type.
   
4. Check the contents displayed in the operation information.
5. Check the Convert a system exception into a fault message check box of service component control information as and when required.
6. Perform the following operations for request messages
   

   When specifying a message format

   Execute steps 7 to 10, and then proceed to step 11.

   When not specifying a message format

   Proceed to step 11.

7. Choose the Use check box for the message.
8. Specify Format ID for the message.
9. Click the Browse button for the message, and specify a message format in Message format.
   Note that for specifying a message format that references an external XML schema, make sure that you specify a file for the root schema. The external XML schema file referenced from the root schema is automatically imported.
   For details about message formats that can be specified, see 2.6.5 Application Scopes of XML Schema in the manual Service Platform Basic Development Guide.
   
10. Click the Display button for the message.
    The message format is displayed. Check the specified message format as and when required.
    
11. Specify Format ID for the service component message.
12. Click the Browse button for the service component message, and specify a service component message format in Message format.
13. Click the Display button for the service component message.
    The service component message format is displayed. Check the specified service component message format as and when required.
    
14. Perform the following operations.
    

    When the Use check box of the standard message is checked

    Execute steps 15. to 17. and then proceed to step 18.

    When the Use check box of the standard message is not checked

    Proceed to step 18.

15. Enter the file name of the Data transformation definition.
16. Click the Edit button.
    The Data Transformation Definition screen is displayed.
    Note that when defining the message format initially, the Choose root element dialog box appears.
    If the message format is changed, a dialog box for confirming whether to reflect the change of message format is displayed. For details about the procedure of the changed message format, see 6.3.2 Procedure for defining changed message formats in the manual Service Platform Basic Development Guide.
    
17. Map the contents of the standard message and the service component message.
18. Click the Service adapter definition (details) tab.
19. From the JMS Message Type drop-down list, choose a JMS message type.
20. Choose the service component invocation method in Invocation Setting.
    

    When you choose the Remote Invocation radio button

    Proceed to step 21.

    When you choose the Local Invocation radio button

    Proceed to step 29.

21. In The number of the maximum messages, specify the number of messages the service component can send.
22. In Destination URL, enter the destination address acquired in 3.3.3(1) Acquiring queue information and message type.
23. Depending on whether the service component requires user authentication, perform either of the following operations:
    

    When user authentication is required

    Execute steps 24 to 26, and then proceed to step 27.

    When user authentication is not required

    Proceed to step 27.

24. Choose the Use check box for the basic authentication.
25. In the user name and password columns, enter a user name and password necessary for the basic authentication.
26. In the Password (Re-enter) column, enter the same password as that entered in the password column.
27. Enter the transmit queue creation destination RD area as required.
28. Choose the Sequence guarantee check box as and when required.
29. Check the definition contents, and, on the Eclipse File menu, choose Save to save the defined contents.