To locate, view, and process failed events, use Flow Manager, a tool that
is installed with the InterChange Server Express product. Flow Manager
allows you to easily construct a query to locate and display unresolved
flows. After you display the unresolved flows, you can select any flow
in the display and submit it, discard it, or perform other actions. For
background information on failed flows, see Flow failures.
The following topics describe how to use Flow Manager for constructing the
queries, viewing the details, and processing the events:
Steps for starting Flow Manager
Steps for finding unresolved flows
"Steps for viewing details for unresolved flows"
Steps for processing unresolved flows
Perform the following steps to start Flow Manager:
- Click Start > Programs > IBM WebSphere Business Integration
Express > Toolset Express > Administrative > Flow
Manager. The Connect to InterChange Server dialog box appears
(see Figure 67.
Figure 67. Connect to InterChange Server dialog box

- Enter the server name, using any one of the following methods:
- Type the user name and password for the server you want to connect
to. If you check the Remember user name and password check
box, the user name and password are stored in the registry along with the
server name, and the password are encrypted. Click
Connect.
- Note:
- To remove unwanted users or servers from the registry, click Options.
This opens the Options dialog box, from which you can remove servers or
users.
The following figure shows the Options dialog box.
Figure 69. Options dialog box

After you click Connect in the Connect to InterChange Server
dialog box, Flow Manager opens (see Figure 70).
Figure 70. Flow Manager

Perform the following steps in Flow Manager to find all unresolved
flows:
- Start Flow Manager. See Steps for starting Flow Manager.
- Do one of the following:
- If you want to locate and display all unresolved flows, accept the
defaults of Any for all the fields.
- If you want to construct a query to find specific flows, refer to the
following sections that describe the search options in each tab:
- After specifying your search criteria, click the Find button or
click Event > Find. The results appear in the bottom half
of the Flow Manager window (see Figure 71).
Figure 71. Flow Manager displaying filtered results

- To save the current filter information as a query, click Query >
Save. The query name you type appears in the Query
list.
Click the Event Attributes tab to search according to the
characteristics of the unresolved event (see Figure 72).
Figure 72. Flow Manager Event Attributes tab

The following options are available from the Event Attributes
tab:
- Status: Select events according to their status, which
you can designate as one of the following:
- Any: Selects all unresolved events.
- Failed: Selects all unresolved events that are in the
Failed state.
- In Transit: Selects all unresolved events that are in the
In Transit state.
- Possible Duplicate: Selects all unresolved events that
are in the Possible Duplicate state.
- Deferred: Selects all unresolved events in which the
point of failure was a collaboration with a recovery mode setting of
Deferred.
- Waiting: Selects all unresolved events in which the point
of failure was a collaboration with a recovery mode setting of Waiting.
- Event Owner: Select a collaboration name or a connector
name to query for flows that failed within that collaboration or
connector. You can string together multiple selections by clicking in
the new empty field that is created below each existing selection. To
search all of your collaborations and connectors, select
Any.
- Event: For each collaboration or connector that you
select, select an event, as represented by a business object. You can
select one event, string together multiple events, or select
Any.
- Verb:
Chose the verb to query for each event.
- Source Connector
Select the source connector or connector whose flows you want to query, or
select Any.
Use the Date & Time tab to query only the flows that failed
during a specific time period (see Figure 73).
Figure 73. Date & Time tab

The following options are available from the Date & Time
tab:
- Any Time: Queries for all failed events, with no
restriction on when occurred
- Find all events: Queries for all failed events that
occurred within a specified time period:
- between (specified times)
- within (period of days)
- older than (number of days)
Use the Error Text & Business Object Attributes tab to
construct a query that includes only certain business objects, business object
attributes, and attribute values (see Figure 74).
Figure 74. Error Text & Business Object Attributes tab

Select values in the following columns:
- Business Object
- Attribute
- Operand
- Value
You can also query only unresolved flows that produce a message containing
specified text that you type in the Containing Error Text
field.
- Note:
- The keywords you type in the Containing Error Text field are not
case-sensitive.
Perform the following steps to view details for unresolved flows in Flow
Manager:
- Select a query from the Query list.
- Do one of the following:
- Click the Find button.
- Click Event > Find.
The results appear in the bottom half of the Flow Manager window (see Figure 71).
An unresolved flows table appears with a list of events and the following
information:
- Event Status
- Event Owner
- Point of Failure
- Connector
- Event
- Time
- Message
- Key Attributes
For the waiting events, the Event Status cell contains the
following information:
Waiting
[timeout expiration:...]
[scenario name:...]
[scenario node ID...]
- To access more information about any of the events, double-click the row
containing the event (or click Event > Select All). This
opens the Show Event Details dialog box (see Figure 75).
Figure 75. Flow Manager Show Event Details dialog box

- To access more information about the business object associated with the
selected event, click Event > Display Details. The Show
Business Object Data dialog box appears (see Figure 76).
Figure 76. Show Business Object Data dialog box

If you want to take action on any of the unresolved flows, refer to Steps for processing unresolved flows.
Perform one of the following steps to manage queries you created for
unresolved flows:
- To save the current filter information as a query, click Query >
Save. The query you type appears in the Query
list.
- To delete a selected query in the Query menu, click Query
> Delete.
- To show or hide the content of the query, click Query >
Show/Hide.
Perform the following steps to manage queries you created for unresolved
flows:
- In the results list in Flow Manager, select one or more events in the
results list.
- Do one of the following:
- To delete selected events, click Event > Delete.
- To save all the failed events in the results list in an Excel file, click
Event > Save.
- To print the selected events to a table, click Event >
Print. A dialog box appears with Print All Events or
Print Selected Events options.
- To display the number of events corresponding to the current query, click
Event > Get Count.
- To clear all the result events, close the result list, and refresh all the
filter controls, click Event > New Search.
Perform the following steps to process any failed events in the results
list in Flow Manager:
- In the results list in Flow Manager, select one or more events in the
results list.
- Do one of the following:
- To send the data of the events back to the destination application, click
Event > Submit.
- To cancel waiting events (long-lived business processes), click Event
> Cancel Waiting.
- To refresh the data and then send the events back to the destination
application, click Event > Refresh & Submit.
