Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

LIST-NODE-FILES

&pagelevel(3)&pagelevel

Node-Files auf Net-Storage-Volume auflisten

Komponente:

BS2000

Funktionsbereich:

Dateiverarbeitung

Anwendungsbereich:

FILE                                                                                                   

Privilegierung:

STD-PROCESSING
TSOS


Berechtigungsschlüssel:

@ (bei NBCONOPI=N) bzw. E (bei NBCONOPI=Y)

Funktionsbeschreibung

Das Kommando LIST-NODE-FILES listet Node-Files (Dateien vom Dateityp NODE-FILE) auf, die sich auf einem Net-Storage-Volume befinden und die mit dem Kommando IMPORT-NODE-FILE importiert werden können. Das sind alle Node-Files mit einem BS2000-konformen Namen, die direkt in dem Benutzer-spezifischen Verzeichnis auf dem Net-Storage-Volume abgelegt sind. Verzeichnisse und darunter liegende Dateien werden nicht berücksichtigt.

Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable" im Abschnitt "LIST-NODE-FILES ").

Privilegierte Funktionen

Die Systembetreuung (Privileg TSOS) kann sich Node-Files aus allen Benutzer-spezifischen Verzeichnisse auflisten lassen.

Format

LIST-NODE-FILES                                                                                                                                       

VOLUME = <vsn 6..6>

,USER-DIRECTORY = *OWN / *ALL / <name 1..8>

,NODE-FILE-NAME = <filename 1..54 without-cat-gen-vers with-wild(80)>

,INFORMATION = *STD / *SUMMARY

,OUTPUT = *SYSOUT / list-poss(2): *SYSOUT / *SYSLST

Operandenbeschreibung

VOLUME = <vsn 6..6>
Datenträgerkennzeichen (Archivnummer, VSN) des Net-Storage-Volumes, dessen Node-Files aufgelistet werden sollen.

USER-DIRECTORY = *OWN / *ALL / <name 1..8 >
Verzeichnis der Benutzerkennung, aus dem die Node-Files aufgelistet werden. Der Verzeichnisname entspricht der Benutzerkennung. Es werden nur Dateien aufgelistet, die direkt unterhalb dieses Verzeichnisses auf dem Net-Storage-Volume liegen. Darin enthalten Directories werden nicht beachtet. Der nicht-privilegierte Benutzer kann sich nur über Node-Files der eigenen Benutzerkennung informieren.

USER-DIRECTORY = *OWN
Listet Node-Files aus dem Verzeichnis der eigenen Benutzerkennung auf.

USER-DIRECTORY = *ALL
Der Operandenwert ist dem privilegierten Anwender vorbehalten.
Listet Node-Files aus allen Benutzerverzeichnissen des Net-Storage-Volumes auf.

USER-DIRECTORY = <name 1..8 >
Listet Node-Files aus dem angegebenen Benutzerverzeichnis auf. Der Name des Verzeichnisses entspricht der Benutzerkennung. Der nicht-privilegierte Benutzer kann nur die eigene Benutzerkennung angeben.

NODE-FILE-NAME = <filename 1..54 without-cat-gen-vers with-wild(80)>
Dateinamen der Node-Files, die aufgelistet werden sollen. Es werden nur Dateien mit BS2000-konformen Dateinamen aufgelistet, d.h. Node-Files, die importiert werden können.

INFORMATION = *STD / *SUMMARY
Steuert den Umfang der auszugebenden Information.

INFORMATION = *STD
Gibt pro Node-File eine Informationszeile mit den wichtigsten Dateimerkmalen in Kurzform aus. Die Informationszeile enthält Kurzinformationen über Dateizugriffsrechte, Dateigröße, Änderungsdatum und den Dateinamen. Es werden maximal 74 Zeichen angezeigt.

INFORMATION = *SUMMARY
Gibt für jedes angegebene Benutzerverzeichnis die Anzahl der Node-Files und die Gesamtzahl der Bytes, die diese innerhalb dieses Verzeichnisses belegen, aus.

OUTPUT =
Gibt an, wohin die Information auszugeben ist.

OUTPUT = *SYSOUT
Die Ausgabe erfolgt nach SYSOUT.

OUTPUT = *SYSLST
Die Ausgabe erfolgt nach SYSLST.

 

Kommando-Returncode

(SC2)

SC1

Maincode

Bedeutung


0

CMD0001

Kommando ausgeführt


64

CMD0102

Unterbrechung mit K2-Taste


64

CMD0216

Privilegien-Fehler


64

DMS051B

Gewünschte Benutzerkennung nicht im Pubset


64

DMS0594

Nicht genügend virtueller Speicherplatz vorhanden


64

DMS0586

Der Zugriff bzw. die Belegung eines Datenträgers ist derzeit nicht möglich


32

DMS05C7

DMS interner Fehler


64

DMS0607

Fehler beim Erzeugen von S-Variablen


64

DMS0640

ONETSTOR meldet Kommunikationsproblem mit Net-Client


64

DMS0643

Net-Client meldet Zugriffsfehler


64

DMS0644

Net-Client meldet internen Fehler


64

DMS06CC

Keine Datei entspricht den Auswahlkriterien

Ausgabeformat

Beispiel einer Ausgabe

/list-node-files volume=ck68@0,user-dir=*own,node-file-name=*
 CK68@0/USER1/ ————————————————————————————————————————————————————————  (1) 
 -rw-------   10k Sep 12 14:27 NNDF1 ——————————————————————————————————  (2) 
 -rw-------    2M May 21 01:10 NNDF2
 -rw-------    1M May 21 01:15 NNDF3
 -rw-------    2M May 21 01:20 NNDF4

Erläuterung der Ausgabe

Für jedes angegebene benutzerspezifische Verzeichniss werden folgende Informationen ausgegeben:

(1)

Pfadname des benutzerspezifischen Verzeichnisses, das die angezeigten Node-Files enthält.

(2)

Für jede Datei des benutzerspezifischen Verzeichnisses werden folgende Datei-Eigenschaften angezeigt:

  • Die Zugriffsrechte bezüglich Lesen, Schreiben und Ausführen jeweils für den Dateieigentümer, die Gruppe des Benutzers und für die anderen Benutzer im UNIX-Format: r=Leserecht, w=Schreibrecht, x=Ausführrecht und „-“ bei fehlender Berechtigung.

  • Die Dateigröße in Byte (ohne Suffix), in KB (Suffix „k“), in MB (Suffix „M“) oder in GB (Suffix „G“).

  • Datum und Uhrzeit der letzten Änderung.

  • Name der Datei.

Ausgabe in S-Variable

Der Operand INFORMATION des Kommandos legt fest, welche S-Variablen erzeugt werden.

Ausgabe-Information

Name der S-Variablen

T

Inhalt

Bedingung

Name der Datei

var(*LIST).F-NAME

S

’’
<filename>

INF=*STD

Dateigröße,je nach Größe
in Byte (ohne Suffix),
in KB (Suffix „k“),
in MB (Suffix „M“)
oder in GB (Suffix „G“)

var(*LIST).F-SIZE

I

’’
<integer 0..1023>
<integer 0..1023>k
<integer 0..1023>M
<integer 0..1023>G

INF=*STD

Ausführberechtigung für GROUP

var(*LIST).GROUP.EXEC

S

’’
NO / YES

INF=*STD

Leseberechtigung für GROUP

var(*LIST).GROUP.READ

S

’’
NO / YES

INF=*STD

Schreibberechtigung für GROUP

var(*LIST).GROUP.WRITE

S

’’
NO / YES

INF=*STD

Datum des letzten ändernden
Dateizugriffs

var(*LIST).LAST-CHA-DATE

S

’’
<yyyy-mm-dd>

INF=*STD

Zeitpunkt (Uhrzeit) des letzten ändernden Dateizugriffs

var(*LIST).LAST-CHA-TIME

S

’’
<hh:mm>

INF=*STD

Anzahl der Node-Files im Verzeichnis

var(*LIST).NUM-OF-F

I

’’
<integer 0..1023>

INF=*SUM

Ausführberechtigung für OTHERS

var(*LIST).OTHERS.EXEC

S

’’
NO / YES

INF=*STD

Leseberechtigung für OTHERS

var(*LIST).OTHERS.READ

S

’’
NO / YES

INF=*STD

Schreibberechtigung für OTHERS

var(*LIST).OTHERS.WRITE

S

’’
NO / YES

INF=*STD

Ausführberechtigung für OWNER

var(*LIST).OWNER.EXEC

S

’’
NO / YES

INF=*STD

Leseberechtigung für OWNER

var(*LIST).OWNER.READ

S

’’
NO / YES

INF=*STD

Schreibberechtigung für OWNER

var(*LIST).OWNER.WRITE

S

’’
NO / YES

INF=*STD

UNIX-Dateityp

var(*LIST).UNIX-F-TYPE

S

’’
FILE

INF=*STD

UNIX-Pfadname: Directory des Node-Files

var(*LIST).UNIX-PATHNAME

S

’’
<filename>

INF=*STD/
*SUM

Summe des Speicherplatzes der Node-Files im Verzeichnis

var(*LIST).USED-BYTES

I

’’
<integer 0..1023>
<integer 0..1023>k
<integer 0..1023>M
<integer 0..1023>G

INF=*SUM

Benutzerkennung

var(*LIST).USER-ID

S

’’
<userid>

INF=*STD