bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

Administering B2B

Monitoring B2B Integration

This section provides an overview of how you can use the B2B Console to monitor and control WebLogic Integration, trading partner sessions, delivery channels, conversations, and collaboration agreements. It includes the following topics:

- Overview of Monitoring

- Note About Conversation Monitoring

- B2B Console Monitoring Pages

- Monitoring the B2B Engine

- Monitoring Trading Partner Sessions

- Monitoring Delivery Channels

- Monitoring Conversations (Deprecated)

- Monitoring Collaboration Agreements

- Monitoring Messages

Note: The XOCP and cXML protocols are deprecated as of this release of WebLogic Integration. For information about the features that are replacing XOCP and cXML, see the BEA WebLogic Integration Release Notes.

Overview of Monitoring

The WebLogic Integration B2B Console enables you to control and monitor the following entities:

- B2B engine—WebLogic Integration process that provides and controls functionality for B2B integration.

- Trading partner session—Connections between trading partner delivery channels. One or more conversations may be associated with a single connection.

- Delivery channels—Connection endpoints in a trading partner session.

- Conversations—Exchange of messages associated with trading partner delivery channels and roles defined in a collaboration agreement.

- Collaboration agreements—Contracts in which trading partners specify the parameters of their message exchanges.

Note About Conversation Monitoring

The primary benefit of being able to monitor conversations from the B2B Console is that it makes it possible for a conversation initiator to terminate a conversation and for other participants to exit the conversation.

cXML and RosettaNet conversations, which are not monitored via the B2B Console, do not support this conversation termination feature. The ability to view a list of conversations and select one to be either terminated (from the B2B engine running on the initiating trading partner system) or exited (from the B2B engine running on the participant system) is limited to the XOCP protocol.

In RosettaNet and cXML, control resides at the level of the delivery channel and the trading partner session. Throughout this section, any reference to the display of conversations applies to XOCP delivery channels and trading partner sessions only.

B2B Console Monitoring Pages

Monitoring functions can be invoked from the Monitoring tab, which, in turn, is available from the pages of the WebLogic Integration B2B Console listed in the following table.

Table 5-1 Accessing the B2B Console Pages

This page . . . | Is displayed in the B2B Console when you select . . .
--- | ---
B2B page | B2B from the navigation tree
Trading partner page | A trading partner from either the navigation tree or the Trading Partners page.
Conversation page | A conversation definition from either the navigation tree or the Conversations page.
Collaboration agreement page | A collaboration agreement from either the navigation tree or the Collaborations Agreements page.

For a detailed description of the B2B Console, including its support for monitoring tasks, see Overview of WebLogic Integration B2B Console.

The following table summarizes the functions available on each page.

Table 5-2 Monitoring WebLogic Integration

Select the Monitoring tab on the . . . | Then select this nested tab . . . | To access these functions . . .
--- | --- | ---
B2B page | General | Status (running or inactive). Shutdown or Restart (depending on the current status of the B2B engine).
Statistics | Summary statistics (number of trading partner sessions, active collaboration agreements, active conversations, active delivery channels, and messages sent and received, and time of the last message sent and received).
Log | View the B2B engine log. Set view options for the log (level of logging, number of lines per page).
Trading partner page | Sessions | View a list of run-time sessions for the selected trading partner (session identifier and start time are listed). View the details of a selected session (status, start time, number of conversations, number of messages sent, number of messages outstanding, times at which messages were last sent and received, times of first and last failed message). From the details about a selected session, link to a list of either the constituent conversations or the outstanding messages.
Delivery Channels | View a list of the delivery channels associated with the selected trading partner. View details about a selected delivery channel (status, trading partner sessions, conversations, collaboration agreements, messages sent). From the details about a selected delivery channel, modify the status (enable or disable) or link to a list of trading partner sessions, collaboration agreements, conversations, or messages sent. For each list, additional detail is available.
Conversation page | General | View a list of the active conversations for the selected conversation definition. (A conversation identifier and the start time are listed.) View details of a selected conversation (start time, self-initiated indicator, time of last message, identity of last sender). End/Leave a conversation. These features are available only for XOCP. See Note About Conversation Monitoring.
Collaboration agreement page | General | View identifying information (name, version, business protocol, associated conversation definition, and number of parties) View the status (enabled/disabled, registered/unregistered) Modify the status (enable/disable, register/unregister)

The following sections provide an overview of each type of entity you can monitor from the WebLogic Integration B2B Console. The detailed information required to navigate the B2B Console to view available monitoring options is provided in the online help. See Getting Help.

Monitoring the B2B Engine

When you select B2B from the navigation tree, a set of three high-level tabs (Configuration, Monitoring, and Notes) is displayed in the right pane. If you select the Monitoring tab, and then select the nested General tab, the General tab is displayed as shown in the following figure.

Figure 5-1 General Tab for Monitoring the Server

Status information and the time at which the server started are displayed.

To shut down the server, select Shut down this server. The Terminate shutdown option is displayed. This option shuts down active delivery channels, triggering the termination of the associated trading partner sessions. The termination of the trading partner sessions triggers, in turn, the termination of associated conversations and the removal of queues.

Note: For information about shutting down the B2B engine, see Starting and Stopping the B2B Engine from the B2B Console in Starting, Stopping, and Customizing BEA WebLogic Integration.

To display summary statistics for your server, select the Statistics tab, as shown in the following figure.

Figure 5-2 Server Statistics

Monitoring Trading Partner Sessions

A trading partner session is a connection between trading partner delivery channels. WebLogic Integration supports two options for listing active trading partner sessions:

- List the trading partner sessions for a selected trading partner
  To do so, select a trading partner from the navigation tree or Trading Partners page. Then, in the right pane, select the Monitoring tab. Finally, select the Sessions tab. A list of active trading partner sessions for the specified trading partner is displayed.

- List the trading partner sessions for a selected delivery channel
  To do so, select a trading partner from the navigation tree or Trading Partners page. Then, in the right pane, select the Monitoring tab. Finally, select the Delivery Channels tab. A list of the active delivery channels for the specified trading partner is displayed.

As described in Monitoring Delivery Channels, the number of trading partner sessions for the specified delivery channel is displayed as one of the summary statistics for the delivery channel. You can view a list of the trading partner sessions for the delivery channel by clicking that number.

When you select a trading partner session from a list of sessions, the following information is displayed.

Figure 5-3 Monitoring a Trading Partner Session

Summary statistics for the trading partner session are displayed. From the summary, you can link to either a list of the active conversations for the session or a list of the outstanding messages for it.

Note: For successful deployment, the delivery channel endpoints for the session must be bound to the same business protocol. (Protocol binding is assigned in the document exchange assigned to the delivery channel.)

To shut down a trading partner session, select Shut Down this Trading Partner session. Shutdown of the trading partner session triggers termination of the associated conversations and removal of queues.

Monitoring Delivery Channels

A delivery channel is a connection endpoint in a trading partner session. To display a list of the active delivery channels for a trading partner, complete the following procedure:

1. Select a trading partner from the Trading Partners page or the navigation tree.

2. Select the Monitoring tab, and then select the Delivery Channels tab.

When you select a delivery channel from the list, the following types of information are displayed.

Figure 5-4 Monitoring a Delivery Channel

Status information and summary statistics for the designated delivery channel are displayed. From the summary, you can link to lists of trading partner sessions, collaboration agreements, conversations, and messages sent.

You can disable a delivery channel by selecting Disable this Delivery Channel. Disabling a delivery channel triggers termination of all active trading partner sessions associated with the delivery channel. Termination of the trading partner sessions, in turn, triggers termination of the associated conversations and removal of queues.

Monitoring Conversations (Deprecated)

Note: As discussed in Note About Conversation Monitoring, support for monitoring conversations is available only for XOCP trading partner sessions.

WebLogic Integration allows you to display a list of the active XOCP conversations for three entities: conversations, delivery channels, and trading partner sessions. Follow the appropriate instructions in the following table.

Table 5-3 Listing Conversations

To list conversations for a particular . . . | Perform the following steps . . .
--- | ---
Conversation definition | 1. Select a conversation definition from the navigation tree or Conversations page. 2. Select the Monitoring tab. A list of active conversations for the designated conversation definition is displayed.
Delivery channel | 1. List the delivery channels as described in Monitoring Delivery Channels. When you select a delivery channel from the list, the number of conversations for that delivery channel is displayed as one of the summary statistics for the delivery channel. 2. To view a list of the conversations for the specified delivery channel, click the number representing the number of conversations in the summary statistics.
Trading partner session | 1. List trading partner sessions as described in Monitoring Trading Partner Sessions. When you select a trading partner session from the list, the number of conversations for that session is displayed as one of the summary statistics for the trading partner session. 2. To view a list of the conversations for the specified delivery channel, click the number representing the number of conversations in the summary statistics.

When you select a conversation from a list, the following is displayed.

Figure 5-5 Monitoring a Conversation

The following information is displayed: identifying information, the starting time, a self-initiated indicator, the time of the last message, and the identity of the last sender.

If the local trading partner initiates the conversation, that trading partner can end the conversation by selecting End this Conversation.

If the local trading partner does not initiate the conversation, the trading partner can leave the conversation by selecting Leave this Conversation.

Monitoring Collaboration Agreements

A collaboration agreement specifies the trading partners, delivery channels, and roles that define a specific interaction. You can view collaboration agreement status by selecting a collaboration agreement from the navigation tree or the Collaboration Agreements page, and then selecting the Monitoring tab.

The status of a collaboration agreement is displayed as shown in the following figure.

Figure 5-6 Monitoring a Collaboration Agreement

The information displayed includes the following: identifying information, status information, the business protocol, the conversation definition, and the number of parties.

For successful deployment, a collaboration agreement must include two parties, and both of the delivery channel endpoints assigned in the collaboration agreement must be bound to the same business protocol. (Protocol binding is assigned in the document exchange assigned to a delivery channel.)

If a collaboration agreement specifies a spoke delivery channel for the local trading partner, the agreement cannot be deployed successfully until the hub delivery channel is up and running.

You always have the option of reversing the status of a collaboration agreement:

- You can disable an enabled collaboration agreement by selecting Disable this Collaboration Agreement.

- You can enable a disabled collaboration agreement by selecting Enable this Collaboration Agreement.

When you disable a collaboration agreement, existing conversations are completed, but no new conversations for that agreement can be started, and no new participants can be added to existing conversations.

Similarly, you can register an unregistered collaboration agreement or unregister a registered collaboration agreement by selecting Register this Collaboration Agreement or Unregister this Collaboration Agreement, respectively. Unregistering a collaboration agreement triggers termination of all active conversations associated with the collaboration agreement.

You can also view the status of collaboration agreements for a delivery channel, as follows:

1. Display a list of delivery channels by performing the steps described in Monitoring Delivery Channels.

2. Select a delivery channel from the list. The number of collaboration agreements for that delivery channel is displayed in the summary statistics for the delivery channel.

3. View a list of the collaboration agreements for that delivery channel by clicking the link in the number of collaboration agreements.

4. From the list, select a collaboration agreement for which you want to see status information like the information shown in the following figure.

   Figure 5-7 Monitoring a Collaboration Agreement

In this case, you cannot disable or unregister the collaboration agreement.

Monitoring Messages

To display a list of the outstanding messages for a trading partner session, complete the following procedure:

1. Display a list of trading partner sessions. (For instructions, see Monitoring Trading Partner Sessions.)

2. Select a trading partner session from the list.

   When you make your selection, the number of outstanding messages for the selected trading partner session is displayed in the summary statistics for that session.

3. To display a list of outstanding messages for the designated trading partner session, click the number (in the summary statistics) representing the total number of outstanding messages.

When you select a message from a list, the following information is displayed: identifying information, the date and time at which the message was sent, and the size of the message.