IM Centre de documentation de Relationship Resolution, Version 4.2

Syntaxe de commande des pipelines

La commande des pipelines permet de démarrer, arrêter et déboguer des pipelines au moyen d'options ou de paramètres de commande. Les options de ligne de commande que vous indiquez comme composantes de la commande de pipeline supplantent tous les éventuels paramètres correspondants indiqués dans le fichier de configuration de pipeline.

La syntaxe de la commande de pipeline est la suivante :

pipeline -option paramètre

Options et paramètres de pipeline

Vous pouvez utiliser ces options ensemble ou séparément.

-a syntaxe d'URI de transport pour le moniteur d'application
Désigne le transport à ouvrir pour le moniteur d'application.
-c nom du fichier de configuration de pipeline
Désigne le fichier de configuration de pipeline que vous souhaitez utiliser avec le pipeline que vous démarrez. Si le fichier de configuration de pipeline ne se trouve pas dans le répertoire d'où vous démarrez le pipeline, vous pouvez en indiquer l'accès en tapant le chemin complet et le nom du fichier.
-d
Indique que vous voulez exécuter ce pipeline en mode débogage au premier plan.
Vous devez démarrer un pipeline à l'aide, soit de l'option -s (mode service/démon ), soit de l'option -d (mode débogage).
Remarque : Le mode débogage n'est pas recommandé en situation de production car il consigne chaque action de ce pipeline dans les fichiers journaux, ce qui peut nuire aux performances. Toutefois, le mode débogage peut s'avérer utile dans les scénarios test ou quand vous identifiez et résolvez des incidents liés à un pipeline.
-e
Arrête le pipeline désigné s'exécutant comme démon UNIX ou service Windows (en arrière-plan). Si plusieurs pipelines sont en train de s'exécuter sur le noeud de pipeline, vous devez appliquer l'option -n afin de désigner le nom du pipeline à arrêter.
Remarque : Si le pipeline à arrêter fonctionne en mode débogage, vous pouvez également l'arrêter en appuyant sur Ctrl + C dans la fenêtre de commande.
-f nom_ fichier_données
Charge les données du fichier indiqué dans le pipeline.
Si plusieurs pipelines sont en train de s'exécuter sur le noeud de pipeline, vous devez appliquer l'option -n pour indiquer le nom du pipeline dans lequel vous voulez charger ces données.
Si vous chargez un fichier à l'aide de l'option de transport(-t), vous n'avez pas besoin d'utiliser aussi l'option -f, car cette option indique le nom de fichier.
-i
(plateformes Windows uniquement) Installe un pipeline comme service Windows. Une fois que le pipeline a été installé comme service Windows, vous pouvez utiliser l'option -s pour exécuter le pipeline comme service Windows.
Il n'est nécessaire d'utiliser l'option d'installation que si le pipeline n'a jamais été installé comme service Windows ou si vous avez utilisé l'option de désinstallation.
-l
Affiche soit l'état de tous les pipelines du noeud, soit l'état du pipeline désigné nommément au moyen de l'option -n.
Les états possibles du pipeline sont Arrêté et En cours d'exécution.
-n nom_pipeline
Indique le nom du pipeline. Cette option n'est pas obligatoire si vous utilisez l'exécutable de pipeline par défaut (pipeline). Toutefois, si vous exécutez plus d'un pipeline sur le même noeud, vous devez attribuer un nom unique à chacun d'eux.
Si vous voulez superviser ce pipeline ou en acheminer les résultats, vous devez l'enregistrer nommément dans l'onglet Noeuds de la console de configuration. Le nom que vous attribuez au pipeline dans la ligne de commande doit concorder exactement avec le nom de pipeline enregistré dans la console de configuration.
Il est courant d'utiliser cette option avec n'importe laquelle des autres options de pipeline afin de désigner le pipeline par nom.
-s
Exécute le pipeline comme démon UNIX ou service Windows (si le pipeline a été installé comme service Windows au moyen de l'option -i) en mode arrière-plan. Vous devez démarrer un pipeline à l'aide, soit de l'option -s (mode service/démon ), soit de l'option -d (mode débogage).
Si vous exécutez plusieurs pipelines, il est courant d'utiliser cette commande avec l'option de commande -n pour désigner le nom du pipeline à exécuter comme démon ou service.
-t syntaxe_URI_transport
Désigne l'URI (Uniform Resource Identifier) du transport où le pipeline reçoit les données entrantes. Vous pouvez désigner plusieurs transports en tapant plusieurs URI de transport -t sur la même ligne de commande.
Si la méthode de transport n'existe pas encore, le pipeline ne démarre pas.
La plupart des transports compatibles comportent des options de syntaxe de commande qui permettent de démarrer plusieurs unités d'exécution de pipeline afin de traiter davantage de données simultanément.
-u
(plateformes Windows uniquement) Désinstalle le pipeline comme service Windows.
Si vous exécutez plusieurs pipelines, il est courant d'utiliser cette commande avec l'option -n pour désigner le nom du pipeline à désinstaller comme démon ou service.

Exemples de commandes de pipeline

La commande de pipeline suivante crée un pipeline s'exécutant sur une plateforme Windows, installe le pipeline comme service Windows, démarre le service Windows, nomme le nouveau pipeline pipeline08 et démarre le pipeline :
pipeline -n pipeline08 -s

La commande de pipeline suivante permet au pipeline nommé pipe12 de recevoir les données issues d'un serveur HTTP, d'une file d'attente nommée queue22 et d'un fichier nommé"data.umf" :

pipeline -n pipe12 -t http://server50:8888 -t mq:/queue22 -t file:/data.umf

La commande de pipeline suivante démarre le pipeline1 et utilise le fichier de configuration de pipeline nommé "unixpipeline.ini":

pipeline -c unixpipelinel.ini -n pipeline1
Tâches associées
Démarrage des pipelines
Arrêt des pipelines
Référence associée
Liste de vérification du dépannage de la console de configuration


Appréciations en retour

Dernière mise à jour : 2007