You can also show or hide the basic details of a communication channel selected in the table by choosing .
You can choose what information should be displayed in the table in the following ways:
- Use the Options dropdown list box to select the table size.
- Use the filtering functionality to narrow the search results.
While channels with Inactive status are started, they are inactive on all cluster nodes of a server cluster. This means that a channel is not processing any messages, even though it is 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).
Analyzing Communication Channel Details
When you select a communication channel, the system displays further information related to the status of the channel and its administration.
- 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) error> (yellow)inactive>running(green)>stopeed(gray)
> > >
A combination of Running or Inactive with Stopped statuses is not possible.
a) The processing details displayed for the selected cluster nodes provide current runtime information on message processing. Depending on the adapter used, the type and occurrence of the information can differ.
b) 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.
c) When you find a channel with errors you can search the Processing Details table for failed messages. To find more information, you can use the corresponding link in the Message ID column. The link leads to the message monitor, where you can find why the message failed and how to solve the issue. For more information, see Reviewing Search Results .
- 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.
- Using the Schedule tab, you can view whether the selected channel is active or inactive for a particular calendar date and time.
Managing Communication Channels
Select the communication channel.
It is also possible to select several communication channels at once.
Choose one or more of the following options:
Activate or deactivate external control. For more information, see Controlling a Communication Channel Externally .
If external control is deactivated, you can control the communication channel as follows:
Manually, by choosing Start and Stop .
Automatically with scheduled availability times. For more information, see Planning Channel Availability .
By choosing Automatic Control , you can schedule the availability times for communication channels that you want to control automatically and not manually.
For channels whose status is not Stopped , you can choose Ping Channel to check the status of the connection for the selected channel.
Planning Channel Availability
You can specify when a set of communication channels should be available so that the system can start and stop them automatically. This eases the management of the communication channels and reduces the need to manually start or stop a specific channel.
To plan the availability of a set of communication channels you can create a schedule. When necessary, you can change or delete existing availability schedules. You can also copy existing availability schedules and adapt them accordingly.
Prerequisites: The user account you use should be assigned to one of the Process Integration monitoring roles. For more information about which roles allow you to view and modify communication channel availability, see Monitoring Roles .
Do one of the following:
Open a browser and go to http://[host]:[port]/pimon to access the Process Integration tools. Then choose Start of the navigation path Monitoring Next navigation step Adapter Engine Next navigation step Communication Channel Monitoring End of the navigation path.
Open a browser and go to http://[host]:[port]/nwa to access SAP NetWeaver Administrator. Then choose Start of the navigation path SOA Next navigation step Monitoring Next navigation step PI Communication Channel Monitoring End of the navigation path.
Choose the Availability Planning tab.
The system displays all existing availability schedules in a table. The table contains the following information:
Creating Availability Schedules Choose New and select the scheduling interval.
Enter the scheduling details as follows: Make the necessary time specifications, and enter a suitable description.
If required, activate the schedule.
If the scheduling interval is recurring and not Once , the system displays the scheduled availability periods in the Entries tab page. You can exclude such individual entries explicitly and reschedule them as needed.
To select the communication channels to which the schedule should apply, choose the Communication Channels tab and do one of the following:
Select the required communication channels by using a selection filter.
To do this, enter search criteria and choose Use Filter . The system displays the channels found in the Scheduled Channels table.
The availability schedule is then valid for all these channels, including all channels that you create later, and those that are created by this filter. If you want a particular channel to be excluded from the current schedule you can move it to the Exemption Channels table.
Use an explicit list to assign communication channels to the availability schedule. For this, you should manually move all channels that should not be part of the schedule to the Exemption Channels table.
You can use the Switch to Filter with Exceptions and Switch to Explicit List buttons to switch between the two modes.
Save the availability schedule.
Changing Availability Schedules
The following are typical cases where you would like to change an availability schedule:
You want to change the availability times and would like this change to be applied to all affected communication channels.
You want to extend or restrict the affected communication channels for a defined availability schedule.
You want to change the availability times and the affected communication channels.
To modify an existing schedule, simply select it, modify its parameters, and save it
If you want to view when the selected availability schedule was last changed and by whom, go to the Log tab page.
Deleting Availability Schedules
If you have to delete an existing schedule, select it and then choose Delete .
Controlling a Communication Channel Externally
You can control communication channels externally, for example by connecting to an external scheduler. You switch to external control in the communication channel monitor. For more information, see Managing Communication Channels .
To query the status of communication channels, users must have the xi_af_channel_admin_display action assigned to them.
To start or stop communication channels, users must have the xi_af_channel_admin_modify action assigned to them.
Since none of these actions are assigned to a role in AS ABAP by default, you must explicitly assign them to a role in AS Java, which you then in turn assign to a user or a user group.
To control communication channels externally, you use an HTTP GET or POST request to the following URL:
The parameters in this request are as follows:
party:Identifies the party of the channel to be administered. You can use an asterisk (*) as a placeholder to administer several channels simultaneously.
service:Identifies the communication component of the channel to be administered. You can use an asterisk (*) as a placeholder to administer several channels simultaneously.
channel:Identifies the name of the channel to be administered. You can use an asterisk (*) as a placeholder to administer several channels simultaneously.
action:Identifies the action to be executed (start, stop, or status).
You use the start and stop actions to start and stop the channels. You can use the status action to query the status of one or more channels.