Even though we also have scheduler capability to turn on/off a communication channel, this feature adds an option for us to control the communication channel externally, without using the scheduler or any XI tools (e.g. RWB), based on requirements that cannot be satisfied with a scheduler.
This capability also allow us to control a group of communication channels in one command.
To control the communication channels the HTTP GET or POST is used.
Prerequisites: the userid must have the proper role(s). The userid’s roles cannot be assigned using ABAP via SU01. The roles must be assigned in the J2EE, using the Visual Administrator.
- Start and logon to the J2EE Visual Administrator.
- Navigate to: Server 0 -> Services -> Security Provider
- In the screen on the right, select sap.com/com.sap.aii.af.app*AdapterFramework
- Select the tab: Security Roles
- Assign the userid to the roles:
- Query Status – xi_af_channel_admin_display
- Change Status – xi_af_channel_admin_modify
Below is a sample screenshot:
The following URL can be used to control the communication channel(s) externally:
The parameters in italics are described below:
- 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 service 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 can 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.
For example, to find the status of all the communication channels belonging to service=BLService, the following URL is used:
With the result:
By looking at a specific communication channel, File1_sender, in the RWB’s Communication Channel Monitoring, we will now stop it:
Please note, in order to use this feature, the External Control must be selected for the communication channel.
I will now stop it, or turn it off, by using the URL:
The result is as follow:
The communication channel is now stopped.
Please also note, once the External Control is turned on for the Communication Channel, we can no longer manually start or stop the communication channel using the RWB. We will have to turn the External Control off to do so.