Working with failed events

You can use two tools in InterChange Server Express to locate, view, and process failed events: Failed Event Manager, a browser-based tool with role-based security that allows you to work with failed events from the Web, and Flow Manager, a tool installed with the InterChange Server Express product. To resolve transactional flows, you must use Flow Manager, but both Failed Event Manager and Flow Manager allow you to work with failed events. This section contains the following:

Using Failed Event Manager

Using Flow Manager

Using Failed Event Manager

Failed Event Manager allows you to view and manage failed events from the Web. To access Failed Events Manager, log onto System Monitor. The Failed Events Manager category shows up in the left hand frame, with two choices: Access Rights and Query. The Access Rights item allows you to display the Failed Event Manager access rights currently associated with your logged-on username. The Query item opens the display in which you perform actions with Failed Event Manager.

The actions you can perform with those failed events depends on role-based security. Administrators can assign users one or more of four default roles. For information on these roles, see Default roles for Failed Event Manager.

Administrators also can create custom roles for your specific team. For more information on these roles, see Custom Roles in Failed Event Manager.

Failed Event Manager works with IBM WebSphere Application Server Express or with Tomcat (Windows and Linux systems only). Refer to the WebSphere Business Integration Server Express installation guide for Windows, for Linux, or for OS/400 and i5/OS, for additional information about setting up Failed Event Manager to work with WebSphere Application Server, WebSphere Application Server Express, or Tomcat. OS/400 and i5/OS does not support Tomcat.

Failed Event Manager works with the following versions of WebSphere Application Server, WebSphere Application Server Express, and Tomcat:

This section includes the following procedures:

Security and Role-based access for Failed Event Manager

Failed Event Manager includes default roles. Administrators can also create additional security roles. For more information on role-based access control, see Administering role-based access control (RBAC).

Default roles for Failed Event Manager

Failed Event Manager provides four basic roles, that is:

To create the default roles, with the exception of Administrator, use the Server Administration Tool in System Manager. All of the default roles must have, and only have, security policy permission at the server level to view failed events. For more information, see Administering security policy permissions.

Note:
You can only use the SubmitEvents role in conjunction with another custom role that includes security policy permission at component level to submit and delete failed events for collaborations and connectors.
Custom Roles in Failed Event Manager

You can also create custom roles for use with Failed Event Manager using the Server Administration Tool in System Manager. You can assign both custom and default roles to a user. Custom roles can provide component level access, for example, a user with an appropriate role can be restricted to viewing failed events that belong to a specific event owner (connector or collaboration). For more information, see Administering roles.

All custom roles must have security policy permission at the server level to view failed events.

At the component level, each custom role must have Submit_Failed_Events and Delete_Failed_Events security permissions for each component. The event owner (collaboration object or connector object) must be identified, as well.

Steps for logging on to Failed Event Manager

You can access Failed Events Manager when you log onto System Monitor. Failed Events Manager shows up in the left hand frame along with the System Monitor views and settings.

Failed Event Manager can only be accessed through a supported browser on Windows platforms only. The supported browsers are:

Since WebSphere Business Integration Server Express now integrates System Monitor and Failed Events Manager, you must first log onto System Monitor to access the failed events. Once you have logged onto System Monitor, simply select the Failed Events Manager option from the left frame.

For information on logging into System Monitor, see Steps for logging on to System Monitor.

Steps for viewing failed events

Perform the following steps to view information about failed events in Failed Event Manager:

  1. On the Query page, select the information about the failed events that you want to view:
  2. Click Submit.

    A Table of Failed Events appears, as show in Figure 64.

    Figure 64. Failed Event Manager Table of Failed Events

    If you are not assigned to one of the roles that has access to viewing business objects, the business object buttons may not be available in this table, as shown in Figure 65.

    Note:
    Depending on your browser, buttons or other controls either do not appear or appear and are unavailable.

    Figure 65. Failed Event Manager Table of Failed Events without rights to view business objects
  3. If you want to view details for a particular failed event, select the check box in the left column and click View in the Details column.

    The Event Details dialog box appears, as shown in Figure 66.

    Figure 66. Failed Event Manager Event Details dialog box
  4. If you are assigned to a role that has access to the business object, click the business object button in the Business Objects column to view details about the business object. The Business Object Data dialog box appears, as shown in Figure 67.
    Figure 67. Failed Event Manager Business Object Data dialog box

Steps for processing failed events in Failed Event Manager

Perform the following steps in a Table of Failed Events to process failed events:

  1. Select the check box in the left column for the failed events that you want to work with.
  2. Do one of the following:

Steps for checking your access rights in Failed Event Manager

Perform the following steps to check the roles you are assigned for Failed Event Manager role-base security:

  1. log on to Failed Event Manager (see Steps for logging on to Failed Event Manager).
  2. On the query page that opens, click the Check your access rights link in the bottom left.

    A page appears listing the default roles available. You can type a role name to see if you are assigned to that role.

Using Flow Manager

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. Flow Manager allows you to display unresolved flows for multiple servers, and launches either as a standalone tool or as a System Manager editor.

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 as a standalone tool

Steps for starting Flow Manager from System Manager

Steps for finding unresolved flows

Steps for viewing details for unresolved flows

Steps for processing unresolved flows

Steps for starting Flow Manager as a standalone tool

Perform the following steps to start Flow Manager as a standalone tool:

  1. Click Start > Programs > IBM WebSphere Business Integration Express > Toolset Express > Administrative > Flow Manager. The Flow Manager application window opens.
  2. Select Server > Connect to Server. The Connect to InterChange Server window displays.
  3. Enter the server name using one of the following methods. For Windows, the default server is WebSphereICS. For OS/400 and i5/OS, the default server is QWBIDFT44.
  4. 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 is 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 68. Options dialog box

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

Figure 69. Flow Manager

Steps for starting Flow Manager from System Manager

Perform the following steps to start Flow Manager from System Manager:

  1. Start System Manager and connect to the server.
  2. In System Manager, right-click the server in the InterChange Server Component Management view and click Flow Manager.

Steps for finding unresolved flows

Perform the following steps in Flow Manager to find all unresolved flows:

  1. Start Flow Manager. See Steps for starting Flow Manager as a standalone tool or Steps for starting Flow Manager from System Manager.
  2. Do one of the following:
  3. After specifying your search criteria, click the Find button or click FlowManager > Event > Find. The results appear in the bottom half of the Flow Manager window.
  4. To save the current filter information as a query, click FlowManager > Query > Save. The query name you type appears in the Query list.
Event Attributes tab

Click the Event Attributes tab to search according to the characteristics of the unresolved event (see Figure 70).

Figure 70. Flow Manager Event Attributes tab

The following options are available from the Event Attributes tab:

Date & Time tab

Use the Date & Time tab to query only the flows that failed during a specific time period (see Figure 71).

Figure 71. Date & Time tab

The following options are available from the Date & Time tab:

Error Text & Business Object Attributes tab

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

Figure 72. Error Text & Business Object Attributes tab

Select values in the following columns:

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.

Steps for viewing details for unresolved flows

Perform the following steps to view details for unresolved flows in Flow Manager:

  1. Select a query from the Query list.
  2. Do one of the following:

    The results appear in the bottom half of the Flow Manager window.

    An unresolved flows table appears with a list of events and the following information:

    For the waiting events, the Event Status cell contains the following information:

    Waiting
    [timeout expiration:...]
    [scenario name:...]
    [scenario node ID...]

  3. To access more information about any of the events, double-click the row containing the event (or click FlowManager > Event > Select All). This opens the Show Event Details dialog box (see Figure 73).
    Figure 73. Flow Manager Show Event Details dialog box
  4. To access more information about the business object associated with the selected event, click FlowManager > Event > Display Details. The Show Business Object Data dialog box appears (see Figure 74).
    Figure 74. 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.

Steps for managing queries

Perform one of the following steps to manage queries you created for unresolved flows:

Steps for managing results of queries

Perform the following steps to manage queries you created for unresolved flows:

  1. In the results list in Flow Manager, select one or more events in the results list.
  2. Do one of the following:

Steps for processing unresolved flows

Perform the following steps to process any failed events in the results list in Flow Manager:

  1. In the results list in Flow Manager, select one or more events in the results list.
  2. Do one of the following:

Copyright IBM Corp. 2004, 2005