Einsatzhinweis
Funktion: Dateiattribute in einem fernen System ändern
Benutzergruppe: FT-Benutzer
Funktionsbeschreibung
Mit ftmod ändern Sie die Attribute einer Datei in einem fernen System. Je nach Art des Partners (openFT, FTAM oder FTP) lassen sich folgende Attribute einer Datei ändern:
openFT-Partner:
Dateiname
Zugriffsrechte (nicht, wenn das Partnersystem ein Windows-System ist)
FTAM-Partner:
Dateiname
Zugriffsrechte (nicht, wenn das Partnersystem ein Windows-System ist)
Verfügbarkeit der Datei
Abrechnungskonto für Dateispeicherungskosten
rechtliche Bestimmungen bezüglich der Verwendung einer Datei
zukünftige Dateigröße
FTP-Partner:
Dateiname
Format
ftmod -h |
<Partner 1..200>![<Dateiname 1..512>]
[ <Zugangsberechtigung 8..67> | @n | @d |
<Benutzerkennung 1..67>[,[<Account 1..64>][,[<Kennwort 1..64>]]] ]
[ -fnc=t | -fnc=c ]
[ -p=[<Management-Kennwort 1..64>] ]
[ -nf=<Neuer Dateiname 1..512> ]
[ -av=i | -av=d ]
[ -ac=<Neue Abrechnungsnummer 1..64> ]
[ -fs=<Zukünftige Dateigröße 1..2**63-1> ]
[ -am=[+][r][i][p][x][e][a][c][d] | -am=@rw | -am=@ro ]
[ -lq=<Rechtliche Bestimmung 1..80> ]
Beschreibung der Optionen
-h
gibt die Kommandosyntax am Bildschirm aus. Weitere Angaben nach -h werden ignoriert.
Partner![Dateiname]
Gibt an, für welche Datei auf welchem Rechner die Attribute geändert werden sollen.
Partner
Partner ist der Name des Partnersystems in der Partnerliste oder die Adresse des Partnersystems. Einzelheiten zur Adressangabe finden Sie in Abschnitt „Partneradressen eingeben“ .
Dateiname
Dateiname kann absolut oder relativ zur fernen Login-Berechtigung angegeben werden. Ist der Dateiname im fernen System durch ein Berechtigungsprofil fest vorgegeben, darf er hier nicht angegeben werden.
Läuft auf dem Partnersystem openFT (BS2000), dann können hier auch Elemente aus PLAM-Bibliotheken angegeben werden (Syntax:
Bibliotheksname/Elementtyp/Elementname).
Zugangsberechtigung | @n | @d |
Benutzerkennung[,[Account][,[Kennwort]] ]
Damit Sie die Attribute einer Datei im fernen System ändern können, müssen Sie sich dort ausweisen. Dazu benötigen Sie eine Berechtigung in der im fernen System gültigen Syntax. Diese Zugangsberechtigung können Sie angeben
als FTAC-Zugangsberechtigung, wenn im fernen System FTAC eingesetzt wird,
oder als Login-/LOGON-Berechtigung in der Syntax des fernen Systems (Benutzerkennung, ggf. mit Account und/oder Kennwort).
Details finden Sie im Abschnitt „Berechtigungsdaten für Partnersysteme eingeben“ .
@n für Zugangsberechtigung
Mit @n geben Sie an, dass das ferne System keine Login-Berechtigung verlangt.
@d für Zugangsberechtigung
Wenn Sie @d (dunkelgesteuert) angeben, wird die Zugangsberechtigung nach Abschicken des Kommandos am Bildschirm abgefragt. Ihre Eingabe bleibt unsichtbar, um zu verhindern, dass Unbefugte die Zugangsberechtigung sehen.
Ein binäres Kennwort und eine binäre Zugangsberechtigung müssen sedezimal angegeben werden, siehe Abschnitt „Eingabe von Kommandos“.
Kennwort nicht angegeben
Wenn Sie ein für die Berechtigung benötigtes Kennwort weglassen, dann wird es nach Abschicken des Kommandos am Bildschirm abgefragt. Ihre Eingabe bleibt unsichtbar, um zu verhindern, dass Unbefugte das Kennwort sehen.
Beachten Sie bitte, dass Sie die Kommas trotzdem angeben müssen, z.B.:
ftmod partner!datei kennung,,
oder
ftmod partner!datei kennung,account,
weder Zugangsberechtigung noch Benutzerkennung angegeben
wirkt wie @d, d.h. die Zugangsberechtigung wird nach Abschicken des Kommandos am Bildschirm abgefragt. openFT interpretiert Ihre (unsichtbare) Eingabe immer als Zugangsberechtigung und nicht als Benutzerkennung.
-fnc=t | -fnc=c (file name coding)
gibt den Codierungsmodus für die fernen Dateinamen (Dateinname, neuer Dateiname) an.
t (transparent, Standardwert)
Angabe der fernen Dateinamen im transparenten Modus (kompatibel zu den bisherigen Versionen).
c (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).
-fnc=c ist nur für Partner mit openFT ab V12.1 erlaubt.
-p=[Management-Kennwort]
Ist die Datei im fernen System durch ein Kennwort geschützt, müssen Sie es hier angeben.
Ein binäres Kennwort muss sedezimal angegeben werden, siehe Abschnitt „Eingabe von Kommandos“. Das ist relevant bei einer Kopplung mit openFT (BS2000), weil im BS2000 sedezimale Kennwörter definiert werden können.
Management-Kennwort nicht angegeben
Mit -p= wird das Kennwort nach Abschicken des Kommandos am Bildschirm abgefragt. Ihre Eingabe bleibt unsichtbar, um zu verhindern, dass Unbefugte das Kennwort sehen.
-nf=Neuer Dateiname
gibt den neuen Dateinamen für die Datei Dateiname im Partnersystem an. Der Name Dateiname verliert damit seine Gültigkeit. Neuer-Dateiname kann absolut oder relativ zur fernen Login-Berechtigung angegeben werden.
-nf nicht angegeben
Der Dateiname bleibt unverändert.
-av=i | -av=d
kennzeichnet die Verfügbarkeit der Datei in einem FTAM-Partnersystem. Der Parameter verfügbarkeit kann zwei Werte annehmen: sofort-verfügbar oder nicht-sofort-verfügbar. nicht-sofort-verfügbar könnte eine Datei zum Beispiel sein, wenn sie in ein Archiv ausgelagert ist. Die Interpretation des Begriffs nicht-sofort-verfügbar ist jedoch dem Partner überlassen.
Deshalb müssen in diesem Fall die Konventionen des FTAM-Partners beachtet werden.
Sie können folgende Werte einsetzen:
i
Im fernen System wird das Attribut der Datei auf den Wert sofort-verfügbar gesetzt (immediate).
d
Im fernen System wird das Attribut der Datei auf den Wert nicht-sofort-verfügbar gesetzt (deferred). Die Datei kann dann im Partnersystem ausgelagert werden.
Bei Aufträgen mit openFT-Partnern sowie mit FTAM-Partnern, die die Storage Group nicht unterstützen, wird der Auftrag abgelehnt.
-av nicht angegeben
Die Festlegung bezüglich der Verfügbarkeit bleibt unverändert.
-ac=Neue Abrechnungsnummer
bezeichnet beim FTAM-Partner ein Abrechnungskonto. Die Kosten für die Abspeicherung von Dateien gehen zu Lasten dieses Kontos. Dieser Parameter muss nach den Konventionen des Partnersystems gesetzt werden.
Bei Aufträgen mit openFT-Partnern sowie mit FTAM-Partnern, die die Storage Group nicht unterstützen, wird der Auftrag abgelehnt.
-ac nicht angegeben
Die Festlegung bezüglich der Abrechnungsnummer bleibt unverändert.
-fs=Zukünftige Dateigröße
informiert bei FTAM-Partnern über die voraussichtliche Dateigröße. Diese Information dient als Richtwert für eine systemspezifische Optimierung.
Bei Aufträgen mit openFT-Partnern sowie mit FTAM-Partnern, die die Storage Group nicht unterstützen, wird der Auftrag abgelehnt.
-fs nicht angegeben
Die Festlegung bezüglich der Dateigröße bleibt unverändert.
-am=[+][r][i][p][x][e][a][c][d] | @rw | @ro
ändert die Zugriffsrechte auf eine Datei im fernen System. Es können alte Zugriffsrechte durch neue ersetzt werden.
Der Parameter kann folgende Werte annehmen:
+, r, i, p, x, e, a, c, d oder jede beliebige Kombination dieser Werte sowie @rw oder @ro.
+
bedeutet bei FTAM-Partnern, dass die Datei zusätzlich zu ihren bestehenden Zugriffsrechten einen neuen Satz von Zugriffsrechten erhält. Diese Angabe hat nur Bedeutung für FTAM-Partner, die mehr als einen Satz von Zugriffsrechten unterstützen
+ nicht angegeben
Die bestehenden Zugriffrechte der Datei im fernen System werden durch die angegebenen Zugriffsrechte ersetzt.
r
bedeutet, dass die Datei gelesen werden darf.
r nicht angegeben
Die Datei darf nicht gelesen werden.
i
bedeutet bei FTAM-Partnern, dass in die Datei Dateneinheiten, zum Beispiel Sätze, eingefügt werden dürfen.
i nicht angegeben
In die Datei dürfen keine Dateneinheiten eingefügt werden.
p
bedeutet, dass die Datei überschrieben werden darf.
p nicht angegeben
Die Datei darf nicht überschrieben werden.
x
bedeutet, dass an die Datei Daten angehängt werden dürfen.
x nicht angegeben
Die Datei darf nicht erweitert werden.
e
bedeutet bei FTAM-Partnern, dass aus der Datei Dateneinheiten, zum Beispiel Sätze, gelöscht werden dürfen.
e nicht angegeben
Aus der Datei dürfen keine Dateneinheiten gelöscht werden.
a
bedeutet, dass die Attribute der Datei gelesen werden dürfen.
a nicht angegeben
Die Attribute der Datei dürfen nicht gelesen werden.
c
bedeutet, dass die Attribute der Datei verändert werden dürfen.
c nicht angegeben
Die Attribute der Datei dürfen nicht verändert werden.
d
bedeutet, dass die Datei gelöscht werden darf.
d nicht angegeben
Die Datei darf nicht gelöscht werden.
@rw
ist die Kurzform für die gängigen Zugriffsrechte read-write (rpxeacd) und erleichtert damit die Eingabe.
@ro
ist die Kurzform für die gängigen Zugriffsrechte read-only (rac) und erleichtert damit die Eingabe.
Ist das Partnersystem ein Windows-System, können Sie die Zugriffsrechte für die Zieldatei nicht ändern.
Bei Unix- oder BS2000-Partnersystemen können Sie nur die folgenden Zugriffsrechte für eine Datei einstellen:
Zugriffsmodus | Kurzform | Unix-System | BS2000 | Zugriffsrechte |
rpxeacd | @rw | rw* | ACCESS=WRITE | read-write |
rac | @ro | r-* | ACCESS=READ | read-only |
pxeacd | -w* | nur mit BASIC-ACL | write-only | |
ac | --* | nur mit BASIC-ACL | keine |
Bei Aufträgen mit FTP-Partnern sowie mit FTAM-Partnern, die die Security Group nicht unterstützen, wird der Auftrag abgelehnt.
-am nicht angegeben
Die Festlegung bezüglich der Zugriffsrechte bleibt unverändert.
-lq=Rechtliche Bestimmung
legt bei FTAM-Partnern eine neue rechtliche Bestimmung für eine Datei fest (entspricht einem Copyright). Maximal können Sie 80 Zeichen eingeben.
Bei Aufträgen mit openFT-Partnern sowie mit FTAM-Partnern, die die Security Group nicht unterstützen, wird der Auftrag abgelehnt.
-lq nicht angegeben
Die Festlegung bezüglich der rechtlichen Bestimmungen bleibt unverändert.
Beispiel
Sie wollen die Zugriffsrechte der fernen Datei unsinn von read only auf read write setzen. Die Datei ist im BS2000-Rechner bs2r1 unter der Benutzerkennung jim mit der Abrechnungsnummer a1234ft und dem Kennwort C'pwd' abgespeichert und durch das Kennwort abcd geschützt
Unix-Systeme:
ftmod bs2r1!unsinn jim,a1234ft,C\'pwd\' -p=C'abcd' -am=@rw
Windows-Systeme:
ftmod bs2r1!unsinn jim,a1234ft,C'pwd' -p=C'abcd' -am=@rw