Einsatzhinweis
Funktion: Ferne Datei löschen
Benutzergruppe: FT-Benutzer
Aliasname: FTDEL
Funktionsbeschreibung
Mit dem Kommando DELETE-REMOTE-FILE können Sie eine Datei in einem FT-Partnersystem löschen.
Format
DELETE-REMOTE-FILE / FTDEL |
PARTNER = <text 1..200 with-low> ,FILE = *NOT-SPECIFIED / <filename 1..54> / <c-string 1..512 with-low> ,PASSWORD = *NONE / <integer -2147483648..2147483647> / <c-string 1..64 with-low> / <x-string 1..128> / *SECRET ,TRANSFER-ADMISSION = *NONE / <alphanum-name 8..32> / <c-string 8..32 with-low> / <x-string 15..64> / *SECRET / *PARAMETERS(...) *PARAMETERS(...) USER-IDENTIFICATION = <name 1..8> / <c-string 1..67 with-low> ,ACCOUNT = *NONE / <c-string 1..64 with-low> / <text 1..64> ,PASSWORD = *NONE / <c-string 1..64 with-low> / <x-string 1..128> / <alphanum-name 1..19> / *SECRET ,FILE-NAME-ENCODING = *TRANSPARENT / *CHARACTER |
Beschreibung der Operanden
PARTNER = <text 1..200 with-low>
Name des Partnersystems, wie ihn der FT-Verwalter in der Partnerliste festgelegt hat oder die Adresse des Partnersystems. Näheres zur Adressangabe siehe Abschnitt „Partneradressen angeben“.
FILE =
Name der Datei im fernen FT-Partnersystem.
FILE = *NOT-SPECIFIED
Der Name der Datei ist dem fernen System bekannt, da er zum Beispiel in dem angesprochenen FTAC-Berechtigungsprofil bereits vollständig festgelegt ist.
FILE = <filename 1..54> / <c-string 1..512 with-low>
Name der Datei im fernen System. Er muss in der Syntax des fernen Systems angegeben werden und den Konventionen des fernen Systems entsprechen.
Wird der Dateiname mit einem nicht eingehängten Public Volume Set (BS2000-Systeme) angegeben, dann wird der Auftrag mit der Fehlermeldung FTR2155 abgelehnt.
PASSWORD =
Kennwort, das zum Zugriff auf die Datei im fernen System berechtigt. Ist die Datei im fernen System mit einem Kennwort geschützt, so muss hier das Kennwort angegeben werden, das im fernen System zum Löschen notwendig ist.
PASSWORD = *NONE
Der Zugriff ist ohne Kennwort möglich.
PASSWORD = <integer -2147483648..2147483647> / <c-string 1..64 with-low> / <x-string 1..128>
Kennwort, das zum Zugriff auf die Datei im fernen System berechtigt. Das Kennwort muss in der Syntax des fernen Systems angegeben werden und den Konventionen des fernen Systems entsprechen.
PASSWORD = *SECRET
Sie erhalten vom System die Aufforderung, das Kennwort einzugeben. Ihre Eingabe erscheint aber nicht auf dem Bildschirm.
TRANSFER-ADMISSION =
Enthält Angaben über die Zugangsberechtigung im fernen System für den Dateimanage-ment-Auftrag.
TRANSFER-ADMISSION = *NONE
Das ferne System benötigt bzw. kennt keine Benutzerberechtigung.
TRANSFER-ADMISSION =
<alphanum-name 8..32> / <c-string 8..32 with-low> / <x-string 15..64>
Wenn im fernen System die FTAC-Funktionalität eingesetzt ist, kann die Zugangsberechtigung für das ferne System über ein Berechtigungsprofil definiert sein. Dann wird an dieser Stelle nur die im Berechtigungsprofil festgelegte TRANSFER-ADMISSION angegeben. Bei einer alphanumerischen Eingabe werden Großbuchstaben intern in Kleinbuchstaben umgewandelt.
TRANSFER-ADMISSION = *SECRET
Sie erhalten vom System die Aufforderung, die Zugangsberechtigung einzugeben. Diese wird aber nicht auf dem Bildschirm sichtbar.
TRANSFER-ADMISSION = *PARAMETERS(...)
Identifikation, Abrechnungsnummer und Kennwort des Benutzers im fernen System. Die Operanden in der Klammer können Sie auch als Stellungsoperanden ohne ihre Schlüsselwörter verwenden.
USER-IDENTIFICATION = <name 1..8> / <c-string 1..67 with-low>
Identifikation des Benutzers im fernen System. Die Identifikation muss in der Syntax des fernen Systems angegeben werden und den Konventionen des fernen Systems entsprechen.
ACCOUNT = *NONE / <c-string 1..64 with-low> / <text 1..64>
Abrechnungsnummer des Benutzers im fernen System. Die Abrechnungsnummer muss in der Syntax des fernen Systems angegeben werden und den Konventionen des fernen Systems entsprechen.
PASSWORD =
Kennwort, das den Benutzer zum Zugang in das ferne System berechtigt.
PASSWORD = *NONE
Der Zugang ist ohne Kennwort möglich.
PASSWORD = <c-string 1..64 with-low> / <x-string 1..128> /
<alphanum-name 1..19>
Kennwort, das den Benutzer zum Zugang in das ferne System berechtigt. Das Kennwort muss in der Syntax des fernen Systems angegeben werden, den Konventionen des fernen Systems entsprechen und dort bekannt sein.
PASSWORD = *SECRET
Sie erhalten vom System die Aufforderung, das Kennwort einzugeben. Ihre Eingabe erscheint aber nicht auf dem Bildschirm.
FILE-NAME-ENCODING =
Gibt den Codierungsmodus für den fernen Dateinamen an.
FILE-NAME-ENCODING = *TRANSPARENT
Angabe des fernen Dateinamens im transparenten Modus (kompatibel mit der vorherigen Version).
FILE-NAME-ENCODING = *CHARACTER
Angabe des fernen Dateinamens im Zeichenmodus. Der Name wird entsprechend dem Zeichencode des fernen Systems interpretiert, bei Unix-Partnern also entsprechend der dort eingestellten openFT-Betriebsparameter-Option (ftmodo -fnccs).
Voraussetzung für das Partner-System ist openFT ab Version V12.1.
Kommando-Returncodes
Die möglichen Returncodes finden Sie in der Tabelle im Kapitel „Kommando-Returncodes für Dateiübertragung und Dateimanagement“.
Beispiel
Sie wollen die Datei DATEI, die im Partnerrechner HUGO abgespeichert ist, von Ihrem BS2000-Rechner aus löschen. Im fernen System wird FTAC eingesetzt. Zum Löschen der Datei müssen Sie die Zugangsberechtigung LOESCHZUGRIFF angeben.
/DELETE-REMOTE-FILE PARTNER = HUGO,FILE-NAME = DATEI, -
/ TRANSFER-ADMISSION = LOESCHZUGRIFF
Die Kurzform lautet:
/DEL-REM-FI HUGO,DATEI,,LOESCHZUGRIFF