Einsatzhinweis
Funktion: Fernes Verzeichnis löschen
Benutzergruppe: FT-Benutzer
Aliasname: FTDELDIR
Funktionsbeschreibung
Mit dem Kommando DELETE-REMOTE-DIR können Sie ein leeres Verzeichnis in einem FT-Partnersystem löschen.
Format
DELETE-REMOTE-DIR / FTDELDIR |
PARTNER = <text 1..200 with-low> ,DIRECTORY-NAME = *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“.
DIRECTORY-NAME =
Name des Verzeichnisses im fernen FT-Partnersystem.
DIRECTORY-NAME = *NOT-SPECIFIED
Der Name des Verzeichnisses ist dem fernen System bekannt, da er zum Beispiel in dem angesprochenen FTAC-Berechtigungsprofil bereits vollständig festgelegt ist.
DIRECTORY-NAME = <filename 1..54> / <c-string 1..512 with-low>
Name des Verzeichnisses im fernen System. Er muss in der Syntax des fernen Systems angegeben werden und den Konventionen des fernen Systems entsprechen.
Wird der Verzeichnisname 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 das Verzeichnis im fernen System berechtigt.
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 im fernen System zum Löschen des Verzeichnisses 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, um den Dateimanage-ment-Auftrag auszuführen.
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 auf dem Bildschirm.
FILE-NAME-ENCODING =
Gibt den Codierungsmodus für den fernen Verzeichnisnamen an.
FILE-NAME-ENCODING = *TRANSPARENT
Angabe des Verzeichnisnamens für das ferne System im transparenten Modus (kompatibel zu den bisherigen Versionen).
FILE-NAME-ENCODING = *CHARACTER
Angabe des Verzeichnisnamens für das ferne System 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).
FILE-NAME-ENCODING=*CHARACTER ist nur für Partner mit openFT ab V12.1 erlaubt.
Kommando-Returncodes
Die möglichen Returncodes finden Sie in der Tabelle im Kapitel „Kommando-Returncodes für Dateiübertragung und Dateimanagement“.
Beispiel:
Löschen des leeren Verzeichnisses Dir1 auf dem Unix-System partux unter der Zugangsberechtigung transadm.
DELETE-REMOTE-DIR partux,c'Dir1',,transadm