Administering collaboration objects

Operating collaboration objects may include such tasks as running, pausing, stopping, and shutting down collaboration objects. For information about configuring collaboration objects, see the System Implementation Guide.

You can run, pause, stop, and shut down collaboration objects from either System Monitor or the InterChange Server Component Management view of System Manager.

This section covers the following topics:

"Viewing collaboration object states"

Starting, stopping, and pausing collaboration objects

"Configuring collaboration object run-time properties"

Viewing collaboration object states

You can view the state of a collaboration object either by logging on to System Monitor and opening a view that contains collaboration object information or by using the InterChange Server Component Management view of System Manager. To log on to System Monitor, follow the instructions in Steps for logging on to System Monitor.. To use the InterChange Server Component Management view of System Manager, follow the instructions in Steps for connecting to an InterChange Server instance..

The state of a collaboration object is represented differently, depending on whether you ar e using System Monitor or System Manager.

Steps for using System Monitor to view collaboration objects

Perform the following steps to view the state of collaboration objects using System Monitor:

  1. If the System Overview view is not displayed, click the System Overview link under Views in the left pane of the Web page. The System Overview Monitor appears (see Figure 11) in the body of the Web page.

    When the product is installed, the default view is set to System Overview, and the default monitor contained in that view is set to System Overview. These defaults can be changed to suit your monitoring needs. See Setting up views to monitor the system for instructions.

  2. Click the triangle next to the name of the server to reveal a list of components on the system. All collaboration objects are listed along with their status, start time, and total up time (see Figure 26).

    Figure 26. System Monitor, System Overview displaying collaboration object status

    The figure shows a view of the collaboration object status. This screen displays the component name, the type of component, for example, collaboration or connector, the status of the component, for example, running, the time the connector was started and the total running time of the connector.

Note:
You may also view collaboration states using the Collaboration Overview view.

Steps for using System Manager to view collaboration object states

Perform the following steps to view the state of collaboration objects using System Manager:

  1. Connect to the InterChange Server instance that contains the collaboration object you want to view. See Steps for connecting to an InterChange Server instance for instructions on connecting to an InterChange Server instance.
  2. Expand the InterChange Server instance, then expand the Collaboration Objects folder.

    The collaboration objects appear under the expanded Collaboration Objects folder with different colored lights to indicate their different states (see Figure 27.

Figure 27. Collaboration Objects folder in the InterChange Server Component Management view of System Manager

The figure shows a view of the InterChange Server Component Management Screen, which displays all InterChange Server instances, for example, Collaboration Templates, Collaboration Objects and Business Objects, in a tree directory.

Table 15 describes the collaboration object states which are viewable from System Monitor and the Collaboration Objects folder in the InterChange Server Component Management view of System Manager:

Table 15. Collaboration object states

Collaboration object state Description
Start Starting a collaboration object causes it to subscribe to its triggering business objects and to process them as they arrive. If you stop and then restart InterChange Server, collaboration objects in the Start state automatically start running when InterChange Server comes back up.
Pause Pausing a collaboration prevents it from receiving new flow initiators. The collaboration completes all of the current processing, then enters an idle state.

A connector maintains its subscription information; therefore, it continues to send flow initiators to the connector queues. The collaboration processes these when it is resumed.

To resume collaboration execution, click Start in System Monitor or in the Collaboration Object menu of the InterChange Server Component Management view of System Manager.

Stop Stopping a collaboration causes it to unsubscribe to business objects. The collaboration completes all of the current processing, then becomes inactive. Unlike the Pause command, the Stop command causes connectors to stop sending business objects to the collaboration.

To properly stop a collaboration without losing any flows, first stop the associated connectors from polling, allow all flows to process, then stop the collaboration.

Shut Down Shutting down a collaboration immediately ends processing of current flows. When the collaboration is restarted, the system recovers by processing those flows that were interrupted by the shut down and recovering those flows waiting in the queue. This recovery is not immediate, so prepare to wait while the system completes the recovery interval.
Note:
When you stop or shut down a collaboration object that is part of a collaboration group, all collaborations in the group stop or shut down. If any member of a collaboration group fails to start up or has a state change failure, the collaboration group is rolled back to the initial state (deactivated or stopped).

Starting, stopping, and pausing collaboration objects

To make a collaboration object functional for the first time, you must first configure it then start it. See "Configuring collaboration object run-time properties" for more information on configuring collaborations. Depending on which tool you are using, you run, stop, and pause collaboration objects in different ways.

Steps for using System Monitor to start, stop and pause collaboration objects

Perform the following steps to use System Monitor to start, stop and pause collaboration objects:

  1. While viewing the System Overview view (see Figure 23), select a collaboration object by placing check in the box to its left.
  2. Select the Start, Pause, or Stop icon from the icon group in the upper-left corner of the view (see Figure 24).

Note:
You may also start, stop, pause and shutdown collaboration objects using the Collaboration Overview view.

Steps for using System Manager to start, stop and pause collaboration objects

Perform the following steps to use System Manager to start, stop and pause collaboration objects:

  1. From the Collaboration Objects folder of the InterChange Server Component Management view, right-click a collaboration object.
  2. Select the Start, Pause, or Stop.

Configuring collaboration object run-time properties

This section describes some aspects of collaboration object behavior that are configurable in a production environment and contains the following topics:

"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, do this:

  1. From the expanded Collaboration Objects folder in the InterChange Server Component Management view of System Manager, right-click a collaboration object and select Properties.
  2. In the Properties dialog box, choose the Collaboration General Properties tab. The following dialog box appears:

Figure 28. Properties dialog box, Collaboration General Properties tab

The figure shows a view of the general properties of a collaboration. The top of the screen shows you template used to create the collaboration, the effective transaction level and minimum transaction level for the collaboration, the system trace level and the collaboration trace level. The bottom of the screen includes check boxes that allow you to determine whether the system should pause when critical errors occur, place service calls in transit states, allow implicit database transactions, whether to allow a booking type, and whether to keep a subscription when an activation failure occurs. It also allows you to determine the maximum number of concurrent events, the recover mode distinction, and the maximum event capacity.

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 make settings for 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, then select Properties. The Properties dialog box appears (see Figure 28).
  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 configured 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, seeSteps 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 to be rebooted. System-wide configuration changes for flow control require InterChange Server 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 from the InterChange Server Component Management view of System Manager. 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 from the InterChange Server Component Management view of System Manager, see Collaboration object statistics or Connector statistics.

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

  1. From the expanded Collaboration Objects folder in the InterChange Server Component Management view of System Manager, right-click the collaboration object for which you want to create flow control, then select Properties from the drop-down menu. The Properties dialog box appears (see Figure 28).
  2. 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.
  3. 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 a 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. From 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 becomes highlighted, the value can be edited.
    Note:
    The name of the service call timeout configuration property may be something like, "CreateTimeout" or "RetreiveTimeout," but since there is no naming convention for this property, you may have to contact the person who developed the collaboration, if the name of the service call timeout configuration property is not immediately apparent.
  3. Edit the value so that it represent 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 waittime is equal to infinity. If it contains non-numerical values, it will trigger a collaboration run time exception.
  4. Click OK. Your changes take place immediately, without the need to restart InterChange Server.

Copyright IBM Corp. 1997, 2004