Monitoring Communication Channels 

Use

With the communication channel monitor you can call information about communication channels and administer communication channels that are set up for the selected Adapter Engine.

You can already tell the status of the communication channels from the result of the self-test of the selected Adapter Engine.

If the Adapter Engine runs on a server cluster, the communication channels comprise multiple instances for the various cluster nodes.

Prerequisites

You have started the central SAP NetWeaver Administrator for PI and have chosen Communication Channel Monitoring.

You can also use communication channel monitoring locally, if you use a non-central Adapter Engine.

For this, choose SOA Management → Monitoring →Communication Channel Monitoringin your local SAP NetWeaver Administrator.

Procedure

The monitor for communication channels provides two different modes for searching for communication documents:

●      Standard mode

●      Advanced mode

You can change the control of the communication channels displayed in both modes.

Searching in Standard Mode

In standard mode you can search for communication channels using name or status.

...

...

       1.      If required, enter the name of the communication channel to be searched for. You can enter an asterisk (*) here as a placeholder.

       2.      If required, enter a status to search for communication channels.

       3.      Start the search.

Searching in Advanced Mode

You can use additional selection criteria in advanced mode:

...

       1.      To navigate to advanced mode, choose Advanced in the standard mode.

       2.      Specify the required selection criteria.

If free entry is permitted, you can use an asterisk (*) as a placeholder. You can reset selected or entered values.

       3.      Start the search.

Select the communication channel whose control you want to change. It is also possible to select several communication channels at once.

You have the following options:

●      You can activate or deactivate external control.

●      If external control is deactivated, you can control the communication channel as follows:

○       Manually, by choosing Start and Stop

○       Automatically with scheduled availability times.

You cannot resend any messages that are sent to stopped channels. They are not rescheduled until the channel is started again.

●      By choosing Automatic Control, you can schedule the availability times for communication channels that you want to control automatically and not manually.

Result

The results table contains the communication channels found. You can update the information displayed. You can change the size of the display area.

The results table contains the following information:

Column	Meaning
Communication Channel	Name of the communication channel
Status	Status of the communication channel. The following statuses are possible: ●      Green (): Channel is started and functioning without errors. ●      Red (): Channel is started but errors have occurred. ●      Yellow (): Channel is started, but inactive. ●      Grey (): Channel is stopped. ●      Not Available (): Adapter is not registered; no information about channel available.
Short Log	Explains the status of the communication channel and, in the event of an error, the type of error that has occurred.
Control	Displays how the communication channel is controlled. ●      Manual You control the communication channel by choosing Start or Stop. ●      Automatic The communication channel is controlled by scheduled availability times. ●      External The communication channel is controlled by an HTTP request.
Processing Errors	Describes when the last processing errors occurred in the communication channel. If no errors occurred, the column remains empty.
Party	Displays the communication party (if available) that is specified in the communication channel.
Component	Displays the communication component that the communication channel is assigned to.
Adapter Type	Displays the type of adapter that has been selected and configured for the communication channel.
Namespace	Displays the namespace that contains the respective adapter type.
Direction	Specifies the direction of the communication channel: Sender or receiver channel.
Number of Nodes	Displays the number of nodes if the communication channel consists of multiple instances on different nodes of a server cluster.

Channels with a yellow status () are started, but are inactive on all cluster nodes of a server cluster. This means that a channel is not processing any messages, even though it has been started.

A channel has this status in the following cases:

■       The channel is configured as inactive in the Integration Directory (it can also only be reactivated in the Integration Directory).

■       The channel is set to inactive by the respective adapter (some adapters can do this and can also change this status if necessary).

When you select a communication channel, further information relating to the status of the channel and channel administration is also shown.

●      If the channel consists of multiple instances on different nodes of a server cluster, this information about the channel status is provided for each cluster node.

○       The information that is displayed for the status of a channel on the individual cluster nodes is information that is accumulated to give the overall status of the channel in the table of communication channels.

If the cluster nodes have at least one status that is above all other statuses in the status hierarchy, the channel receives this status as the overall status. The possible statuses correspond to those in the table of communication channels and have the following hierarchy:  (red),  (yellow),  (green), and  (gray). A combination of green or yellow with gray is not possible.

○       The processing details displayed for the selected cluster nodes are current runtime information on message processing. Depending on the adapter used, the type and occurrence of the information can differ.

This information forms the entry in the Processing Errors column in the table of communication channels. The newest result is taken from the table of the cluster nodes.

●      The information about channel administration displays when and by whom a channel was previously started or stopped.

You can only start or stop a communication channel for an entire server cluster, not on individual cluster nodes. However, since errors can occur on individual cluster nodes during the execution of these actions, error information is also displayed for each cluster node.

●      If the channel is controlled automatically, this means that the Availability Times tab page is displayed.

All other availability times that are relevant for this channel are also displayed. You can exclude specific availability times and, if necessary, reschedule them.

Since only active availability times are displayed, it is possible that availability times do exist for the selected communication channel even if none are displayed.

●      The information on the Configuration Settings tab page displays how often an attempt is made to send messages to this channel, and at what time intervals.

The default settings are taken from the outbound properties for the Java Service XPI Adapter: XI.. You can overwrite and save these values. You can also restore overwritten values.

Information about changes made to the settings is always displayed.

The Configuration Settings tab page is only relevant for receiver channels and is therefore only displayed for channels of this type.