Automation Engine Script-Leitfaden > AE JCL für Anwendungen > SAP > XI_SET_CHANNEL

XI_SET_CHANNEL

Startet und stoppt Kommunikationskanäle.

Syntax

XI_SET_CHANNEL

ACTION=...
[CHANNEL=...]
[,SERVICE=...]
[,PARTY=...]
[,NOFOUND=...]
[,ERROR=...]

Syntax	Beschreibung/Format
ACTION=	Aktion auf den Kommunikationskanal Erlaubte Werte: "START" und "STOP"
CHANNEL=	Name des Kommunikationskanals Format des Wertes: Script-Literal Standardwert: "" Es kann das Wildcardzeichen "" im Channelnamen verwendet werden.
SERVICE=	Name des Dienstes Format des Wertes: Script-Literal Standardwert: "" Es kann das Wildcardzeichen "" im Servicenamen verwendet werden.
PARTY=	Name des Partners Format des Wertes: Script-Literal Standardwert: "" Es kann das Wildcardzeichen "" im Partnernamen verwendet werden.
NOFOUND=	Behandlung, wenn keine Kommunikationskanäle, die den Filterkriterien entsprechen, gefunden werden. Format des Wertes: Script-Literal Erlaubte Werte: "NORMAL" (Standardwert) oder "ABEND" "NORMAL" = Der AE-Job läuft weiter. "ABEND" = Der AE-Job endet abnormal.
ERROR=	Behandlung, wenn einer die Aktion für einen der Kommunikationskanäle nicht durchgeführt werden kann. Erlaubte Werte: "IGNORE" und "ABEND" (Standardwert) "IGNORE" = Der AE-Job läuft weiter. "ABEND" = Der AE-Job endet abnormal.

Kommentare

Die Funktion kann einen oder mehrere Kommunikationskanäle starten bzw. stoppen. Geben Sie bei den Parametern CHANNEL=, SERVICE= und PARTY= entweder gezielt einen Kommunikationskanal oder Filter für mehrere Kommunikationskanäle an.

Mit dem Parameter ERROR= können Sie den Job abbrechen, wenn auf einen der selektierten Kommunikationskanäle der Start bzw. Stop nicht durchführbar ist. Aufgrund des Schnittstellenverhaltens wendet der Agent die ACTION= trotzdem bei allen weiteren Kommunikationskanälen an.

Die Information zum Kommunikationskanal, der nicht gesteuert werden konnte, wird als XML-Dokument im Jobreport hinterlegt. Es kann mit den Script-Sprachmitteln für XMLsausgelesen werden.

Beispiel für die XML-Ausgabe in den Report:

<Report>
<Channels>
<Channel>
<Party/>
<Service>SenderList</Service>
<ChannelName>SenderChannel</ChannelName>
<ChannelID> f2d7791276e8388b995afd2d7a22e1b0</ChannelID>
<ActivationState>STARTED</ActivationState>
<ChannelState>OK</ChannelState>
<ErrorInformation>
com.sap.aii.af.service.administration.impl.WrongAutomationModeException:
The channel "/SenderList/SenderChannel (GUID f2d7791276e8388b995afd2d7a22e1b0)"
is configured to use an automation mode that is not compatible with the type of the
current principal (WSUSER). The channel was not started. Change the channel's
automation mode and repeat the administrative action.
</ErrorInformation>
</Channel>
</Channels>
</Report>

Beispiel

Das Beispiel startet einen Kommunikationskanal, der über den Namen und das Service gefiltert wird.

XI_SET_CHANNEL ACTION='START',CHANNEL=' File_Sender_List',SERVICE=' SenderList',PARTY='*'

Hier wird ein Kommunikationskanal gestoppt.

XI_SET_CHANNEL ACTION='STOP',CHANNEL='SenderChannel',SERVICE=' SenderList',PARTY='*'

Siehe auch:

XI_GET_CHANNEL

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support