XI_SET_CHANNEL

Verwenden Sie das Script-Element XI_SET_CHANNEL, um einen oder mehrere Kommunikationskanäle zu starten und anzuhalten. Sie können einen bestimmten Kommunikationskanal definieren oder nach mehreren filtern, indem Sie die Parameter CHANNEL=, SERVICE= und PARTY= verwenden.

Syntax

XI_SET_CHANNEL

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

Parameter

  • XI_SET_CHANNEL
    Startet und stoppt Kommunikationskanäle

  • ACTION=
    Definiert die Aktion, die für den Kommunikationskanal stattfinden soll
    Zulässige Werte:

    • START
    • STOP

  • CHANNEL=
    (Optional) Definiert den Namen des Kommunikationskanals. Sie können das Platzhalterzeichen * im Kanalnamen verwenden.
    Format: Script-Literal
    Standardwert: *

  • SERVICE=
    (Optional) Name des Services. Sie können das Platzhalterzeichen * im Servicenamen verwenden.
    Format: Script-Literal
    Standardwert: *

  • PARTY=
    (Optional) Name des Partners. Sie können das Platzhalterzeichen * im Partnernamen verwenden.
    Format: Script-Literal
    Standardwert: *

  • NOFOUND=
    (Optional) Definiert die Verarbeitung, wenn kein Kommunikationskanal gefunden wird, der die angegebenen Filterkriterien erfüllt.
    Format: Script-Literal
    Zulässige Werte:

    • NORMAL (Standard)
      Der AE-Job wird fortgesetzt
    • ABEND
      Der AE-Job endet vorzeitig.

  • ERROR=
    (Optional) Definiert die Verarbeitung, wenn die definierte Aktion nicht in einem der Kommunikationskanäle verarbeitet werden kann.
    Zulässige Werte:

    • ABEND (Standard)
      Der AE-Job endet vorzeitig
    • IGNORE
      Der AE-Job wird fortgesetzt

    Wenn ein Job aufgrund der ausgewählten Kommunikationskanäle nicht gestartet oder beendet werden kann, können Sie den Parameter ERROR= verwenden, um diesen Job abzubrechen. Aufgrund des Schnittstellenverhaltens wendet der Agent ACTION= trotzdem bei allen weiteren Kommunikationskanälen an. Informationen über Kommunikationskanäle, die nicht gestartet oder beendet werden konnten, werden im Auftragsreport als XML-Dokument gespeichert. 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 folgende Beispiel startet einen Kommunikationskanal, der nach Name und Dienst 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: