Einsatzhinweis
Funktion: Ferne Dateiattribute ändern
Benutzergruppe: FT-Benutzer
Funktionsbeschreibung
Mit dem Kommando FTMOD können Sie Attribute einer Datei in einem FT-Partnersystem ändern.
Mit diesem Kommando können keine Verzeichnisse (d.h. auch keine PO- und PDSE-Datensätze) bearbeitet werden.
Je nach Partner lassen sich folgende Attribute einer Datei ändern:
openFT-Partner:
Dateiname
Zugriffsrechte
FTP-Partner:
Dateiname
Format
FTMOD |
PARTNER = <text 1..200 with-low> ,FILE = <filename 1..59> / <text 1..512> ,PASSWORD = *NONE / <integer -2147483648..2147483647> / <c-string 1..64 with-low> / <x-string 1..128> ,TRANSFER-ADMISSION = *NONE / <salphanum-name 8..32> / <c-string 8..32 with-low> / <x-string 15..64> / *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> ,NEW-NAME = *SAME / <filename 1..54> / <c-string 1..512 with-low> ,FILE-AVAILABILITY = *UNCHANGED ,STORAGE-ACCOUNT = *UNCHANGED ,FUTURE-FILE-SIZE = *UNCHANGED ,ACCESS-MODE = *UNCHANGED / *READ-ONLY / *READ-WRITE / *REPLACE-ALL-BY(...) *REPLACE-ALL-BY(...) READ-FILE = *NO / *YES ,INSERT-DATA-UNIT = *NO / *YES ,REPLACE-FILE = *NO / *YES ,EXTEND-FILE = *NO / *YES ,ERASE-DATA-UNIT = *NO / *YES ,READ-ATTRIBUTES = *NO / *YES ,CHANGE-ATTRIBUTES = *NO / *YES ,DELETE-FILE = *NO / *YES ,LEGAL-QUALIFICATION = *UNCHANGED ,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..59> / <c-string 1..512 with-low> / <text 1..512>
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 angegeben, dann wird der Auftrag mit der Fehlermeldung FTR2202 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 Ändern von Dateiattributen 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.
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>
Wird im fernen System die FTAC-Funktionalität eingesetzt, 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. Die alphanumerische Eingabe wird intern in Kleinbuchstaben umgewandelt.
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.
NEW-NAME =
Neuer Name der Datei im fernen FT-Partner-System.
NEW-NAME = *SAME
Der Dateiname bleibt unverändert.
NEW-NAME = <filename 1..54> / <c-string 1..512 with-low>
Neuer Name der Datei im fernen System. Der bisherige Dateiname verliert damit seine Gültigkeit. Der Dateiname muss in der Syntax des fernen Systems angegeben werden und den Konventionen des fernen Systems entsprechen.
FILE-AVAILABILITY = *UNCHANGED
Die Festlegung bezüglich der Verfügbarkeit bleibt unverändert.
STORAGE-ACCOUNT = *UNCHANGED
Die Festlegung bezüglich der Abrechnungsnummer bleibt unverändert.
FUTURE-FILE-SIZE = *UNCHANGED
Die Festlegung bezüglich der Dateigröße bleibt unverändert.
ACCESS-MODE =
Erlaubte Zugriffsarten.
ACCESS-MODE = *UNCHANGED
Die Festlegung bezüglich der Zugriffsrechte bleibt unverändert.
ACCESS-MODE = *READ-ONLY
Kurzform für die gängigen Zugriffsrechte READ-FILE, READ-ATTRIBUTES und CHANGE-ATTRIBUTES und erleichtert damit die Eingabe.
ACCESS-MODE = *READ-WRITE
Kurzform für die gängigen Zugriffsrechte READ-FILE, REPLACE-FILE, EXTEND-FILE, READ-ATTRIBUTES, CHANGE-ATTRIBUTES, DELETE-FILE und ERASE-DATA-UNIT und erleichtert damit die Eingabe.
ACCESS-MODE = *REPLACE-ALL-BY(...)
Die bestehenden Zugriffsrechte der Datei im fernen System werden durch die angegebenen Zugriffsrechte ersetzt.
READ-FILE = *NO / *YES
Die Datei darf nicht bzw. darf gelesen werden.
REPLACE-FILE = *NO / *YES
Die Datei darf nicht bzw. darf überschrieben werden.
EXTEND-FILE = *NO / *YES
Die Datei darf nicht bzw. darf erweitert werden.
READ-ATTRIBUTES = *NO / *YES
Die Attribute der Datei dürfen nicht bzw. dürfen gelesen werden.
CHANGE-ATTRIBUTES = *NO / *YES
Die Attribute der Datei dürfen nicht bzw. dürfen verändert werden.
DELETE-FILE = *NO / *YES
Die Datei darf nicht bzw. darf gelöscht werden.
INSERT-DATA-UNIT = *NO / *YES
In die Datei dürfen nicht bzw. dürfen Dateneinheiten eingefügt werden, z.B. Sätze.
ERASE-DATA-UNIT = *NO / *YES
In der Datei dürfen nicht bzw. dürfen Dateneinheiten gelöscht werden, z.B. Sätze.
LEGAL-QUALIFICATION = *UNCHANGED
Die Festlegung bezüglich der rechtlichen Bestimmungen bleibt unverändert.
FILE-NAME-ENCODING =
Gibt den Codierungsmodus für die fernen Dateinamen an.
FILE-NAME-ENCODING = *TRANSPARENT
Angabe der fernen Dateinamen im transparenten Modus (kompatibel zu den bisherigen Versionen).
FILE-NAME-ENCODING = *CHARACTER
Angabe der fernen Dateinamen im Zeichenmodus. Die Namen werden 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.
Beispiel:
Sie wollen die Zugriffsrechte der fernen Datei MEINE.DATEI von READ-WRITE auf READ-ONLY setzen. Die Datei ist im BS2000-Rechner HUGO unter der Benutzerkennung JIM mit der Abrechnungsnummer A1234FT und dem Kennwort
C’PWD’ abgespeichert.
|
Kurzform:
FTMOD HUGO,MEINE.DATEI,,(JIM,A1234FT,'PWD'),,,,,*R-O