Administering 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 from System Manager in the InterChange Server Component Management view.
This section covers the following topics:
Viewing collaboration object states
Starting, stopping, and pausing collaboration objects
Configuring collaboration object run-time properties
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.
Perform the following steps in System Monitor to view the state of collaboration objects:
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.
Perform the following steps in System Manager to view the state of collaboration objects:
The collaboration objects appear under the expanded Collaboration Objects folder with different colored lights to indicate their different states (see Figure 32.
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:
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. |
To run a collaboration object 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.
Perform the following steps in System Monitor to start, stop, and pause collaboration objects:
Perform the following steps in System Manager to start, stop, and pause collaboration objects:
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:
Perform the following steps to open the Collaboration Properties window and change values for general properties of a collaboration object:
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:
See the System Implementation Guide.
See Steps for configuring the collaboration object trace level.
See Steps for configuring e-mail notification at the collaboration object level.
See Critical errors.
See Troubleshooting the system, and see the Collaboration Development Guide.
See the System Implementation Guide.
See the System Implementation Guide.
See Steps for configuring collaboration objects to process concurrent event-triggered flows.
See Steps for configuring flow control for collaboration objects.
For detailed information about processing concurrent events, see the System Implementation Guide.
Perform the following steps to set the maximum number of concurrent flows for a collaboration:
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.
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:
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: