Einsatzhinweis
Funktion: Asynchrone Aufträge löschen
Benutzergruppe: FT-Benutzer und FT-Verwalter
Funktionsbeschreibung
Mit dem ftcanr-Kommando löschen Sie asynchrone Aufträge, die bereits bearbeitet werden oder noch im Auftragsbuch auf die Bearbeitung warten. Als Benutzer können Sie nur Aufträge löschen, die unter Ihrer eigenen Benutzerkennung eingetragen sind.
Als Verwalter können Sie beliebige Aufträge löschen. Außerdem können Sie als Verwalter Aufträge bedingungslos löschen, d.h. ohne Aushandlung mit dem Partnersystem.
Bei bereits gestarteten Dateiübertragungsaufträgen kann sich die Zieldatei in einem undefinierten Zustand befinden.
Format
ftcanr -h |
[ -f ]
[ -ua=<Benutzerkennung> | @a ]
[ -ini=l | -ini=r | -ini=lr | -ini=rl ]
[ -pn=<Partner 1..200> ]
[ -fn=<Dateiname 1..512> ]
<Auftrags-Id 1..2147483647> [<Auftrags-Id 1..2147483647> ...] | @a
Beschreibung der Optionen
-h
gibt die Kommandosyntax am Bildschirm aus. Weitere Angaben nach -h werden ignoriert.
-f
Damit löschen Sie einen Auftrag bedingungslos aus dem lokalen Auftragsbuch, d.h. ohne Aushandlung mit dem Partnersystem. Beachten Sie, dass dadurch im
Auftragsbuch des Partners Aufträge ohne definierten Zustand entstehen können.
Diese Option können Sie nur als FT-Verwalter aufrufen. Voraussetzung ist, dass der Auftrag zuvor mit ftcanr ohne Option -f abgebrochen wurde.
-ua=Benutzerkennung | @a
Mit -ua legt man fest, für welche Benutzerkennung Aufträge gelöscht werden sollen.
Benutzerkennung
Sie können als Benutzer nur Ihre eigene Benutzerkennung angeben.
Als FT-Verwalter dürfen Sie hier jede beliebige Benutzerkennung angeben.
@a
Diese Option ist nur für den FT-Verwalter sinnvoll. Als FT-Verwalter können Sie durch Angabe von @a Aufträge aller Benutzerkennungen löschen.
-ua= nicht angegeben
Die eigene Benutzerkennung ist das Auswahlkriterium.
Ausnahme: Der FT-Verwalter hat das Kommando aufgerufen und dabei auch Auftrags-Ids angegeben: in diesem Fall ist die Voreinstellung @a.
-ini=l | -ini=r | -ini=lr | -ini=rl
Mit -ini legen Sie fest, für welche Initiatorseite Sie Aufträge löschen wollen. Sie können angeben: l, r, lr, rl
l
Nur lokal gestellte Aufträge werden gelöscht.
r
Nur fern gestellte Aufträge werden gelöscht.
lr, rl
Sowohl lokale als auch fern gestellte Aufträge werden gelöscht
-ini nicht angegeben
Der Initiator ist nicht Auswahlkriterium (entspricht lr bzw. rl).
-pn=Partner
Mit -pn können Sie das Partnersystem angeben, für das Sie Aufträge löschen wollen. Partner ist der Name oder die Adresse des Partnersystems. Sie sollten den Partner in der gleichen Form angeben wie bei der Auftragsvergabe oder der Ausgabe des Kommandos ftshwr.
-fn=Dateiname
Mit -fn legen Sie fest, für welchen Dateinamen Aufträge gelöscht werden sollen. Es werden Aufträge gelöscht, die im lokalen System auf diese Datei zugreifen.
Es muss der Dateiname angegeben werden, der bei der Auftragserstellung verwendet wurde. Der Dateiname wird auch beim ftshwr-Kommando ausgegeben. Wildcards im Dateinamen sind nicht erlaubt.
Auftrags-Id1 [Auftrags-Id2] [Auftrags-Id3] ... | @a
Für Auftrags-Id geben Sie die Identifikation des Auftrags an, der gelöscht werden soll (mit oder ohne führende Nullen). Die Auftrags-Id erhalten Sie bei der Bestätigung der Auftragsannahme am Bildschirm oder über das Kommando ftshwr, falls Sie sie vergessen haben. Sie können auch mehrere Auftrags-Identifikationen gleichzeitig angeben. Werden zusätzlich zur Auftrags-Id weitere Auswahlkriterien angegeben, so wird ein Auftrag mit einer ausgewählten Auftrags-Id nur dann gelöscht, wenn auch die anderen Bedingungen erfüllt sind.
@a für Auftrags-Id
Mit @a werden alle Aufträge ausgewählt.
Falls Auftrags-Ids angegeben wurden und die übrigen angegebenen Auswahlkriterien nicht zu dem Auftrag passen, wird der Auftrag nicht gelöscht und es erscheint die folgende Fehlermeldung:
ftcanr: Auftrag
Auftrags-Id nicht gefunden
Auftrags-Id ist die Identifikation des letzten nicht passenden Auftrags.
Beispiele
Der asynchrone Auftrag mit der Auftrags-Identifikation 65546 soll gelöscht werden.
ftcanr 65546
Es sollen alle lokalen Aufträge zum Partner ux1 gelöscht werden, die die Datei file1 betreffen.
ftcanr -pn=ux1 -fn=file1 -ini=l @a