Einsatzhinweis
Funktion: openFT-Script-Auftrag anzeigen
Benutzergruppe: FT-Benutzer und FT-Verwalter
Funktionsbeschreibung
Gibt Informationen über den Status der openFT-Script-Aufträge eines Benutzers aus. Durch Angabe einer ftscriptid kann auch ein bestimmter openFT-Script-Auftrag ausgewählt werden.
Format
ftshws -h |
[ -csv ]
[ -t ]
[ -v ]
[ -st=[W][R][T][F][I][C][X] ]
[ -u=<Benutzerkennung> | @a ]
[ <ftscriptid> ]
Beschreibung der Optionen
-h
gibt die Kommandosyntax am Bildschirm aus. Weitere Angaben nach -h werden ignoriert.
-csv
Die Informationen werden im CSV-Format ausgegeben. Wenn Sie -csv nicht angeben, werden die Informationen im Tabellenformat ausgegeben.
-t
Die openFT-Script-Aufträge werden nach Erzeugungszeitpunkt sortiert angezeigt, beginnend mit dem letzten Auftrag.
Standardmäßig werden die Aufträge in alphabetischer Reihenfolge angezeigt.
-v
Es wird zusätzlich diagnoserelevante Information ausgegeben (verbose).
Ist -v angegeben, wird bei fehlerhaft beendeten openFT-Script-Aufträgen die Fehlerursache im Klartext in einer zweiten Zeile hinter der tabellarischen Information ausgegeben.
Im CSV-Format wird die Option -v ignoriert.
-st=[W][R][T][F][I][C][X]
zeigt openFT-Script-Aufträge mit dem angegebenen Status an, siehe Feld Sta.
Sie können mehrere Status hintereinander angeben, z.B. -st=WRT.
-u=Benutzerkennung | @a
Benutzerkennung, deren openFT-Script-Aufträge auszugeben sind bzw. unter der der angegebene Auftrag gesucht wird.
Die Angabe einer Benutzerkennung oder @a (alle Benutzerkennungen) ist nur für den FT-Verwalter erlaubt.
Standard ist die Benutzerkennung des Aufrufers.
ftscriptid
Identifikation des openFT-Script-Auftrags. Diese wird ausgegeben, wenn der openFT-Script-Auftrag per ftscript-Kommando gestartet wird.
In der ftscriptid können Sie die Wildcard-Symbole ? und * verwenden. Dann werden alle openFT-Script-Aufträge ausgegeben, die dem Wildcard-Muster entsprechen.
? | wird als genau ein beliebiges Zeichen interpretiert. |
* | wird als beliebig viele, beliebige Zeichen interpretiert. |
Geben Sie bei Wildcard-Verwendung die ftscriptid in Hochkommas eingeschlossen an, damit die Wildcard-Symbole nicht durch die Shell interpretiert werden.
Standardmäßig, wenn Sie keine ftscriptid angeben, werden alle openFT-Script-Aufträge des Benutzers angezeigt.
Ausgabe im Tabellen-Format
Der Bearbeitungsstand der openFT-Script-Aufträge wird in vier Spalten angezeigt:
User
Benutzerkennung, unter der der Auftrag gestartet wurde.
Ftscriptid
Eindeutige Identifikation des Auftrags. Die Identifikation wird vom ftscript-Kommando zurückgegeben.
Sta
Zeigt den Bearbeitungsstatus an, dabei bedeuten:
W (waiting) | Der Auftrag wurde noch nicht begonnen. |
R (running) | Der Auftrag wurde gestartet, ist aber noch nicht beendet. |
T (terminated) | Der Auftrag wurde ohne Fehler beendet. |
F (failure) | Der Auftrag wurde mit Fehler beendet. |
I (interrupted) | Der Auftrag wurde unterbrochen, z.B. aufgrund eines Systemabsturzes. |
C (cancelled) | Der Auftrag wurde mit einem ftcans-Kommando abgebrochen. |
X (cancelling) | Der Auftrag wird derzeit aufgrund eines ftcans-Kommandos abgebrochen. |
FtscriptFileName
Pfadname der Script-Datei.
Falls der Status F und die Option -v angegeben ist, wird in einer weiteren Spalte die Fehlerursache im Klartext ausgegeben.