> Using the AquaLogic Service Bus Console > Split-Joins

Using the AquaLogic Service Bus Console

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Split-Joins

Split-Joins let you send message invocations in parallel (in addition to sequentially) and to aggregate the responses. To learn more about Split-Joins, see Improving Service Performance with Split-Join in the AquaLogic Service Bus User Guide. See also, Working with Split-Join and the Split-Join User Interface Reference in Using the AquaLogic Service Bus Plug-in for WorkSpace Studio.

You access Split-Joins through Flow transport-typed business services. For more information, see the Flow Transport Configuration page.

Locating Split-Joins

  1. Do either of the following:
  2. To restrict the number of items in the list, you can filter by name, path, or both. In the Name and Path fields, enter the name and path of the search target(s), then click Search.
  3. Click View All to remove the search filters and display all Split-Joins.

    4. Table 9-1 Split-Join Details 
    Property
    Description
    Split-Join Name
    The name assigned to the Split-Join. The name is a link to the Split-Join Configuration page. See Editing Split-Joins.
    Path
    The path is the project name and the name of the folder in which the Split-Join resides. It is a link to the project or folder that contains this resource. See Qualifying Resource Names Using Projects and Folders.
    Options
    Click the Delete icon to delete a specific Split-Join. See Deleting Split-Joins.

Adding Split-Joins

Before you begin

Split-Joins require a .flow file which is created when you create a Split-Join using the AquaLogic Service Bus Plug-in for WorkSpace Studio or when you import a Split-Join configuration JAR into the plug-in. The .flow file might have references to proxy services, business services, or to external WSDL resources. Resources on which the Split-Join depends must be present on the server before activating the Split-Join.

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
  2. Select Project Explorer, then select a project or folder in which to add the Split-Join. The Project/Folder View page is displayed.
  3. From the Create Resource drop-down list, select Split-Join from under Interface to display the Create a New Split-Join Resource page.

    4. Specify the parameters shown in Table 9-2.

    Table 9-2 Split-Join Parameters 
    Property
    To create or edit...
    Resource Name
    Enter a unique name for this Split-Join.
    Resource Description
    Enter a description for the Split-Join.
    Split-Join
    Click Browse to locate a .flow file on your system, typically located under BEA_HOME\user_projects\workspaces\workSpaceStudio, where BEA_HOME represents the directory in which you installed AquaLogic Service Bus.
    Dispatch Policy
    Select the instance of WebLogic Server Work Manager used to create threads (parallel branches) to execute the Split-Join. The default Work Manager is used if no other Work Manager exists.
    Tracing
    Select the Enabled check box to enable run-time tracing for this Split-Join.

  4. Click Save. The Split-Join is created and saved in the current session.
    5. Note: Resources on which the Split-Join depends must be present before activating the Split-Join.
  5. To end the session and deploy the configuration to the run time, click Activate under Change Center.

Editing Split-Joins

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
  2. Locate the Split-Join, as described in Locating Split-Joins.
  3. Click the Split-Join name.

    4. The View a Split-Join - Configuration page displays the information shown in Table 9-3.

    Table 9-3 Split-Join Details 
    Property
    Description
    Last Modified By
    The user who created this Split-Join or imported it into the configuration.
    Last Modified On
    The date and time that the user created this Split-Join or imported it into the configuration. Click the date and time link to view the change history of this resource. See View Change History page.
    References
    The number of objects that this Split-Join references. If such references exist, click the numeric link to view a list of the objects. See Viewing References to Resources.
    Referenced by
    The number of objects that reference this Split-Join. If such references exist, click the numeric link to view a list of the objects. See Viewing References to Resources.
    Description
    A description of this Split-Join, if one exists.

  4. To make a change to the fields, click Edit. For descriptions of the fields, see Adding Split-Joins.

    5. You cannot change the Resource Name field.

  5. Click Save to commit the updates in the current session.
  6. To end the session and deploy the configuration to the run time, click Activate under Change Center.

Deleting Split-Joins

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
  2. Select Resource Browser > Split-Joins to display the Summary of Split-Joins page.
  3. Click the Delete icon in the Options field of the Split-Join you want to delete. The Split-Join is deleted in the current session. A Deletion Warning icon is displayed when other resources reference this resource. You can delete the resource with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource.
  4. To end the session and deploy the configuration to the run time, click Activate under Change Center.

  Back to Top       Previous  Next