Manuel des Scripts Automation Engine > JCL AE pour les applications > SAP > XI_SET_CHANNEL

XI_SET_CHANNEL

Démarre et arrête les canaux de communication.

Syntaxe

XI_SET_CHANNEL

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

Elément de syntaxe

Description/format

ACTION=

Action appliquée au canal de communication

Valeurs autorisées : "START" et "STOP"

CHANNEL=

Nom du canal de communication
Format de la valeur : Littéral de Script

Valeur par défaut : "*"

Vous pouvez utiliser le caractère générique "*" dans le nom de canal indiqué.

SERVICE=

Nom du service
Format de la valeur : Littéral de Script

Valeur par défaut : "*"

Vous pouvez utiliser le caractère générique "*" dans le nom de service indiqué.

PARTY=

Nom du partenaire
Format de la valeur : Littéral de Script

Valeur par défaut : "*"

Vous pouvez utiliser le caractère générique "*" dans le nom de partenaire indiqué.

NOFOUND=

Comportement adopté si aucun canal de communication correspondant aux critères de filtrage n'est trouvé.
Format de la valeur : Littéral de Script

Valeurs autorisées : "NORMAL" ou "ABEND" (valeur par défaut)
"NORMAL" =  Le Job se poursuit.
"ABEND" =  Le Job se termine anormalement.

ERROR=

Comportement adopté si l'action appliquée à l'un des canaux de communication ne peut pas être exécutée.

Valeurs autorisées : "IGNORE" ou "ABEND" (valeur par défaut)
"IGNORE" =  Le Job se poursuit.
"ABEND" =  Le Job se termine anormalement.

Remarques

La fonction permet de démarrer ou d'arrêter un ou plusieurs canaux de communication. Utilisez les paramètres CHANNEL=, SERVICE= et PARTY= pour indiquer un canal de communication précis ou le filtre pour désigner plusieurs canaux de communication.

Le paramètre ERROR= permet d'interrompre le Job s'il est impossible de démarrer ou d'arrêter l'un des canaux de communication sélectionnés. En raison du comportement des interfaces, l'Agent applique néanmoins l'action définie dans le paramètre ACTION= à tous les autres canaux de communication.

Les informations sur le canal de communication qui n'a pas pu être traité sont enregistrées sous la forme d'un document XML dans le rapport de Job. Vous pouvez le lire à l'aide des éléments de script pour les documents XML.

Exemple de sortie XML dans le rapport :

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

Exemple

L'exemple démarre un canal de communication sélectionné par le biais de son nom et de celui du service.

XI_SET_CHANNEL ACTION='START',CHANNEL=' File_Sender_Liste',SERVICE=' SenderListe',PARTY='*'

Dans ce Script, un canal de communication est arrêté.

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

 

Rubriques connexes : 

XI_GET_CHANNEL