CHARACTERSET - Dateityp
Typ der Datei. Dieses Feld kann in der Standardausgabe folgende Werte annehmen:
t | Datei enthält Text. |
b | Datei enthält Binärdaten. |
d | Dateiverzeichnis. |
* | keine Information über Dateistruktur vorhanden |
Die ausführliche Ausgabe wird folgendermaßen dargestellt:
BINARY-FILE | Binärdatei |
DIRECTORY | Dateiverzeichnis |
CHARACTERSET | Textdatei * |
Bei Textdateien (CHARACTERSET=) wird zusätzlich der Zeichensatz angeben, aus dem die Zeichen der Textdatei stammen. Das Feld kann dann folgende Werte annehmen:
g | GraphicString *) |
c | GeneralString *) |
i | IA5String *) |
v | VisibleString *) |
ACCESS-RIGHTS - Zugriffsrechte
Enthält Information darüber, welche Zugriffsaktionen auf die Datei möglich sind. Das Feld kann folgende Werte annehmen:
r | Datei darf gesendet werden. |
i | Dateneinheiten dürfen eingefügt werden.*) |
p | Datei darf überschrieben werden. |
x | Datei darf erweitert werden, d.h. es können Daten an die Datei angefügt werden |
e | Dateneinheiten dürfen aus der Datei gelöscht werden. |
a | Attribute der Datei dürfen gelesen werden. |
c | Attribute der Datei dürfen verändert werden. |
d | Datei darf gelöscht werden. |
t | Zugriffsrichtung vorwärts (traversal) *) |
v | Zugriffsrichtung rückwärts (reverse traversal) * |
r | Random Zugriff *) |
Ersteller der Datei
Identität desjenigen, der die Datei angelegt hat. Im BS2000 bezieht sich die Information auf die Benutzerkennung, unter der die Datei angelegt ist. In Unix-Systemen bezeichnet dieser Wert im Allgemeinen den Eigentümer der Datei. Das Feld ist maximal 32 Zeichen lang.
STORAGE-ACCOUNT - Abrechnungsnummer
FTAM-spezifischer Wert. Er enthält die Abrechnungsnummer, über die die Kosten für die Speicherung der Datei im fernen System verrechnet werden.
FILE-SIZE - Aktuelle Größe der Datei in Byte
Aktuelle Größe der Datei in Byte. Die Ausgabe ist aber nur so genau, wie das Partnersystem sie zurückliefert. Da die Dateien in unterschiedlichen Systemen unterschiedlich angelegt werden, können hier bei gleich großen Dateien in unterschiedlichen Systemen unterschiedliche Werte ausgegeben werden. Einige Dateispeicher weisen für die Speicherung von Dateien ein Vielfaches einer Basiseinheit zu, zum Beispiel Blöcke. Deshalb ist es empfehlenswert, den Wert nicht als die reale Größe der Datei aufzufassen, sondern nur als Richtwert zu betrachten.
Insbesondere ist bei Elementen einer LMS-Bibliothek zu beachten, dass die angezeigte Größe im Allgemeinen kleiner ist als die Datei, die bei der Übertragung entsteht, da Bibliothekselemente grundsätzlich komprimiert abgelegt werden (siehe LMS-
Handbuch Kapitel “Aufbau einer Bibliothek“).
Datum und Uhrzeit der letzten Veränderung des Dateiinhalts
Enthält Informationen darüber, wann sich der Dateiinhalt zuletzt geändert hat. Bei Änderungen, die innerhalb des letzten halben Jahres liegen, erfolgt die Ausgabe in der Form Monat Tag Uhrzeit (zum Beispiel: Apr 25 15:13), bei Änderungen, die länger als ein halbes Jahr zurückliegen in der Form Monat Tag Jahreszahl (zum Beispiel: Apr 30 2017).
FILENAME - Name der Datei
Name der Datei.
Die folgenden Werte sind nur Bestandteil der ausführlichen Ausgabe:
CRE, MOD, REA, ATM - Art der letzten Dateinutzung
Enthält Information darüber, wie auf die Datei zuletzt zugegriffen wurde. Es können folgende Zugriffsarten angezeigt werden:
CRE | Erstellung der Datei (Dateikreation) |
MOD | Änderung des Dateiinhalts (Überschreiben, Erweitern) |
REA * | Lesen der Datei (Senden) |
ATM * | Ändern der Dateiattribute |
Hierbei ist zu beachten, dass es dem fernen System überlassen ist, welche Informationen es zurückliefert. Deshalb kann die Zeile mit den Informationen über die Dateinutzung je nach Partnersystem unterschiedlich aussehen und unterschiedliche Informationen enthalten. Im Allgemeinen wird mindestens die Information zur Erstellung der Datei geliefert.
Weitere Informationen zum Ändern des Dateiinhalts oder der Dateiattribute, zum Senden einer Datei oder zur letzten Nutzung können fehlen.
Name des letzten Dateibenutzers
Identität der letzten Dateibenutzers, der mit einer bestimmten Zugriffsart auf die Datei zugegriffen hat.
RECORD-FORMAT - Satzformat
Format der übertragenen Sätze. Mögliche Werte sind:
v | variabel lange Sätze |
f | einheitlich lange Sätze |
u | keine Satzstruktur bzw. variabel lange Sätze, die für die Übertragung jeweils |
RECORD-SIZE - maximale Satzlänge
Maximale Länge der übertragenen Sätze.
FILE-AVAILABILITY - Verfügbarkeit der Datei
FTAM-spezifischer Wert. Das Feld kann folgende Werte annehmen:
i | Die Datei ist sofort verfügbar (immediate). |
d | Die Datei ist nicht sofort verfügbar (deferred). |
Die Bedeutung des Begriffs nicht sofort-verfügbar wird vom Partnersystem |
MAX-FILESIZE - mögliche Größe der Datei in Byte
FTAM-spezifischer Wert. Er enthält die mögliche Größe der Datei. Die Angabe ist jedoch nur so genau, wie sie das ferne System liefert. Da die Dateien in unterschiedlichen Systemen unterschiedlich angelegt werden, können hier bei gleich großen Dateien unterschiedliche Werte ausgegeben werden. Es ist deshalb empfehlenswert, den Wert nicht als die reale Größe der Datei aufzufassen, sondern als Richtwert zu betrachten.
LEGAL-QUALIFICATION - rechtliche Bestimmung
FTAM-spezifischer Wert, der eine rechtliche Bestimmung für die Datei (entspricht einem Copyright) enthält.
Beispiel
Sie wollen sich die Standardausgabe zur Datei REMDATEI, die im BS2000-Rechner mit dem symbolischen Namen HUGO unter der Kennung JIM mit der Abrechnungsnummer A1234FT und dem Kennwort C’PWD’ abgespeichert ist, ausgeben lassen.
/SHOW-REMOTE-FILE-ATTRIBUTES PARTNER = HUGO,FILE-NAME = REMDATEI,
-
/
TRANSFER-ADMISSION = (JIM,A1234FT,C'PWD')
%*r-pxeacd--- JIM
1234567890 Apr 30 11:55 REMDATEI
Kurzform:
/SH-REM-FI-ATT HUGO,REMDATEI,,(JIM,A1234FT,'PWD')
Sie wollen umfassende Information zu den Attributen der Datei REMDATEI, im FTAM-Partnerrechner mit dem symbolischen Namen HUGO unter der Kennung JIM mit der Abrechnungsnummer A1234FT und Kennwort C’PWD’.
/SHOW-REMOTE-FILE-ATTRIBUTES PARTNER = HUGO,FILE-NAME = REMDATEI,
-
/
TRANSFER-ADMISSION = (JIM,A1234FT,C'PWD'),
-
/
INFORMATION = *ALL-ATTRIBUTES
%FILENAME=REMDATEI
%CRE
JIM
%MOD
DATE=Apr 28 15:54
%RECORD-FORMAT=v
%ACCESS=RIGHTS=r-pxeacd---
FILESIZE=123456
Kurzform:
/SH-REM-FI-ATT HUGO,REMDATEI,,(JIM,A1234FT,'PWD'),*ALL
Sie wollen umfassende Information zu den Attributen der POSIX-Dateien im BS2000-Partnerrechner Rechner1. Die Zugangsberechtigung für das ferne System lautet nummer13.
Die Ausgabe bezieht sich auf das POSIX-Directory file:
/SHOW-REMOTE-FILE-ATTRIBUTES rechner1,*DIR(’./file’),,nummer13
%*r-pxeacd--- AXL
2416640 Feb 13 10:18 ZUKUNFT-E.28
%*r-pxeacd--- AXL
26365952 Feb 09 09:36 ZUKUNFT-E.26
%tr-pxeacd--- AXL
2048 Feb 16 15:24 TEST
%*r-pxeacd--- AXL
524288 Jan 26 10:11 NSTD
Es wird die Ausgabe für den POSIX-Namen file.test angefordert:
/SHOW-REMOTE-FILE-ATTRIBUTES rechner1,‘./file.test‘,,nummer13
%*r-pxeacd--- axl
2048 Feb 17 15:50 ./file.test
Die Ausgabe wird für das gesamte Directory angefordert:
/SHOW-REMOTE-FILE-ATTRIBUTES rechner1,*DIR(‘./.‘),,nummer13
%*r-pxeacd--- axl
0 Feb 17 16:55 Z1.ZUKUNFT-F.780
%*r-pxeacd--- axl
0 Feb 22 10:05 Z1.ZUKUNFT-F.1060
%*r-pxeacd--- axl
261389 Feb 17 11:32 F-703-0BUP
%*r-pxeacd--- axl
0 Feb 20 10:39 SCRATCH
%*r-pxeacd--- axl
21511 Feb 22 10:46 Z3.ZUKUNFT-F.107
%*r-pxeacd--- axl
199355 Feb 17 11:20 Z1.ZUKUNFT-F.739
%*r-pxeacd--- axl
19899 Feb 17 10:23 Z1.ZUKUNFT-F.693
%*r-pxeacd--- axl
0 Feb 15 20:40 F-291-0BM8
%*r-pxeacd--- axl
0 Feb 15 16:28 F-172-0BM7
%*r-pxeacd--- axl
2048 Feb 17 15:50 file.test
Es sollen alle Dateien angezeigt werden, die mit FILE. anfangen:
/SHOW-REMOTE-FILE-ATTRIBUTES rechner1,*DIR(file.),,nummer13
%*r-pxeacd--- AXL
2416640 Feb 13 10:10 INCOMING
%*r-pxeacd--- AXL
26365952 Feb 09 09:36 OUTGOING
Alle Eigenschaften der Datei FILE.TEST am System PARTBS2 sollen im CSV-Format angezeigt werden:
/SH-REM-FI PARTBS2,FILE.TEST,,transadm,OUT=*SYSOUT(*CSV),INF=*ALL
FileName;StorageAccount;CreIdentity;CreTime;ModIdentity;ModTime;
ReaIdentity;ReaTime;AtmIdentity;AtmTime;FileType;CharSet;RecFormat;
RecSize;FileAvail;AccessRights;FileSize;MaxFileSize;LegalQualif;CcsName
"FILE.TEST";*NSPEC;"UID";*NSPEC;*NSPEC;2016-07-05 14:43:13;*NSPEC;
*NSPEC;*NSPEC;*NSPEC;*NSPEC;*NSPEC;*VAR;*NSPEC;*NSPEC;r-pxeacd---;2048;
*NSPEC;*NSPEC;*NSPEC
Es sollen die Eigenschaften der PLAM-Bibliothek TESTLIB angezeigt werden.
PLAM-Bibliotheken werden als Verzeichnisstrukutur angesprochen: Bibliothek/Typ/Element bzw. Bibliothek/Typ/Element()/Element(Version)
Auflisten aller Typen einer Bibliothek:
/SHOW-REM-FIL-ATTR PCVQ7C2,*DIR('TESTLIB'),,TRANSADM
%dr-pxeacd--- TSOS
Jul 25 13:06 s
%dr-pxeacd--- TSOS
Jul 25 13:06 x
Auflisten aller Elemente eines Typs:
/SHOW-REM-FIL-ATTR PCVQ7C2,*DIR('TESTLIB/S'),,TRANSADM
*r-pxeacd--- TSOS
2048
Jul 25 13:05 test
dr-pxeacd--- TSOS
Jul 25 13:06 test()
*r-pxeacd--- TSOS
2048
Jul 25 13:06 test.outfile
Hinweis:
Alle Elemente eines Typs werden als Dateien innerhalb des Verzeichnisses dieses Typs aufgelistet. Bei der Übertragung wird dabei jeweils die höchste Version (oder Version @) geliefert. Gibt es mehrere Versionen eines Elements, so wird zusätzlich ein Verzeichnis Element() angezeigt, in dem sich die übrigen Versionen des Elements befinden.Auflisten aller zusätzlichen Versionen des Elements test:
/SHOW-REM-FIL-ATTR PCVQ7C2,*DIR('TESTLIB/S/test()'),,TRANSADM
*r-pxeacd--- TSOS
2048
Jul 25 13:06 test(12)
Anzeigen des Elements test mit der höchsten Version:
/SHOW-REM-FIL-ATTR PCVQ7C2,'TESTLIB/S/test',,TRANSADM
*r-pxeacd--- TSOS
2048
Jul 25 13:05 testlib/s/test
Anzeigen des Elements test mit der Version 12:
/SHOW-REM-FIL-ATTR PCVQ7C2,'TESTLIB/S/test()/test(12)',,TRANSADM
*r-pxeacd--- TSOS
2048
Jul 25 13:06
testlib/s/test()/test(12)