uCosminexus Service Platform, Reception and Adapter Definition Guide

[Contents][Glossary][Index][Back][Next]

2.6.4 Adding Message Queue reception

The procedure for adding new Message Queue reception is as follows:

  1. From Eclipse menu, select [Window] - [Display view] - [Others].
    The [Display view] dialog box is displayed.
  2. Select [HCSC-Definer] - [HCSCTE view] and click the [OK] button.
    Service definition list is displayed in tree view.
  3. Right click on a business process in tree view and select "Add user-defined reception".
    Reception-type selection wizard is displayed.
  4. Select "Message Queue reception" from the drop-down list of reception type.
    If you click the [Next] button, a dialog box for entering the information required for adding Message Queue reception is displayed.
  5. Specify [Reception name]
    Specify name of Message Queue reception within 1 to 40 bytes.
  6. Click the [Finish] button.
    If you click the [Finish] button, the required file is created and it is saved in the repository. The service adapter definition screen (basic) is displayed.
  7. Set up the definition information of Message Queue reception.
    The following table describes the setting items of Message Queue reception:

    Table 2-20 Setting items of user-defined reception definition screen (basic) of Message Queue reception

    Classification Item Setting contents Setting
    User-defined reception information Reception name The reception name, which is set up is displayed. A
    Reception ID The reception ID is displayed. Change it, if necessary. A
    Name of default operation Select the operation to be invoked by default. A
    Operation Select the operation type to be added from the following details and specify the operation name:
    • Commit operation to be performed at the time of termination
      It is the standard pattern of Message Queue reception. Transaction with JMS provider is committed after the end of business process execution.
      The communication model of a business process is asynchronous.
    • Commit operation to be performed at any time
      It is the application pattern of Message Queue reception. Transaction with JMS provider is committed after completion of reply activity process of a business process.
      The communication model of a business process is synchronous.
      If an exception occurs in the processing of a business process after completion of reply activity process, you must resend the request.
    A
    Operation information Communication model Set as "Synchronous" or "Asynchronous". A
    Request message [use any] check box Check it when using a request message of any format (body) Y
    Reception Message format If you do not check the [Use any] check box, specify any message format file.
    If you check the [Use any] check box, you need not specify message format file.
    Y
    Service component [Use] check box Do not check this check box. -
    Response message [Use any] check box Check it when using a response message of any format (body). Y
    Reception Message format Specify any message format file. Y
    Service component [Use] check box Do not check this check box. -

    Legend:
    A: Set up this item, if necessary.
    Y: Setting of this item is optional.
    -: Not applicable.

  8. Click the user-defined reception (details) tab.
    User-defined reception definition screen (details) is displayed.
  9. Set up the definition information of Message Queue reception.
    The following table describes the setting items of Message Queue reception:

    Table 2-21 Setting items of user-defined reception screen of Message Queue reception (details)

    Classification Item Setting contents Setting
    User-defined reception control information Self-defined file Confirm that the following self-defined file is set:
    • cscurecpmq.properties#1
    A
    EAR file Confirm that the following EAR file is set:
    • cscmsg_urecp_mq.ear#2
    N

    Legend:
    A: Set up this item without fail.
    N: Confirm the displayed contents.

    Note#1
    cscurecpmq.properties, which is set up is a template file. Select cscurecpmq.properties, if necessary, click the [Edit] button and modify the contents of self-defined file. For details on cscurecpmq.properties, see Message Queue reception definition file in the manual Service Platform Reference Guide.

    Note#2
    The directory in which the file is to be stored is "Installation directory of service platform\CSC\custom-reception\mq\lib".