Command Reference > Pmcmd-Befehlsreferenz > StartTask
  

StartTask

Startet eine Aufgabe.
Der Befehl StartTask verwendet die folgende Syntax im Befehlszeilenmodus:
pmcmd StartTask

<<-service|-sv> service [<-domain|-d> domain] [<-timeout|-t> timeout]>

<<-user|-u> username|<-uservar|-uv> userEnvVar>

<<-password|-p> password|<-passwordvar|-pv> passwordEnvVar>

[<<-usersecuritydomain|-usd> usersecuritydomain|<-usersecuritydomainvar|-usdv> userSecuritydomainEnvVar>]

[<-folder|-f> folder]

<-workflow|-w> workflow

[<-paramfile> paramfile]

[-wait|-nowait]

[<-recovery|-norecovery>]

[<-runinsname|-rin> runInsName]

taskInstancePath
Der Befehl StartTask verwendet die folgende Syntax im interaktiven Modus:
pmcmd StartTask

[<-folder|-f> folder]

<-workflow|-w> workflow

<-paramfile> paramfile]

[-wait|-nowait]

[<-recovery|-norecovery>]

[<-runinsname|-rin> runInsName]

taskInstancePath
In der folgenden Tabelle werden pmcmd StartTask-Optionen und -Argumente beschrieben:
Option
Argument
Beschreibung
-service
-sv
service
Erforderlich. Name des Integration Service.
-domain
-d
domain
Optional. Domänenname.
-timeout
-t
timeout
Optional. Zeitraum (in Sekunden), während dem pmcmd versucht, eine Verbindung mit dem Integration Service herzustellen.
Wurde die -timeout-Option weggelassen, verwendet pmcmd den in der Umgebungsvariable INFA_CLIENT_RESILIENCE_TIMEOUT verwendeten Timeout-Wert. Wenn die Umgebungsvariable nicht festgelegt wurde, verwendet pmcmd den standardmäßigen Timeout-Wert. Die Standardeinstellung ist "180".
-user
-u
username
Erforderlich im Befehlszeilenmodus, wenn Sie die Benutzername-Umgebungsvariable nicht angeben. Benutzername. Wird im interaktiven Modus nicht verwendet.
-uservar
-uv
userEnvVar
Gibt die Benutzername-Umgebungsvariable an.
Erforderlich im Befehlszeilenmodus, wenn Sie den Benutzernamen nicht angeben. Wird im interaktiven Modus nicht verwendet.
-password
-p
passwort
Erforderlich im Befehlszeilenmodus, wenn Sie die Passwort-Umgebungsvariable nicht angeben. Passwort. Wird im interaktiven Modus nicht verwendet.
-passwordvar
-pv
passwordEnvVar
Erforderlich im Befehlszeilenmodus, wenn Sie das Passwort nicht angeben. Passwort-Umgebungsvariable. Wird im interaktiven Modus nicht verwendet.
-usersecuritydomain
-usd
usersecuritydomain
Optional im Befehlszeilenmodus. Erforderlich, wenn Sie LDAP-Authentifizierung verwenden. Name der Sicherheitsdomäne, zu der der Benutzer gehört. Wird im interaktiven Modus nicht verwendet. Die Standardeinstellung ist "Native".
-usersecuritydomainvar
-usdv
userSecuritydomainEnvVar
Optional im Befehlszeilenmodus. Sicherheitsdomäne-Umgebungsvariable. Wird im interaktiven Modus nicht verwendet.
-folder
-f
folder
Erforderlich, wenn der Name des Arbeitsablaufs im Repository nicht eindeutig ist. Name des Ordners, der den Arbeitsablauf enthält.
-workflow
-w
arbeitsablauf
Erforderlich. Name des Arbeitsablaufs.
-paramfile
paramfile
Optional. Bestimmt die bei Ausführung einer Aufgabe oder eines Arbeitsablaufs zu verwendende Parameterdatei. Sie überschreibt die konfigurierte Parameterdatei für den Arbeitsablauf oder die Aufgabe.
-warten
-nowait
-
Optional. Konfiguriert den Wartemodus:
  • - warten. Sie können einen neuen pmcmd-Befehl erst eingeben, wenn der Integration Service den vorherigen Befehl ausgeführt hat.
  • - nowait. Sie können einen neuen pmcmd-Befehl eingeben, wenn der Integration Service den vorherigen Befehl empfangen hat.
Als Standardwert wird nowait verwendet.
-recovery
-norecovery
-
Optional. Handelt es sich bei der Aufgabe um eine Sitzung, führt der Integration Service die Sitzung basierend auf der konfigurierten Wiederherstellungsstrategie aus.
  • - recovery. Bei Echtzeitsitzungen, die für die Wiederherstellung aktiviert sind, stellt der Integration Service die fehlgeschlagene Sitzung wieder her und beendet die Ausführung der verbleibenden Aufgaben im Arbeitsablauf.
  • Die Wiederherstellungsoption stimmt mit der Recover Task-Option im Workflow Manager überein. Diese Option ist nicht anwendbar auf Sitzungen, für die keine Wiederherstellung aktiviert wurde.
  • - norecovery. Bei Echtzeitsitzungen, die für die Wiederherstellung aktiviert sind, verarbeitet der Integration Service keine Wiederherstellungsdaten. Der Integration Service löscht vor dem Neustart der Aufgabe den Betriebsstatus sowie die Wiederherstellungsdatei oder -tabelle. Bei Sitzungen, für die keine Wiederherstellung aktiviert wurde, löscht der Integration Service den Betriebsstatus und startet die Aufgabe neu.
  • Die Norecovery-Option stimmt mit der Cold Start Task-Option im Workflow Manager überein.
Wenn Sie keine Optionen für Sitzungen bereitstellen, die für die Wiederherstellung aktiviert sind, führt der Integration Service die Sitzung im Recovery-Modus aus. Wenn Sie keine Optionen für Sitzungen bereitstellen, die nicht für die Wiederherstellung aktiviert sind, führt der Integration Service die Sitzung im Norecovery-Modus aus aus.
-runinsname
-rn
runInsName
Name der Arbeitsablaufausführungsinstanz, die die zu startende Aufgabe enthält. Verwenden Sie diese Option, wenn Sie Arbeitsabläufe parallel ausführen.
-
taskInstancePath
Erforderlich. Gibt einen Aufgabennamen und dessen Position im Arbeitsablauf an. Befindet sich die Aufgabe in einem Arbeitsablauf, geben Sie nur den Aufgabennamen ein. Befindet sich die Aufgabe in einem Worklet, geben Sie WorkletName.TaskName ein. Geben Sie taskInstancePath als vollständig qualifizierten String ein.

Verwenden von Parameterdateien mit starttask

Beim Starten einer Aufgabe können Sie optional das Verzeichnis und den Namen der Parameterdatei eingeben. Der Integration Service führt die Aufgabe mit den in der Datei angegebenen Parametern aus.
UNIX Shell-Benutzer sollten den Parameterdateinamen in einfache Anführungszeichen setzen:
-paramfile '$PMRootDir/myfile.txt'
Für Benutzer der Windows-Eingabeaufforderung gilt, dass der Parameterdateiname keine Leerzeichen am Anfang oder Ende haben darf. Wenn der Name Leerzeichen enthält, setzen Sie den Dateinamen in doppelte Anführungszeichen:
-paramfile "$PMRootDir\my file.txt"
Wenn Sie einen pmcmd-Befehl schreiben, der eine Parameterdatei enthält, die sich auf einem anderen Computer befindet, verwenden Sie den Backslash (\) mit dem Dollarzeichen ($). Damit wird sichergestellt, dass der Computer, auf dem die Variable definiert ist, die Prozessvariable erweitert.
pmcmd starttask -sv MyIntService -d MyDomain -uv USERNAME -pv PASSWORD ‑f east -w wSalesAvg -paramfile '\$PMRootDir/myfile.txt' taskA