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 in System Manager. To log on to System Monitor, follow the instructions in Steps for logging on to System Monitor.. To use System Manager, follow the instructions in Steps for connecting to an InterChange Server Express instance..

The state of a collaboration object is represented differently, depending on which tool you are using.

Steps for using System Monitor to view collaboration object states

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

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

    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 display a list of components on the system. All collaboration objects are listed along with their status, start time, and total up time (see Figure 29).

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


Steps for using System Manager to view collaboration object states

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

  1. Open System Manager and connect to the InterChange Server Express instance that contains the collaboration object that you want to view (see Steps for connecting to an InterChange Server Express instance).
  2. In the InterChange Server Component Management view, expand the InterChange Server Express 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 30.

Figure 30. Collaboration Objects folder in the InterChange Server Component Management view


Table 9 describes the collaboration object states that are viewable from System Monitor and the Collaboration Objects folder in the InterChange Server Component Management view:

Table 9. Collaboration object states

Collaboration object state Description
Start A started collaboration subscribes to its triggering business objects and processes them as they arrive. If you stop and then restart InterChange Server Express, collaboration objects in the Start state automatically start running when InterChange Server Express restarts.
Pause A paused collaboration cannot receive new flow initiators. It 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 resumes.

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

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 when 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).

Copyright IBM Corp. 2004