Monitoring B2B Integration

This topic includes the following sections:

• Monitoring the B2B Engine

• Monitoring a Trading Partner

• Monitoring a Trading Partner Session

• Monitoring a Conversation Definition

• Monitoring a Collaboration Agreement

 

---

Monitoring the B2B Engine

To determine the current status of the B2B engine:

1. Click B2B, the top-level node in the navigation tree. Three high-level tabs (Configuration, Monitoring, and Notes) are displayed in the right pane.

2. Select the Monitoring tab. Select the General tab if it is not active. The following fields are displayed.

   Table 8-1 B2B Engine Status

   Field	Description
   Start this server <or> Shut down this server	Click the link displayed to either start or stop the B2B engine.
   Status	The current status of your B2B engine. The status is either Running or Inactive.
   Persistence	The current state of the persistence attribute for the B2B engine. Persistence is either on or off. If persistence is on, the B2B engine saves information about state that is required to recover the B2B engine in the event of a crash. If persistence is off, the B2B Engine does not save state information. Therefore, if a crash occurs, recovery is not possible.
   Activation Time	The time at which the B2B engine was last started. If the B2B engine is not running, the field reports N/A (not applicable).

   
    

Shutting Down the B2B Engine

To shut down the B2B engine:

1. Click B2B, the top-level node in the navigation tree, to display the Configuration tab.

2. Select the Monitoring tab in the right pane. If the General tab is not active, select it.

3. Click the Shut down this server link.

4. The system asks you to choose a shutdown method.

   Table 8-2 Shutdown Methods  

   Selection	Description
   Immediate	Stops all activity immediately.
   Terminate	Shuts down the B2B engine, triggers a shutdown of the trading partner sessions, causes all conversations to terminate, and removes all message queues. Note: Select Terminate as the shutdown method if you plan on importing repository data using the BulkLoader utility or the B2B Console after the B2B engine has been shutdown.

   
    

5. The B2B engine is shut down.

Viewing B2B Integration Statistics

To view B2B integration statistics:

1. Click B2B, the top-level node in the navigation tree.

2. Select the Monitoring tab in the right pane if it is not active. If the Statistics tab is not active, select it.

   Table 8-3 B2B Integration Statistics  

   Field	Description
   WLI B2B Active Since	Date and time at which the B2B engine was started.
   Trading Partner Sessions	Number of active trading partner sessions. (A trading partner is active when it has started a trading partner session.) Click the link to display a list of the relevant sessions for the trading partners you are monitoring.
   Active Collaboration Agreements	Number of active collaboration agreements. Active collaboration agreements are enabled and registered, and may be in use.
   Active Conversations	Number of active conversations.
   Active Delivery Channels	Number of active delivery channels for B2B integration. (A delivery channel is active when at least one trading partner is using it in a trading partner session.)
   Messages Sent	Number of messages sent by this instance of the B2B engine.
   Messages Received	Number of messages received by this instance of the B2B engine.
   Last Message Sent	Date and time the last message was sent by this instance of the B2B engine.
   Last Message Received	Date and time the last message was received by this instance of the B2B engine.

   
    

Viewing the B2B Integration Log

The B2B integration log contains all messages generated by the B2B engine. The severity of these messages ranges from Info to Fatal.

To view the B2B integration log entries:

1. Click B2B, the top-level node in the navigation tree, to display the Configuration tab.

2. Select the Monitoring tab in the right pane. If the Log tab is not active, select it. The following table describes the log tab fields on this tab.

   Table 8-4 Log Tab Fields  

   Field	Description
   Log File	Enter the name and location of the log file. The default name is wlc.log and the default location is the same directory from which the B2B engine was started.
   Level	Select, from the drop-down list, the severity of the messages you want retrieved from the log. The choices are as follows.
   	All	Displays all messages.
   	Info, Warning, Error, Fatal	Displays any message with INFO or greater severity.
   	Warning, Error, Fatal	Displays any message with Warning or greater severity.
   	Error, Fatal	Displays any message with Error or greater severity.
   	Fatal	Displays any message with Fatal severity.
   Lines Per Page	Select, from the drop-down list, the number of messages you want to retrieve from the log. Available choices are: 250 500 1000 5000 When the end of the log is reached, a Last Page message is sent.

   
    

 

---

Monitoring a Trading Partner

You can monitor trading partner sessions and trading partner Parties.

To monitor a trading partner session:

1. Do one of the following:

   • Click trading partners in the navigation tree to display the Trading Partner page, then locate and click the appropriate trading partner desired.

   • Click a trading partner listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Trading Partner tabs are displayed.

2. Select the Monitoring tab. Two tabs are displayed: Sessions and Delivery Channel.

3. Select the Sessions tab to display the trading partner sessions.

4. Select a trading partner session to monitor. To shut down this session, click the link  End this trading partner session.

Monitoring Session Conversations for a Trading Partner

To monitor the details of trading partner session conversations:

1. Do one of the following:

   • Click trading partners in the navigation tree to display the Trading Partner page, then locate and click the appropriate trading partner desired.

   • Click a trading partner listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Trading Partner tabs are displayed.

2. If the Monitoring tab is not active, select it. All trading partner sessions are listed.

3. To see details about a session, click the trading partner session link.

4. The number of trading partner conversations is displayed. Click the number to view additional details.

Listing Active Delivery Channels for a Trading Partner

To monitor the details of trading partner active delivery channels:

1. Do one of the following:

   • Click trading partners in the navigation tree to display the Trading Partner page, then locate and click the appropriate trading partner desired.

   • Click a trading partner listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Trading Partner tabs are displayed.

2. If the Monitoring tab is not active, select it. Select the Delivery Channels tab if it is not active. All Active delivery channels are displayed.

3. Click on a delivery channel for a detailed description of the delivery channel.

   To see details about a delivery channel, click the delivery channel link. For more information, see Monitoring Delivery Channels for a Trading Partner.

Monitoring Delivery Channels for a Trading Partner

To monitor the number of trading partner session delivery channels:

1. Do one of the following:

   • Click trading partners in the navigation tree to display the Trading Partner page, then locate and click the appropriate trading partner desired.

   • Click a trading partner listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Trading Partner tabs are displayed. If the Monitoring tab is not active, select it.

2. All delivery channels are listed. Select the Delivery Channels tab if it is not active. All active delivery channels are displayed.

3. Click the link to a delivery channel for details, as described in the following table.

   Table 8-5 Trading Partner Delivery Channels Fields  

   Field	Description
   Disable this Delivery Channel	Click this link to disable the selected delivery channel.
   Delivery Channel	The name of the selected delivery channel.
   Status	Indicates whether the selected delivery channel is active or shut down.
   Trading Partner Sessions	The number of active trading partner sessions. (A trading partner is active when it has started a trading partner session.) Click on the link for the number of sessions to display a list of the sessions. For more information, see Listing Conversations for a Trading Partner.
   Conversations	Displays the number of conversations in this session to date. Click on the link for the number of conversations for a list of the conversations. For more information, see Listing Conversations for a Delivery Channel.
   Collaboration Agreements	The collaboration agreements using this delivery channel. Click on the link for the number of collaboration agreements for a list of the collaboration agreements. For more information, see Listing Active Collaboration Agreements for a Delivery Channel.
   Messages Sent	The number of messages sent by this trading partner.

   
    

Shutting Down a Trading Partner Delivery Channel

To shut down a trading partner delivery channel:

1. Do one of the following:

   • Click trading partners in the navigation tree to display the Trading Partner page, then locate and click the appropriate trading partner desired.

   • Click a trading partner listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Trading Partner tabs are displayed.

2. If the Monitoring tab is not active, select it.

3. All trading delivery channels are listed. Select the Delivery Channel tab if it is not active.

4. Select a delivery channel. To disable this delivery channel, click the link  Disable this Delivery Channel.

 

---

Monitoring a Trading Partner Session

To monitor a trading partner session:

1. Do one of the following:

   • Click trading partners in the navigation tree to display the Trading Partner page, then locate and click the appropriate trading partner desired.

   • Click a trading partner listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Trading Partner tabs are displayed.

2. If the Monitoring tab is not active, select it.

3. All trading partner sessions are listed. Select the Sessions tab if it is not active.

4. Select a trading partner session. The fields displayed are described in the following table.

   Table 8-6 Monitoring Trading Partner Sessions  

   Field	Description
   Shut down this Trading Partner session	Click this link to shut down this trading partner session.
   Trading Partner Session Name	Name of this trading partner session.
   Status	Indicates whether the trading partner session is active or ended.
   Start Time	Time at which the current trading partner session began.
   Conversations	Number of active conversations for the current trading partner session. The link takes you to a list of conversations in this session.
   Messages Sent	The number of messages sent by the selected trading partner during the current session.
   Outstanding Messages	The number of messages outstanding (sent but not received—still in the queue). Click this link to display a list of outstanding messages in the current session.
   Last Message Sent	The date and time of the last message sent.
   Last Message Received	The date and time of the last message received.
   First Failed Message	The date and time of the first message that failed.
   Last Failed Message	The date and time of the last message that failed.

   
    

Listing Trading Partner Sessions

To list trading partner sessions:

1. Do one of the following:

   • Click trading partners in the navigation tree to display the Trading Partner page, then locate and click the appropriate trading partner desired.

   • Click a trading partner listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Trading Partner tabs are displayed. If the Monitoring tab is not active, select it. Then select the Session tab. A list of trading partner sessions is displayed.

2. Click on a trading partner session for a detailed description of the session. The trading partner session details are displayed. For information, see Monitoring a Trading Partner Session.

Listing Conversations for a Conversation Definition

To list conversations for a conversation definition:

1. Do one of the following:

   • Click conversations in the navigation tree to display the Conversations page, then locate and click the appropriate conversation definition desired.

   • Click a conversation listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Conversations tabs are displayed.

2. If the Monitoring tab is not active, select it.

   All conversation definitions associated with the conversation are listed.

3. Click on a conversation for a detailed description of the active conversation. The conversation details are displayed. For more information, see Monitoring a Conversation Definition.

Listing Conversations for a Trading Partner

To list conversations for a trading partner:

1. Do one of the following:

   • Click trading partners in the navigation tree to display the Trading Partner page, then locate and click the appropriate trading partner desired.

   • Click a trading partner listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Trading Partner tabs are displayed.

2. To view all conversations:

   • For a session, select the Sessions tab. Click on a trading partner session listed.

   • For a delivery channel, select the Delivery Channel tab. Click on a trading partner session listed.

3. Click on a conversation for a detailed description of the active conversation. The conversation details are displayed. For more information, see Monitoring a Conversation Definition.

Listing Conversations for a Delivery Channel

To list conversations for a delivery channel:

1. Do one of the following:

   • Click trading partners in the navigation tree to display the Trading Partner page, then locate and click the appropriate trading partner desired.

   • Click a trading partner listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Trading Partner tabs are displayed.

2. If the Monitoring tab is not active, select it. Then select the Delivery Channel tab. A list of active delivery channels is displayed.

3. Click on an active delivery channel for a detailed description. The active delivery channels details are displayed.

4. Click on the link to the number of active conversations. For more information, see Monitoring a Conversation Definition.

Listing Active Collaboration Agreements for a Delivery Channel

To list collaboration agreements for a delivery channel:

1. Do one of the following:

   • Click trading partners in the navigation tree to display the Trading Partner page, then locate and click the appropriate trading partner desired.

   • Click a trading partner listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Trading Partner tabs are displayed.

2. If the Monitoring tab is not active, select it. Then select the Delivery Channel tab. A list of active delivery channels is displayed.

3. Select a delivery channel. Details for the delivery channel are displayed.

4. Click the collaboration agreements number to display a list of active collaboration agreements.

For more information, see Displaying Collaboration Agreement Details for a Delivery Channel.

Listing Trading Partner Sessions for a Delivery Channel

To list trading partner sessions for a delivery channel:

1. Do one of the following:

   • Click trading partners in the navigation tree to display the Trading Partner page, then locate and click the appropriate trading partner desired.

   • Click a trading partner listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Trading Partner tabs are displayed.

2. If the Monitoring tab is not active, select it. Then select the Delivery Channel tab. A list of active delivery channels is displayed.

3. Click on the link to an active delivery channel. The delivery channel detail page is displayed. (For more information, see Monitoring Delivery Channels for a Trading Partner.)

4. Click on the number of Trading Partner Sessions. The Trading Partner Sessions for the selected delivery channel are displayed. For information on the trading partner sessions, see Monitoring a Trading Partner Session.

Displaying Collaboration Agreement Details for a Delivery Channel

To list collaboration agreements for a delivery channel:

1. Do one of the following:

   • Click trading partners in the navigation tree to display the Trading Partner page, then locate and click the appropriate trading partner desired.

   • Click a trading partner listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Trading Partner tabs are displayed.

2. Select the Monitoring tab and the Delivery Channel tab if it is not active. A list of active delivery channels is displayed.

3. Click on an active delivery channel. The Delivery Channel details page is displayed.

4. Click on the link to the number of active collaboration agreements. The list of active run-time collaboration agreements for the current delivery channel is displayed.

5. Click on a link to an active collaboration agreement. The fields in the following table are displayed.

   Table 8-7 Collaboration Agreement Fields  

   Field	Description
   Collaboration Agreement	The name of the selected collaboration agreement.
   Version	The version number of the collaboration agreement.
   Start Time	Time at which the current trading partner session began.
   Business Protocol	The business protocol used for this collaboration agreement.
   Conversation Definition	The name of the conversation definition being used in this collaboration agreement.
   Parties	The number of parties involved in this collaboration agreement.

   
    

For information about an active collaboration agreement in the list, see Monitoring Delivery Channels for a Trading Partner.

 

---

Monitoring a Conversation Definition

There are three ways to display active conversations for a conversation definition. For information about the first two methods, see Listing Conversations for a Trading Partner and Listing Conversations for a Delivery Channel.

To monitor tasks in conversation definitions:

1. Do one of the following:

   • Click conversations in the navigation tree to display the Conversations page, then locate and click the appropriate conversation definition desired.

   • Click a conversation listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Conversation Definition tabs are displayed.

2. Select the Monitoring tab for the selected conversation definition. A list of currently active conversations is displayed.

3. Select the conversation you want to monitor. The fields displayed are described in the following table.

   Table 8-8 Monitoring Conversations Fields

   Field	Description
   End this Conversation	Click this link to stop this conversation.
   Conversation	The name of this conversation.
   Start Time	Start time of this conversation.
   Participants	The number of participants in this conversation. Click this link to view a list of the participants.
   Last Message	The date and time the last message in this conversation was sent.
   Last Sender	The name of the trading partner who sent the last message.

   
    

 

---

Monitoring a Collaboration Agreement

There are two ways to monitor a collaboration agreement. For more information, see Listing Active Collaboration Agreements for a Delivery Channel.

To monitor a collaboration agreement:

1. Do one of the following:

   • Click collaboration agreement in the navigation tree to display the Collaboration Agreements page, then locate and click the appropriate collaboration agreement desired.

   • Click a collaboration agreement listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Collaboration Agreements tabs are displayed.

2. Select the Monitoring tab if it is not active. The Monitoring General tab contains the following read-only fields.

   Table 8-9 Collaboration Agreement Read-only Fields

   Field	Description
   Collaboration Agreement	The name of the selected collaboration agreement.
   Version	The version number of the collaboration agreement.
   Status	The collaboration agreement status. It can be either enabled or not, or registered or not.
   Business Protocol	The business protocol used for this collaboration agreement.
   Conversation Definition	The name of the conversation definition being used in this collaboration agreement.
   Parties	The number of parties involved in this collaboration agreement.

   
    

Enabling a Collaboration Agreement

Enabling a collaboration agreement means that the next time WebLogic Integrationis restarted, it will find the collaboration agreement and register it for you. Registering a collaboration agreement makes it immediately available to the other trading partners that need to start a business process using this agreement.

To enable a collaboration agreement:

1. Do one of the following:

   • Click Collaboration Agreements in the navigation tree to display the Collaboration Agreements page, then locate and click the appropriate collaboration agreement desired.

   • Click a collaboration agreement listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Collaboration Agreements tabs are displayed.

2. Select the Monitoring tab if it is not active. The Monitoring General tab is displayed.

3. Click the Enable this Collaboration Agreement link.

For information about monitoring a collaboration agreement, see Monitoring a Collaboration Agreement.

Disabling a Collaboration Agreement

Enabling a collaboration agreement means that the next time WebLogic Integration is restarted, it will find the collaboration agreement and register it for you. Registering a collaboration agreement makes it immediately available to the other trading partners that need to start a business process using this agreement. You can disable a collaboration agreement for use at another time.

To disable a collaboration agreement:

1. Do one of the following:

   • Click Collaboration Agreements in the navigation tree to display the Collaboration Agreements page, then locate and click the appropriate collaboration agreement desired.

   • Click a collaboration agreement listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab, as described in Displaying Entities in the Navigation Tree.)

   The Collaboration Agreements tabs are displayed.

2. Select the Monitoring tab if it is not active. The Monitoring General tab is displayed.

3. Click the Disable this Collaboration Agreement link.

For information about monitoring a collaboration agreement, see Monitoring a Collaboration Agreement.

Unregistering a Collaboration Agreement

Registering a collaboration agreement makes it immediately available to the other trading partners that need to start a business process using this agreement. Enabling a collaboration agreement means that the next time B2B integration is restarted, it will find the collaboration agreement and register it for you. You can unregister a collaboration agreement for use at another time.

To unregister a collaboration agreement:

1. Do one of the following:

   • Click Collaboration Agreements in the navigation tree to display the Collaboration Agreements page, then locate and click the appropriate collaboration agreement desired.

   • Click a collaboration agreement listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the WebLogic Integration B2B Console Preferences tab as described in Displaying Entities in the Navigation Tree.)

   The Collaboration Agreements tabs are displayed.

2. Select the Monitoring tab if it is not active. The Monitoring General tab is displayed.

3. Click the Unregister this Collaboration Agreement link.

For information about monitoring a collaboration agreement, see Monitoring a Collaboration Agreement.

Activating a Collaboration Agreement

New collaboration agreements are automatically activated when WebLogic Integration is restarted. You can also dynamically add a collaboration agreement without restarting WebLogic Integration.

To dynamically activate a collaboration agreement:

1. Do one of the following:

   • To display a list of existing collaboration agreements, click the Collaboration Agreements node in the navigation tree. Select a collaboration agreement from the list displayed, click Next to view additional entries, or use the search function to locate a specific collaboration agreement. Click the collaboration agreement link.

   • Click a collaboration agreement listed in the navigation tree. (This option is only available if the option Display entities on the navigation tree is checked on the Preferences tab, as described in Displaying Entities in the Navigation Tree.)

2. Select the Monitoring tab if it is not active. The Monitoring General tab is displayed.

3. Click Register this Collaboration Agreement.

For information about monitoring a collaboration agreement, see Monitoring a Collaboration Agreement.