Configuring collaboration object run-time properties

This section describes system administration tasks in a production environment and contains the following procedures:

"Steps for setting collaboration object general properties"

"Steps for configuring collaboration objects to process concurrent event-triggered flows"

Steps for configuring flow control for collaboration objects

For information about the following tasks, see the System Implementation Guide:

Steps for setting collaboration object general properties

Perform the following steps to open the Collaboration Properties window and change values for general properties of a collaboration object:

  1. In System Manager, expand the Collaboration Objects folder in the InterChange Server Component Management view.
  2. Right-click a collaboration object and click Properties.
  3. In the Properties dialog box, click the Collaboration General Properties tab. See Figure 31.

Figure 31. Properties dialog box, Collaboration General Properties tab


The dialog box shows the template from which the collaboration object was generated and the minimum transaction level that was specified in the collaboration template.

The dialog box enables you to set the following:

Steps for configuring collaboration objects to process concurrent event-triggered flows

For detailed information about processing concurrent events, see the System Implementation Guide.

Tip:
Processing concurrently triggered events in collaborations requires additional system resources. To maximize performance, ensure that system resources used to handle concurrent events are not idle. For example, do not set the value for the maximum concurrent triggered-event processing option to 10 if the collaboration queue is set to process a maximum of four events.

Perform the following steps to set the maximum number of concurrent flows for a collaboration:

  1. From the expanded Collaboration Objects folder in the InterChange Server Component Management view, right-click the collaboration object that you want to change and click Properties. The Properties dialog box appears (see Figure 31).
  2. In the Collaboration General Properties tab, enter a value in the Maximum number of concurrent events field.
  3. Click OK to save your changes and close the window.
  4. Restart the collaboration for changes to take effect.

Steps for configuring flow control for collaboration objects

Flow control is a configurable service that allows you to manage the flow of connector and collaboration object queues. The parameters for configuring flow control can be system-wide or on individual components, or both. If you configure both, the individual component configuration supersedes the system-wide configuration. For instructions on configuring flow control system-wide, see Steps for configuring system-wide flow control. This section describes how to configure flow control for collaboration objects.

Note:
Configuration changes for individual connectors or collaboration objects are dynamic, meaning they do not require InterChange Server Express to be rebooted. System-wide configuration changes for flow control require InterChange Server Express to be rebooted.

To monitor how flow control is working in the system, you can view the Flow Control monitor and view provided as part of System Monitor or you can view the Statistics for collaboration objects or connectors in System Manager from the InterChange Server Component Management view. For more information on using the Flow Control monitor and view in System Monitor, see Steps for reviewing default monitors and Steps for using default views. For more information on viewing the flow control in System Manager from the InterChange Server Component Management view, see Steps for viewing collaboration object statistics or Steps for viewing connector statistics.

Perform the following steps to configure flow control for a collaboration object:

  1. In System Manager, expand the Collaboration Objects folder in the InterChange Server Component Management view.
  2. Right-click the collaboration object for which you want to create flow control and click Properties. The Properties dialog box appears (see Figure 31).
  3. In the Collaboration General Properties tab, edit the value in the Max Event Capacity field to represent the maximum number of events you want queued for a collaboration object. The valid range of values for this property is from 1 to 2147483647, inclusive.
  4. Click OK. The property is changed immediately.

Steps for reconfiguring the timeout attribute for long-lived business processing

Long-lived business processing enables collaboration objects to be deployed as long-lived business processes. If a collaboration object has been configured with long-lived business processing, the service call timeout values can be reconfigured during run time. For more information about developing a collaboration object with long-lived business processing, see the Collaboration Development Guide.

Perform the following steps to reconfigure the service call timeout values of a collaboration with long-lived business processing:

  1. From the expanded Collaboration Objects folder in the InterChange Server Component Management view, right-click the collaboration object whose service call timeout value you want to edit, then click Properties. The Properties dialog box appears.
  2. Click the Properties tab, locate the property that represents the service call timeout value you want to change, then click in the value field. When the property is selected, the value can be edited.
    Note:
    The name of the service call timeout configuration property may be something like, "CreateTimeout" or "RetrieveTimeout," but because there is no naming convention for this property, you may have to contact the collaboration developer if the name of the service call timeout configuration property is not immediately apparent.
  3. Edit the value so that it represents the number of timeout minutes allowed.
    Note:
    The Value field must contain an integer greater than 0. If it contains a 0 or is left blank, the wait time is equal to infinity. If it contains non-numerical values, it triggers a collaboration run-time exception.
  4. Click OK. Your changes take place immediately, without the need to restart InterChange Server Express.

Copyright IBM Corp. 2004