XI_SET_CHANNEL

Startet und stoppt Kommunikationskanäle

Syntax

XI_SET_CHANNEL

Syntax

Beschreibung/Format

ACTION=

Aktion auf den Kommunikationskanal

Zulässige Werte: "START" und "STOP"

CHANNEL=

Name des Kommunikationskanals
Format des Werts: Script-Literal

Standardwert: "*"

Das Platzhalterzeichen "*" kann im Kanalnamen verwendet werden.

SERVICE=

Name des Services
Format des Werts: Script-Literal

Standardwert: "*"

Das Platzhalterzeichen "*" kann im Servicenamen verwendet werden.

PARTY=

Name des Partners
Format des Werts: Script-Literal

Standardwert: "*"

Das Platzhalterzeichen "*" kann im Servicenamen verwendet werden.

NOFOUND=

Vorgehen, wenn keine Kommunikationskanäle gefunden werden, die den Filterkriterien entsprechen.
Format des Wertes: Script-Literal

Zulässige Werte: "NORMAL" (Standardwert) oder "ABEND"
"NORMAL" =  Der AE-Job wird fortgesetzt.
"ABEND" = Der AE-Job endet vorzeitig.

ERROR=

Vorgehen, wenn die Aktion für einen der Kommunikationskanäle nicht durchgeführt werden kann.

Zulässige Werte: "IGNORE" und "ABEND" (Standardwert)
"IGNORE" =  Der AE-Job wird fortgesetzt.
"ABEND" = Der AE-Job endet vorzeitig.

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 er aufgrund der gewählten Kommunikationskanäle nicht gestartet oder gestoppt werden kann. Aufgrund des Schnittstellenverhaltens wendet der Agent ACTION= trotzdem bei allen weiteren Kommunikationskanälen an.

Die Information zum Kommunikationskanal, der nicht gesteuert werden konnte, wird als XML-Dokument im Job-Report hinterlegt. Weitere Informationen zum Lesen dieser Daten finden Sie unter Script-Funktionen für XML-Elemente.

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:
Der Kanal "/SenderList/SenderChannel (GUID f2d7791276e8388b995afd2d7a22e1b0)"
ist so konfiguriert, dass er einen Automatisierungsmodus verwendet, der nicht kompatibel mit dem Typ des
aktuellen Prinzipals (WSUSER) ist. Der Kanal wurde nicht gestartet. Ändern Sie den
Automatisierungsmodus des Kanals und wiederholen Sie die Administratoraktion.
</ErrorInformation>
</Channel>
</Channels>
</Report>

Beispiel

Das Beispiel startet einen Kommunikationskanal, der nach Namen und Service gefiltert wird.

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

Ein Kommunikationskanal wird gestoppt:

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

Siehe auch: