IM Relationship Resolution-Informationszentrale Version 4.2

Pipelinebefehlssyntax

Mit dem Pipelinebefehl können Sie Pipelines starten, stoppen und eine Fehlerbehebung für Pipelines ausführen. Dazu verwenden Sie Befehlsoptionen oder Parameter. Befehlszeilenoptionen, die Sie im Pipelinebefehl angeben, setzen alle entsprechenden Parameter außer Kraft, die in der Pipelinekonfigurationsdatei angegeben sind.

Die Syntax für den Pipelinebefehl lautet:

pipeline -option parameter

Pipelineoptionen und -parameter

Sie können diese Optionen zusammen oder separat verwenden.

-a syntax der transport-uri für den anwendungsmonitor
Gibt die Transportmethode an, die für den Anwendungsmonitor geöffnet werden soll.
-c name der pipelinekonfigurationsdatei
Gibt die Pipelinekonfigurationsdatei an, die Sie für die Pipeline verwenden wollen, die Sie starten. Befindet sich die Pipelinekonfigurationsdatei nicht in demselben Verzeichnis, aus dem Sie die Pipeline starten, können Sie den vollständigen Pfad und den Dateinamen angeben.
-d
Gibt an, dass diese Pipeline im Debugmodus und im Vordergrund ausgeführt werden soll.
Sie müssen eine Pipeline mit Hilfe der Option -s (Service-/Dämonmodus) oder mit der Option -d (Debugmodus) starten.
Anmerkung: Der Debugmodus sollte nicht in Produktionsszenarios verwendet werden, weil jede Aktion für diese Pipeline in den Protokolldateien protokolliert wird und dadurch eine Leistungsverschlechterung verursacht werden kann. Der Debugmodus kann jedoch in Testszenarios oder bei der Fehlerbehebung für eine Pipeline hilfreich sein.
-e
Stoppt die Ausführung der angegebenen Pipeline als UNIX-Dämonprozess oder als Windows-Dienst (Ausführung im Hintergrund). Werden auf dem Pipelineknoten mehrere Pipelines ausgeführt, müssen Sie mit der Option -n den Namen der Pipeline angeben, die Sie stoppen wollen.
Anmerkung: Wird die Pipeline, die Sie stoppen wollen, im Debugmodus ausgeführt, können Sie die Pipeline auch mit der Tastenkombination Strg + C im Befehlsfenster stoppen.
-f datendateiname
Lädt Daten aus der angegebenen Datei in die Pipeline.
Werden auf dem Pipelineknoten mehrere Pipelines ausgeführt, müssen Sie mit der Option -n den Namen der Pipeline angeben, in die Sie diese Daten laden wollen.
Wird eine Datei mit der Transportoption (-t) geladen, müssen Sie die Option -f nicht zusätzlich verwenden, weil die Transportoption den Dateinamen angibt.
-i
(Nur Windows-Plattformen) Installiert eine Pipeline als Windows-Dienst. Sobald die Pipeline als Windows-Dienst installiert wurde, können Sie die Pipeline mit der Option -s als Windows-Dienst ausführen.
Sie müssen die Installationsoption nur verwenden, wenn die Pipeline noch nie als Windows-Dienst installiert wurde oder wenn Sie die Deinstallationsoption verwendet haben.
-l
Listet den Status aller Pipelines auf dem Pipelineknoten oder den Status der Pipeline, deren Name mit der Option -n angegeben wurde, auf.
Gültige Statuswerte der Pipeline sind Gestoppt und Aktiv.
-n pipelinename
Gibt den Namen der Pipeline an. Diese Option ist nicht erforderlich, wenn Sie die ausführbare Standarddatei der Pipeline (pipeline) verwenden. Werden jedoch mehrere Pipelines auf demselben Pipelineknoten ausgeführt, müssen Sie einen eindeutigen Namen für jede Pipeline angeben.
Soll diese Pipeline überwacht oder sollen Ergebnisse von dieser Pipeline weitergeleitet werden, müssen Sie die Pipeline mit ihrem Namen in der Konfigurationskonsole auf der Indexzunge Knoten registrieren. Der Name, den Sie für die Pipeline in der Befehlszeile angeben, muss genau dem Pipelinenamen entsprechen, der in der Konfigurationskonsole registriert ist.
Diese Option wird häufig mit einer der anderen Pipelineoptionen verwendet, um den Namen der Pipeline anzugeben.
-s
Führt die Pipeline als UNIX-Dämonprozess oder als Windows-Dienst (wenn die Pipeline mit der Option -i als Windows-Dienst installiert wurde) im Hintergrundmodus aus. Sie müssen eine Pipeline mit Hilfe der Option -s (Service-/Dämonmodus) oder mit der Option -d (Debugmodus) starten.
Werden mehrere Pipelines ausgeführt, wird dieser Befehl üblicherweise in Verbindung mit der Befehlsoption -n verwendet, um den Namen der Pipeline anzugeben, die als Dämonprozess oder als Dienst ausgeführt werden soll.
-t transport-uri-syntax
Gibt die URI (Uniform-Resource-Identifier) der Transportmethode an, mit der die Pipeline ankommende Daten empfängt. Sie können mehrere Transportmethoden angeben, indem Sie mehrere -t-Optionen für Transport-URIs in derselben Befehlszeile eingeben.
Ist die Transportmethode noch nicht vorhanden, startet die Pipeline nicht.
Die meisten der unterstützten Transportmethoden enthalten Befehlssyntaxoptionen, mit denen Sie mehrere Pipeline-Threads starten können, um mehr Daten gleichzeitig zu verarbeiten.
-u
(Nur Windows-Plattformen) Deinstalliert eine Pipeline als Windows-Dienst.
Werden mehrere Pipelines ausgeführt, wird dieser Befehl üblicherweise in Verbindung mit der Option -n verwendet, um den Namen der Pipeline anzugeben, die als Dienst deinstalliert werden soll.

Pipelinebeispielbefehle

Der folgende Pipelinebefehl erstellt eine neue Pipeline, die auf einer Windows-Plattform ausgeführt wird, installiert die Pipeline als Windows-Dienst, startet den Windows-Dienst, ordnet der neuen Pipeline den Namen pipeline08 zu und startet die Pipeline:
pipeline -n pipeline08 -s

Der folgende Pipelinebefehl bewirkt, dass die Pipeline pipe12 Daten von einem HTTP-Server, einer Warteschlange mit dem Name queue22 und einer Datei mit dem Namen "data.umf" empfängt:

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

Der folgende Pipelinebefehl startet pipeline1 und verwendet die Pipelinekonfigurationsdatei "unixpipeline.ini":

pipeline -c unixpipeline.ini -n pipeline1
Zugehörige Tasks
Starten von Pipelines
Stoppen der Pipelines
Zugehörige Verweise
Prüfliste zur Fehlerbehebung für die Konfigurationskonsole


Feedback

Letzte Aktualisierung: 2007