Makrotyp: S-Typ (E-Form, L-Form/C-Form/D-Form) (siehe "Typen von Makroaufrufen")
Der FSTAT-Makroaufruf informiert über Katalogeinträge. Der Benutzer kann Informationen über einzelne oder mehrere Dateien, Dateigenerationen, Dateigenerationsgruppen oder alle Dateien einer Benutzerkennung anfordern.
Der Benutzer kann sich über alle Dateien unter seiner Benutzerkennung informieren, sowie über alle Dateien anderer Benutzer, auf die er zugreifen darf (vgl. die Selektionsoperanden SHARE, BASACL, OWNERAR, GROUPAR, OTHERAR, GUARDS und PROTACT).
Die Auswahl der Dateien, über die der Benutzer Informationen wünscht, erfolgt über:
den Pfadnamen. Auswahlkriterien sind Katalogkennung, Benutzerkennung und Dateiname (voll- oder teilqualifiziert, mit oder ohne Wildcards). Ohne Angabe eines Pfadnamens werden alle permanenten Dateien der eigenen Benutzerkennung aus dem Standardkatalog des lokalen Rechners ausgewählt. Temporäre Dateien müssen mit dem Tempfile-Präfix (# oder @) angesprochen werden.
Die über „pfadname“ getroffene Dateiauswahl kann der Benutzer über die Selektionsoperanden weiter einschränken. Es werden nur Dateien ausgewählt, die die in den Selektionsoperanden beschriebenen Dateimerkmale aufweisen. Wird ein Selektionsoperand nicht angegeben bzw. der Wert ANY (soweit möglich) spezifiziert, erfolgt die Auswahl unabhängig von dem entsprechenden Dateimerkmal.
Umfang und Aufbau der Informationen, die für die ausgewählten Dateien in den Ausgabebereich zu übertragen sind, kann der Benutzer im Operanden OUTPUT bestimmen:
nur Rückinformation über die Makroausführung (keine Information im Ausgabebereich)
nur die Namen der ausgewählten Dateien
statistische Informationen (z.B. Anzahl der ausgewählten Dateien je Datenträgerart)
Kataloginformationen je ausgewählter Datei
Bei Ausgabe der Kataloginformationen kann der Benutzer die Ausgabe auf einen oder mehrere Informationsblöcke, in denen Dateimerkmale zu logischen Einheiten zusammengefasst sind, beschränken (Operand CEINFO):
History-Block
Security-Block
Status-Block
Backup-Block
Organization-Block
Allocation-Block
Volumes-Block
Volume-Extents-Block
Index-Info-Block
FTAM-Information
Voreinstellung: alle Informationsblöcke (ohne FTAM-Information)
Als Informationsquelle kann der Benutzer auswählen (siehe Operand FROM):
den Standardkatalog der Benutzerkennung
alle Kataloge der lokalen Pubsets
VTOC einer Privatplatte oder eines Net-Storage-Volumes
Der FSTAT-Makroaufruf wird in sechs Versionen unterstützt (siehe auch Operand VERSION):
Version 5 für BS2000-Versionen >= BS2000 OSD-BC V11.0
Version 4 für BS2000-Versionen >= BS2000/OSD-BC V9.0
Version 3 für BS2000-Versionen >= BS2000/OSD-BC V3.0
Version 2 für BS2000-Versionen >= BS2000/OSD-BC V1.0
Version 1 für BS2000-Versionen >= V8.0
Version 0 für BS2000-Versionen
<V8.0
Voreinstellung: Version 0
Die vorliegende Beschreibung des FSTAT-Makroaufrufs bezieht sich auf den Funktionsumfang der Version 5, die im Makroaufruf explizit mit VERSION=5 vereinbart werden muss. In der Tabelle „Versionsunterschiede - VERSION=0/1/2/3/4/5" sind für die Versionen 0 bis 5 alle Abweichungen zur beschriebenen Version zusammengefasst.
Format
Operation | Operanden |
|
|
| |
|
Operandenbeschreibung
pfadname
bezeichnet den Pfadnamen der Datei(en), über die informiert werden soll, mit:
<filename 1..54 with-wild(80) without-gen>
Temporäre Dateien werden nicht berücksichtigt.
Pfadname bedeutet [:catid:][$userid][dateiname]
catid
Katalogkennung;
Default-Catid: die der Benutzerkennung zugeordnete Katalogkennung
userid
Benutzerkennung;
„$userid.“ bezeichnet alle Dateien dieses Benutzers. Wird die Benutzerkennung eines anderen Benutzers angegeben, werden nur Informationen über Dateien ausgegeben, auf die der Aufrufer des Makros zugreifen darf.
Default-Userid: eigene Benutzerkennung, d.h. die des SET-LOGON-PARAMETERS- bzw. LOGON-Kommandos
dateiname
Voll- oder teilqualifizierter Dateiname von permanenten oder temporären Dateien, von Dateigenerationen oder Dateigenerationsgruppen.
Wildcard-Angabe (Musterzeichen)
Der nichtprivilegierte Benutzer darf Musterzeichen nur in der Catid und im Dateinamen verwenden; der Systemverwalter auch in der Benutzerkennung (zu Musterzeichen siehe "Musterzeichen").
Platzhalter können nicht die Begrenzer der Namensteile cat (Doppelpunkte) und user ($-Zeichen und Punkt) ersetzen.
ACCCNT
Informiert über alle Dateien, auf die so oft, wie angegeben, zugegriffen wurde.
Der Zugriffszähler kann Werte von 0 bis 2147483647 annehmen.
= ANY
Der Zugriffszähler ist kein Auswahlkriterium.
= zahl
Informiert über Dateien, deren Zugriffszähler genau den angegebenen Wert besitzt.
= (zahl[,])
Informiert über Dateien, deren Zugriffszähler größer oder gleich dem angegebenen Wert ist.
= (,zahl)
Informiert über Dateien, deren Zugriffszähler kleiner oder gleich dem angegebenen Wert ist.
= (zahl1,zahl2)
Informiert über Dateien, deren Zugriffszähler in dem angegebenen Intervall liegt
(zahl1 <= Zugriffszähler <= zahl2).
ACCESS
Informiert abhängig von der Zugriffsart über Dateien/Dateigenerationen.
= ANY
Die Zugriffsart ist kein Auswahlkriterium.
= READ
Informiert über Dateien/Dateigenerationen, für die nur Lesezugriff gestattet ist.
= WRITE
Informiert über Dateien/Dateigenerationen, für die auch Schreibzugriff gestattet ist.
ADMINFO
Informiert abhängig von der Systemverwalter-Metainformation über Dateien/Dateigenerationen.
= *ANY
Die Systemverwalter-Metainformation ist kein Auswahlkriterium.
= *NONE
Informiert über Dateien, die keine Systemverwalter-Metainformation besitzen.
= <c-string 1..8>
Informiert über Dateien mit der angegebenen Systemverwalter-Metainformation.
AVAIL
Informiert abhängig von der Ausfallsicherheit über Dateien/Dateigenerationen.
= *ANY
Die Ausfallsicherheit ist kein Auswahlkriterium.
= *STD
Informiert über Dateien, die sich nicht auf einem Volume-Set oder einem SF-Pubset mit hoher Ausfallsicherheit befinden.
= *HIGH
Informiert über Dateien, die sich auf Platten mit hoher Ausfallsicherheit befinden (DRV-Pubset).
BACKUP
Informiert über Dateien/Dateigenerationsgruppen, für die die angegebene ARCHIVE- bzw. HSMS-Sicherungsstufe festgelegt wurde.
= ANY
Die Sicherungsstufe ist kein Auswahlkriterium.
= A
Informiert über Dateien/FGG mit dem Merkmal BACKUP=A.
= B
Informiert über Dateien/FGG mit dem Merkmal BACKUP=B.
= C
Informiert über Dateien/FGG mit dem Merkmal BACKUP=C.
= D
Informiert über Dateien/FGG mit dem Merkmal BACKUP=D.
= E
Informiert über Dateien/FGG mit dem Merkmal BACKUP=E.
= (list-of-backup)
In einer Liste können auch mehrere Sicherungsstufen angegeben werden. Dann werden alle Dateien/FGG berücksichtigt, die einer dieser Bedingungen genügen (Oder-Verknüpfung).
BASACL
Informiert über Dateien in Abhängigkeit von einer vereinbarten BASIC-ACL.
= ANY
Die BASIC-ACL ist kein Auswahlkriterium.
= NONE
Informiert über alle Dateien, für die kein BASIC-ACL-Eintrag definiert ist.
= YES
Informiert über alle Dateien, für die ein BASIC-ACL-Eintrag definiert ist.
BLKCNT
Nur für Banddateien
Informiert über Dateien in Abhängigkeit von der Anzahl der Blöcke auf Band.
= ANY
Die Anzahl der Blöcke auf Band ist kein Auswahlkriterium.
= zahl
Informiert über alle Banddateien mit genau der angegebenen Anzahl von Blöcken.
= (zahl[,])
Informiert über alle Banddateien, deren Anzahl von Blöcken größer oder gleich dem angegebenen Wert ist.
= (,zahl)
Informiert über alle Banddateien, deren Anzahl von Blöcken kleiner oder gleich dem angegebenen Wert ist.
= (zahl1,zahl2)
Informiert über alle Banddateien, deren Anzahl von Blöcken in dem angegebenen Intervall liegt.
Als Wert sind ganze Zahlen aus dem Intervall 0 <= wert <= 2147483647 erlaubt.
BLKCTRL
Informiert über Dateien, abhängig von dem Blockformat, mit dem die Datei gespeichert wurde (im FILE- oder FCB- Makroaufruf mit dem Operanden BLKCTRL definiert). Das Blockformat wird beim Erstellen der Datei festgelegt und bezieht sich auf die Existenz und Position des Blockkontrollfeldes, das die Verwaltungsinformationen für die PAM-Seite enthält.
= ANY
Das Dateiformat ist kein Auswahlkriterium.
= DATA
Informiert über alle Dateien, bei denen das Blockkontrollfeld am Anfang des Datenblocks steht. Die Dateien wurden mit BLKCTRL=DATA erstellt (siehe FILE-Makro).
= PAMKEY
Informiert über alle Dateien, die für das Blockkontrollfeld einen separaten PAM-Schlüssel nutzen, d.h., die Blockkontroll-Information steht in einem separaten Schlüsselfeld außerhalb des PAM-Blockes. Die Dateien wurden mit BLKCTRL=PAMKEY erstellt (siehe FILE-Makro).
= NO
Informiert über alle Dateien, die kein Blockkontrollfeld enthalten. Die Dateien wurden mit BLKCTRL=NO erstellt (siehe FILE-Makro).
= NONE
Informiert über alle Dateien, für die kein BLKCTRL-Wert definiert wurde, d.h. Dateien, die noch nicht eröffnet wurden.
= DATA2K
Informiert über alle Dateien, die mit BLKCTRL=DATA2K erstellt wurden (siehe FILE-Makro).
= DATA4K
Informiert über alle Dateien, die mit BLKCTRL=DATA4K erstellt wurden (siehe FILE-Makro).
= NK2
Informiert über alle NK2-Dateien (können auf NK2-Datenträgern abgelegt werden).
= NK4
Informiert über alle NK4-Dateien (können auf NK4-Datenträgern abgelegt werden).
= (list-of-blkctrl)
Informiert über alle Dateien, die einem der angegebenen Blockformate entsprechen. Innerhalb der Liste können alle Werte außer ANY angegeben werden.
CCS
Informiert über alle Dateien entsprechend der angegebenen Codiertabelle (Coded Character Set).
In der Codiertabelle ist festgelegt, wie die Zeichen eines nationalen Zeichensatzes binär abzuspeichern sind. Der festgelegte Zeichensatz beeinflusst z.B. die Bildschirmdarstellung von Zeichen, Sortierreihenfolge usw. (siehe Handbuch „XHCS“ [22])
= *ANY
Die Kodiertabelle ist kein Auswahlkriterium.
= *NONE
Nur Dateien, für die kein Zeichensatz definiert ist, werden ausgewählt.
= ccs-name
Nur Dateien mit dem angegebenen Zeichensatz werden ausgewählt.
CEINFO
Die Informationen aus dem Katalog sind in Informationsblöcken logisch zusammengefasst. Ausgegeben werden die Informationsblöcke, die der Benutzer explizit auswählt.
Mithilfe des Operanden CEINFO kann man die Generierung der DSECT bzw. CSECT steuern. Wird CEINFO nicht angegeben oder wird CEINFO=ALL gesetzt, so werden alle Ausgabeblöcke generiert (bis auf den FTAM-Block). Ansonsten werden diejenigen Ausgabeblöcke generiert, die bei CEINFO spezifiziert sind.
= ALL
Überträgt für die ausgewählten Dateien sämtliche im Katalog gespeicherten Informationen in den Ausgabebereich (OUTAREA).
Die Informationen sind folgenden Informationsblöcken zugeordnet: HISTORY / SECURITY / STATUS / BACKUP / ORGANIZATION / ALLOCATION / VOLUMES / VOLUME-EXTENTS (bzw. INDEX-INFO). Die Ausgabe der File-Transfer-Information FTAM kann über CEINFO=ALL nicht erreicht werden. Diese nur für den File-Transfer relevante Information wird nur mit CEINFO=FTAM ausgegeben.
= HISTORY
Überträgt für die ausgewählten Dateien den History-Block in den Ausgabebereich, d.h. alle Dateimerkmale, die „historischen“ Charakter haben (auf UTV-Basis):
Zugriffszähler
Datum des letzten Zugriffs
Zeitpunkt des letzten Zugriffs
Datum des letzten schreibenden Zugriffs
Tageszeit des letzten schreibenden Zugriffs
Erstellungsdatum
Tageszeit der Erstellung
Anzahl der Speicherplatzerweiterungen
Basis siehe Operand TIMBASE
= SECURITY
Überträgt für die ausgewählten Dateien den Security-Block in den Ausgabebereich, d.h. alle Dateimerkmale, die den Dateischutz betreffen (die Bytes, welche für die Dateischutzwörter bestimmt sind, werden auf binär 0 gesetzt. Ausnahme siehe Operand „PASSW“):
Art des Zugriffs (Standard-Zugriffskontrolle)
Dateiüberwachung
automatische Datenzerstörung beim Löschen
Schutz mit Ausführungskennwort
Datum, an dem die Datei wieder verändert werden darf
Zeitpunkt bezogen auf EXPIR-DATE
Schutz mit Lese-GUARD
Schutz mit Schreib-GUARD
Schutz mit Ausführungs-GUARD
Zugriffsrechte der Benutzerklasse „Group“ (BASIC-ACL)
Zugriffsrechte der Benutzerklasse „Others“ (BASIC-ACL)
Zugriffsrechte des Dateieigentümers (BASIC-ACL)
Schutz mit Lesekennwort
Schutz gegen Speicherplatzfreigabe
Angabe zur Mehrbenutzbarkeit (Standard-Zugriffskontrolle)
Schutz mit Schreibkennwort
= STATUS
Überträgt für die ausgewählten Dateien den Status-Block in den Ausgabebereich, d.h. alle Dateimerkmale, die besondere Dateieigenschaften betreffen. Dies sind:
SPECIAL-ACCOUNTING-BIT
OPEN-CLOSE-Indikator
REPAIR-Indikator
PSEUDO-CLOSE-Indikator
VERIFY-IS-FORBIDDEN-Indikator
LOCKS (RELEASE-LOCK; ERASE-LOCK; OUTPUT-LOCK; CATALOG-LOCK; SPD-LOCK)
= BACKUP
Überträgt für die ausgewählten Dateien den Backup-Block in den Ausgabebereich, d.h. alle Dateimerkmale, die die Dateisicherung betreffen:
Backup-Stufe für Archive bzw. HSMS
Angabe, ob die Datei migriert werden darf
Angabe, ob die Datei immer vollständig zu sichern ist
Version als internes ARCHIVE-Merkmal
- Angabe mit wieviel Datei-Versionen die Datei am Versions-Backup teilnimmt
= ORGANIZATION
Überträgt für die ausgewählten Dateien den Organization-Block in den Ausgabebereich, d.h. alle Dateimerkmale, die die Dateiorganisation betreffen:
Blockzähler (Banddateien)
Pufferverschiebung (Banddateien)
Blocktyp (Standard- oder Nichtstandardblock)
Codiertabelle (CCS) bei XHCS-Unterstützung
Codiertabelle für Node-Files auf Net-Storage (NETCCS)
Codeangabe für Banddateien
Eignung der Datei zur Bearbeitung in einem Cache
Dateifolgenummer (Banddatei)
Zugriffsmethode bei Erstellung der Datei
Performance-Anforderung bei Dateibearbeitung
Art der Ein-/Ausgabeoperationen für die Performance-Anforderung
Länge des ISAM-Schlüssels
Position des ISAM-Schlüssels
Standardversion der Kennsätze (Banddatei)
Länge der logischen ISAM-Markierung
Weitergabe der ISAM-Wertmarkierung
Satzformat
Satzlänge
Länge der ISAM-Wertmarkierung
Dateityp auf Net-Storage
Dateigröße von Node-Files
= ALLOCATION
Überträgt für die ausgewählten Dateien den Allocation-Block in den Ausgabebereich, d.h. alle Dateimerkmale, die die Speicherplatzbelegung betreffen:
Gerätetyp für den Datenträger
Gesamtanzahl der Extents für die Datei
höchste belegte PAM-Seite (Last Page Pointer)
Sekundärzuweisung für Dateierweiterung
Speicherebene für migrierte Dateien
Datenträgertyp
Archivnummer des belegten Datenträgers
letztes gültiges Byte auf der letzten logischen Seite der Datei (Last Byte Pointer und Gültigkeitsindikator für den Last Byte Pointer)
= VOLUMES
Überträgt für die ausgewählten Dateien die Volume-Tabellen in den Ausgabebereich. Diese enthalten folgende Informationen:
VOLUME
DEVICE
#EXTENTS
Indikator, ob es sich um ein ISAM-INDEX- oder ein ISAM-DATEN-Volume handelt
= VOLUME-EXTENTS
Überträgt für die ausgewählten Dateien die Volume-Tabellen und die Extent-Listen der Datei in den Ausgabebereich.
= INDEX-INFO
Überträgt für die ausgewählten Dateien den INDEX-INFO-Block in den Ausgabebereich, d.h. alle Dateimerkmale, die die Dateigenerationsgruppe betreffen:
Basiswert für relative Generationsnummern
jüngste bzw. zuletzt katalogisierte Dateigeneration
älteste existierende Dateigeneration
Maximalzahl der gleichzeitig katalogisierten Generationen
Vorgehensweise bei Erreichen der Maximalzahl
= FTAM
Überträgt für die ausgewählten Dateien den FTAM-Block in den Ausgabebereich, d.h. alle Dateimerkmale, die den File-Transfer betreffen.
Dieser Ausgabeblock ist nur für File-Transfer relevant, weshalb der FT-Block bei CEINFO=ALL nicht ausgegeben wird.
= (list-of-ceinfo)
In einer Liste können alle Operandenwerte außer FTAM und ALL angegeben werden. Die entsprechenden Informationblöcke werden in den Ausgabebereich übertragen. Die Reihenfolge der Angaben spielt keine Rolle.
CRDATE
Der Anwender kann über das Erstellungsdatum die Dateien auswählen, die bearbeitet werden sollen.
Datumsangaben kann der Anwender durch eine Zeitangabe ergänzen. Die Regeln für die Datums- und Zeitangaben sind auf "Format von Datumsangaben" beschrieben.
Bereichsangaben gelten jeweils einschließlich der angegebenen Grenzen.
= ANY
Das Erstellungsdatum ist kein Auswahlkriterium.
= NONE
Informiert über alle Dateien, für die noch kein Erstellungsdatum im Katalog eingetragen ist, d.h. Dateien, die noch nicht eröffnet wurden.
= datum
Informiert über alle Dateien, die an dem angegebenen Tag erstellt wurden.
= (datum[,])
Informiert über alle Dateien, die seit dem angegebenen Datum erstellt wurden (Erstellungsdatum >= datum).
= (,datum)
Informiert über alle Dateien, die bis zu dem angegebenen Datum erstellt wurden (Erstellungsdatum <= datum).
= (datum1,datum2)
Informiert über alle Dateien, die während des angegebenen Zeitraums erstellt wurden
(datum1 <= Erstellungsdatum <= datum2).
= datum(zeit[,])
Informiert über alle Dateien, die an dem angegebenen Tag und ab der angegebenen Uhrzeit erstellt wurden.
= datum(zeit1,zeit2)
Informiert über alle Dateien, die an dem angegebenen Tag und innerhalb des angegebenen Zeitraums erstellt wurden.
= (datum(zeit)[,])
Informiert über alle Dateien, die ab dem angegebenen Tag und ab der angegebenen Uhrzeit erstellt wurden.
= (,datum(zeit))
Informiert über alle Dateien, die vor dem angegebenen Tag und ab der angegebenen Uhrzeit erstellt wurden.
= (datum1(zeit),datum2(zeit))
Informiert über alle Dateien, die in dem angegebenen Zeitraum erstellt wurden. Die Ober- und Untergrenze des angegebenen Zeitraums werden jeweils durch Angabe einer Uhrzeit genauer bestimmt.
DELDATE
Der Anwender kann über das DELETION-DATE (Zeitpunkt, ab dem die Datei ohne Berücksichtigung der Schutzattribute gelöscht werden darf) die Dateien auswählen, die bearbeitet werden sollen.
Datumsangaben kann der Anwender durch eine Zeitangabe ergänzen. Hierbei ist zu beachten, dass derzeit als Löschzeitpunkt immer die Uhrzeit 00:00:00 im Dateikatalog eingetragen ist.
Die Regeln für die Datums- und Zeitangaben sind auf "Format von Datumsangaben" beschrieben. Bereichsangaben gelten jeweils einschließlich der angegebenen Grenzen.
= *ANY
Das DELETION-DATE ist kein Auswahlkriterium.
= *NONE
Informiert über alle Dateien, für die noch kein DELETION-DATE im Katalog eingetragen ist.
= datum
Informiert über alle Dateien, für die das angegebene DELETION-DATE vereinbart ist.
= (datum[,])
Informiert über alle Dateien, deren DELETION-DATE größer oder gleich dem angegebenen Datum ist.
= (,datum)
Informiert über alle Dateien, deren DELETION-DATE kleiner oder gleich dem angegebenen Datum ist.
= (datum1,datum2)
Informiert über alle Dateien, deren DELETION-DATE innerhalb des angegebenen Zeitraums liegt (datum1 <= DELETION-DATE <= datum2).
= datum(zeit[,])
Informiert über alle Dateien, für die das angegebene DELETION-DATE vereinbart ist und die Uhrzeit des Löschens größer oder gleich der angegebenen Zeit ist. Die Löschzeit (Uhrzeit bezogen auf das Löschdatum) wird derzeit immer mit 00:00:00 Uhr im Katalog eingetragen!
= datum(zeit1,zeit2)
Informiert über alle Dateien, für die das angegebene DELETION-DATE vereinbart ist und die Uhrzeit der Freigabe innerhalb des angegebenen Zeitintervalls liegt. Die Freigabezeit (Uhrzeit bezogen auf das Freigabedatum) wird derzeit immer mit 00:00:00 Uhr im Katalog eingetragen!
= (datum(zeit)[,])
Informiert über alle Dateien, deren DELETION-DATE und Freigabezeit größer oder gleich dem angegebenen Zeitpunkt ist. Die Freigabezeit (Uhrzeit bezogen auf das Freigabedatum) wird derzeit immer mit 00:00:00 Uhr im Katalog eingetragen!
= (,datum(zeit))
Informiert über alle Dateien, deren DELETION-DATE und Freigabezeit kleiner oder gleich dem angegebenen Zeitpunkt ist. Die Freigabezeit (Uhrzeit bezogen auf das Freigabedatum) wird derzeit immer mit 00:00:00 Uhr im Katalog eingetragen!
= (datum1(zeit),datum2(zeit))
Informiert über alle Dateien, deren DELETION-DATE innerhalb des angegebenen Zeitraums liegt (datum1 <= Freigabedatum <= datum2). Die Ober- und Untergrenze des angegebenen Zeitraums werden jeweils durch Angabe einer Uhrzeit genauer bestimmt.
DISKWR
Der Anwender kann die zu bearbeitenden Dateien auswählen abhängig von dem im Katalog vereinbarten Zeitpunkt, zu dem Datenkonsistenz gefordert wird.
= ANY
Der im Katalog vereinbarten Zeitpunkt, zu dem Datenkonsistenz gefordert wird, ist kein Auswahlkriterium.
= IMMEDIATE
Informiert über alle Dateien, bei denen Datenkonsistenz direkt nach Beendigung einer Schreiboperation gefordert wird. Diese Dateien eignen sich nicht zur Bearbeitung in einem Schreib-Cache.
= BY-CLOSE
Informiert über alle Dateien, bei denen Datenkonsistenz erst nach der CLOSE-Verarbeitung gefordert wird. Diese Dateien eignen sich zur Bearbeitung in einem Schreib-Cache.
ENCRYPT
Der Anwender kann Dateien danach auswählen, ob und mit welcher Verschlüsselungsmethode sie verschlüsselt sind.
= *ANY
Es sollen alle Dateien bearbeitet werden, unabhängig davon, ob und mit welcher Verschlüsselungsmethode sie verschlüsselt sind.
= *NONE
Es werden nur die Dateien, die nicht verschlüsselt sind, selektiert.
= *AES
Es werden nur die Dateien, die mit der AES-Verschlüsselungsmethode verschlüsselt sind, selektiert.
= * DES
Es werden nur die Dateien, die mit der DES-Verschlüsselungsmethode verschlüsselt sind, selektiert.
= (list_of_encrypt)
Es werden nur Dateien bearbeitet, die einem der angegebenen Auswahlkriterien entsprechen. Innerhalb der Liste können alle Werte außer ANY angegeben werden.
EXDATE
Der Anwender kann über das Freigabedatum (Expiration Date) die Dateien auswählen, die bearbeitet werden sollen.
Das im Katalog vereinbarte Freigabedatum gibt an, ab wann die Datei erstmals wieder verändert oder gelöscht werden darf. Wird beim Erstellen der Datei kein Freigabedatum vereinbart, erhält es denselben Wert wie das Erstellungsdatum.
Datumsangaben kann der Anwender durch eine Zeitangabe ergänzen. Hierbei ist zu beachten, dass derzeit als Freigabezeitpunkt immer die Uhrzeit 00:00:00 im Dateikatalog eingetragen ist.
Die Regeln für die Datums- und Zeitangaben sind auf "Format von Datumsangaben" beschrieben. Bereichsangaben gelten jeweils einschließlich der angegebenen Grenzen.
= ANY
Das Freigabedatum ist kein Auswahlkriterium.
= NONE
Informiert über alle Dateien, für die noch kein Freigabedatum im Katalog eingetragen ist, d.h. Dateien, die noch nicht eröffnet wurden.
= datum
Informiert über alle Dateien, für die das angegebene Freigabedatum vereinbart ist.
= (datum[,])
Informiert über alle Dateien, deren Freigabedatum größer oder gleich dem angegebenen Datum ist.
= (,datum)
Informiert über alle Dateien, deren Freigabedatum kleiner oder gleich dem angegebenen Datum ist.
= (datum1,datum2)
Informiert über alle Dateien, deren Freigabedatum innerhalb des angegebenen Zeitraums liegt (datum1 <= Freigabedatum <= datum2).
= datum(zeit[,])
Informiert über alle Dateien, für die das angegebene Freigabedatum vereinbart ist und die Uhrzeit der Freigabe größer oder gleich der angegebenen Zeit ist. Die Freigabezeit (Uhrzeit bezogen auf das Freigabedatum) wird derzeit immer mit 00:00:00 Uhr im Katalog eingetragen!
= datum(zeit1,zeit2)
Informiert über alle Dateien, für die das angegebene Freigabedatum vereinbart ist und die Uhrzeit der Freigabe innerhalb des angegebenen Zeitintervalls liegt. Die Freigabezeit (Uhrzeit bezogen auf das Freigabedatum) wird derzeit immer mit 00:00:00 Uhr im Katalog eingetragen!
= (datum(zeit)[,])
Informiert über alle Dateien, deren Freigabedatum und Freigabezeit größer oder gleich dem angegebenen Zeitpunkt ist. Die Freigabezeit (Uhrzeit bezogen auf das Freigabedatum) wird derzeit immer mit 00:00:00 Uhr im Katalog eingetragen!
= (,datum(zeit))
Informiert über alle Dateien, deren Freigabedatum und Freigabezeit kleiner oder gleich dem angegebenen Zeitpunkt ist. Die Freigabezeit (Uhrzeit bezogen auf das Freigabedatum) wird derzeit immer mit 00:00:00 Uhr im Katalog eingetragen!
= (datum1(zeit),datum2(zeit))
Informiert über alle Dateien, deren Freigabedatum innerhalb des angegebenen Zeitraums liegt (datum1 <= Freigabedatum <= datum2). Die Ober- und Untergrenze des angegebenen Zeitraums werden jeweils durch Angabe einer Uhrzeit genauer bestimmt.
EXTENTS
Nur für Dateien auf Platte oder Net-Storage:
Informiert über alle Dateien entsprechend der angegebenen Zahl ihrer Extents. Ein Extent ist ein zusammenhängender Bereich, den eine Datei auf einer Platte belegt. Die Anzahl der Extents, aus der eine Datei besteht, ist im Katalog hinterlegt.
Für „zahl“ gilt: 0 <= zahl <= 65535; Bereichsangaben gelten jeweils einschließlich der Bereichsgrenzen.
= ANY
Die Anzahl der Extents ist kein Auswahlkriterium.
= zahl
Es werden nur Plattendateien mit genau der angegebenen Zahl von Extents bearbeitet.
= (zahl [,])
Es werden nur Plattendateien bearbeitet, die mindestens so viele Extents haben wie angegeben (Anzahl der Extents >= zahl).
= (,zahl)
Es werden nur Plattendateien bearbeitet, die höchstens so viele Extents haben wie angegeben (Anzahl der Extents <= zahl).
= (zahl1, zahl2)
Es werden nur Plattendateien bearbeitet, die mindestens so viele Extents haben wie „zahl1“ und höchstens so viele wie „zahl2“ (zahl1 <= Anzahl der Extents <= zahl2).
FCBTYPE
Informiert über Dateien/Dateigenerationen in Abhängigkeit von der Zugriffsmethode, mit der sie erstellt wurden. Werden mehrere Zugriffsmethoden in Listenform angegeben, nimmt das System eine logische Oder-Verknüpfung vor und informiert über alle Dateien, die einer der Bedingungen genügen.
= ANY
Die Zugriffsmethode ist kein Auswahlkriterium.
= NONE
Informiert über Dateien, die zwar katalogisiert sind, aber keine Daten enthalten, d.h. die noch nicht eröffnet wurden oder deren Speicherplatz freigegeben wurde mit ERASE..., SPACE.
= ISAM
Informiert über ISAM-Dateien.
= BTAM
Informiert über BTAM-Dateien.
= SAM
Informiert über SAM-Dateien.
= PAM
Informiert über PAM-Dateien.
= (list-of-fcbtype)
In einer Liste können mehrere Zugriffsmethoden angegeben werden. Informiert über alle Dateien, die mit einer der angegebenen Zugriffsmethoden erstellt wurden.
FILTYPE
Informiert über alle Dateien, die dem angegebenen Dateityp entsprechen.
= *ANY
Informiert sowohl über BS2000-Dateien als auch über Node-Files.
= *BS2000
Informiert nur über BS2000-Dateien.
= *NODE
Informiert nur über Node-Files (Dateien, die von BS2000 und von offenen Systemen angelegt und geändert werden können).
FROM
Der Operand FROM definiert die Quelle für die FSTAT-Informationen.
= CATALOG
Der FSTAT-Makroaufruf bezieht seine Informationen aus dem Katalog des Default-Pubsets der Benutzerkennung, d.h. dem Katalog mit der Default-Catid.
= LOCALPVS
Der FSTAT-Makroaufruf bezieht seine Informationen aus den Systemkatalogen aller selektierten lokalen Pubsets.
= (vsn,gerät)
Der FSTAT-Makroaufruf bezieht seine Informationen aus dem Inhaltsverzeichnis der mit „vsn“ bezeichneten Privatplatte bzw. aus dem Katalog des mit „vsn“ bezeichneten Net-Storage-Volumes.
Für ein Net-Storage-Volume ist bei „gerät“ der Volumetyp NETSTOR anzugeben. Andernfalls muss der Gerätetyp der Privatplatte angegeben werden; mögliche Werte sind der Gerätetabelle im Handbuch „Systeminstallation [16] zu entnehmen. Die Operanden „VOLUME“, „SUPPORT“ und „VTOC“ dürfen nicht angegeben werden.
FSIZE
Nur für Plattendateien:
Informiert über Dateien/Dateigenerationsgruppen in Abhängigkeit von der Größe freien (= reservierten, aber nicht belegten) Speicherplatzes; 0 <= zahl <= 16777215
= ANY
Die Größe des freien (= reservierten, aber nicht belegten) Speicherplatzes ist kein Auswahlkriterium.
= SIZE
Informiert über Dateien, bei denen die Zahl der freien PAM-Seiten gleich der der reservierten ist.
= zahl
Informiert über Dateien mit genau der angegebenen Anzahl reservierter, aber nicht belegter PAM-Seiten.
= (zahl[,])
Informiert über Dateien mit mindestens der angegebenen Zahl reservierter, aber nicht belegter PAM-Seiten.
= (,zahl)
Informiert über Dateien mit höchstens der angegebenen Zahl reservierter, aber nicht belegter PAM-Seiten.
= (zahl1,zahl2)
Informiert über Dateien, deren Anzahl freier Seiten im angegebenen Bereich liegt (zahl1 < zahl2).
GEN
Der Operand „GEN“ legt fest, ob Informationen zu Dateigenerationen ausgegeben werden.
Die Wechselwirkung mit der Angabe TYPE=FGG gibt die folgende Tabelle wieder:
TYPE=FGG | GEN=YES | GEN=NO | Information | Information zu Dateigenerationen | Information |
x | x | * | * | - | |
x | x | * | - | - | |
x | * | * | * | ||
x | * | - | * |
x | Angabe im FSTAT-Makroaufruf |
* | bei der Makrobearbeitung berücksichtigt |
- | bei der Makrobearbeitung nicht berücksichtigt |
= NO
Es werden keine Informationen zu Dateigenerationen ausgegeben.
= YES
Es werden Informationen zu Dateigenerationen ausgegeben.
Die Angabe GEN=YES wird nur berücksichtigt, wenn in „pfadname“ kein „dateiname“ angegeben wurde.
GROUPAR
Informiert über Dateien in Abhängigkeit von den Zugriffsrechten, die in ihren BASIC-ACL-Einträgen für die Mitglieder der Benutzergruppe des Dateieigentümers festgelegt sind.
= ANY
Die BASIC-ACL-Einträge für die Mitglieder der Benutzergruppe des Dateieigentümer sind kein Auswahlkriterium.
= NO-ACCESS
Informiert über alle Dateien, auf die die Benutzergruppe des Eigentümers nicht zugreifen darf.
= zugriffsliste
Informiert über alle Dateien, in deren BASIC-ACL-Eintrag für die Benutzergruppe des Dateieigentümers mindestens eines der in der Liste angegebenen Zugriffsrechte vereinbart ist.
zugriffsliste hat folgendes Format:
Langform:
([READ=YES / READ=NO][,WRITE=YES / WRITE=NO][,EXEC=YES / EXEC=NO])Kurzform:
([R=Y / R=N][,W=Y / W=N][,X=Y / X=N])
Die runden Klammern sind Bestandteil des Operandenwertes und müssen mit angegeben werden.
Die einzelnen Elemente der Zugriffsliste haben folgende Bedeutung:
READ=YES bzw. R=Y | Informiert über alle Dateien, auf die die Benutzergruppe des Eigentümers lesend zugreifen darf. |
READ=NO bzw. R=N | Informiert über alle Dateien, auf die die Benutzergruppe des Eigentümers nicht lesend zugreifen darf. |
WRITE=YES bzw. W=Y | Informiert über alle Dateien, auf die die Benutzergruppe des Eigentümers schreibend zugreifen darf. |
WRITE=NO bzw. W=N | Informiert über alle Dateien, auf die die Benutzergruppe des Eigentümers nicht schreibend zugreifen darf. |
EXEC=YES bzw. X=Y | Informiert über alle Dateien, die die Benutzergruppe des Eigentümers ausführen darf. |
EXEC=NO bzw. X=N | Informiert über alle Dateien, die die Benutzergruppe des Eigentümers nicht ausführen darf. |
GUARDS
Der Anwender kann die zu bearbeitenden Dateien auswählen abhängig von einem vereinbarten Zugriffsschutz mit GUARDS (siehe Handbuch „SECOS“ [8]).
= *ANY
Der vereinbarte Zugriffsschutz mit GUARDS ist kein Auswahlkriterium.
= *NONE
Informiert über alle Dateien, die keinen Zugriffsschutz über GUARDS definiert haben.
= *YES
Informiert über alle Dateien, die einen Zugriffsschutz über GUARDS definiert haben.
= (READ=...,WRITE=...,EXEC=...)
Innerhalb einer Liste kann der Anwender angeben, wie der Zugriffschutz mit GUARDS für die auszuwählenden Dateien vereinbart sein soll. Für jede Zugriffsart (Lesen, Schreiben und Ausführen) kann der vereinbarte Schutz genau angegeben werden. Wird für eine Zugriffsart keine Angabe gemacht, so erfolgt die Auswahl unabhängig von dem dafür vereinbarten Schutz.
Je Zugriffsart kann einer der folgenden Werte angegeben werden:
*ANY | Der vereinbarte GUARDS-Schutz ist kein Auswahlkriterium. |
*NONE | Für die angegebene Zugriffsart ist kein Guard vereinbart, d.h. der entsprechende Zugriff wird untersagt. |
fname | Für die angegebene Zugriffsart sind im Guard fname alle Bedingungen für die Zugriffserlaubnis enthalten. |
IOPERF
Performance-Eigenschaft der Datei. Informiert über alle Dateien, abhängig von dem Performance-Attribut, das im Katalog vereinbart wurde (siehe Operand IOPERF, CATAL-Makro).
= ANY
Die Performance-Eigenschaft ist kein Auswahlkriterium.
= STD
Informiert über alle Dateien, deren Performance-Attribut mit STD vereinbart wurde.
= HIGH
Informiert über alle Dateien, deren Performance-Attribut mit HIGH vereinbart wurde (hohe Performance-Priorität).
= VERY-HIGH
Informiert über alle Dateien, deren Performance-Attribut mit VERY-HIGH vereinbart wurde (höchste Performance-Priorität).
= (list-of-ioperf)
In einer Liste können bis zu drei Performance-Attribute angegeben werden. Informiert über alle Dateien, die eines der angegebenen Attribute besitzen.
IOUSAGE
Informiert über alle Dateien, abhängig von der Art der Ein-/Ausgabe-Operationen, auf die sich das Performance-Attribut bezieht (siehe Operand IOUSAGE, CATAL-Makro).
= ANY
Das Performance-Attribut ist kein Auswahlkriterium.
= RDWRT
Informiert über alle Dateien, deren Performance-Attribut sich auf Schreib- und Leseoperationen bezieht.
= WRITE
Informiert über alle Dateien, deren Performance-Attribut sich nur auf Schreiboperationen bezieht.
= READ
Informiert über alle Dateien, deren Performance-Attribut sich nur auf Leseoperationen bezieht.
= (list-of-iousage)
In einer Liste können mehrere Arten von Ein-/Ausgabe-Operationen angegeben werden. Informiert über alle Dateien, deren Performance-Attribut sich auf eine der angegebenen Ein-/Ausgabe-Operationen bezieht.
LADATE
Informiert über alle Dateien mit entsprechendem Datum des letzten Zugriffs.
Datumsangaben kann der Anwender durch eine Zeitangabe ergänzen. Die Regeln für die Datums- und Zeitangaben sind auf "Format von Datumsangaben" beschrieben.
Bereichsangaben gelten jeweils einschließlich der angegebenen Grenzen.
= ANY
Das Datum des letzten Zugriffs ist kein Auswahlkriterium.
= NONE
Informiert über alle Dateien, für die noch kein Zugriffsdatum im Katalog eingetragen ist, d.h. Dateien, die noch nicht eröffnet wurden.
= datum
Informiert über alle Dateien, auf die an dem angegebenen Tag zuletzt zugegriffen wurde.
= (datum[,])
Informiert über alle Dateien, auf die ab dem angegebenen Datum zuletzt zugegriffen wurde (letzter Zugriff >= datum).
= (,datum)
Informiert über alle Dateien, auf die bis zu dem angegebenen Datum zuletzt zugegriffen wurde (letzter Zugriff <= datum).
= (datum1,datum2)
Informiert über alle Dateien, auf die während des angegebenen Zeitraums zuletzt zugegriffen wurde (datum1 <= letzter Zugriff <= datum2).
= datum(zeit[,])
Informiert über alle Dateien, auf die an dem angegebenen Tag und ab der angegebenen Uhrzeit zuletzt zugegriffen wurde.
= datum(zeit1,zeit2)
Informiert über alle Dateien, auf die an dem angegebenen Tag und innerhalb des angegebenen Zeitraums zuletzt zugegriffen wurde.
= (datum(zeit)[,])
Informiert über alle Dateien, auf die ab dem angegebenen Tag und ab der angegebenen Uhrzeit zuletzt zugegriffen wurde.
= (,datum(zeit))
Informiert über alle Dateien, auf die vor dem angegebenen Tag und der angegebenen Uhrzeit zuletzt zugegriffen wurde.
= (datum1(zeit),datum2(zeit))
Informiert über alle Dateien, auf die in dem angegebenen Zeitraum zuletzt zugegriffen wurde. Die Ober- und Untergrenze des angegebenen Zeitraums werden jeweils durch Angabe einer Uhrzeit genauer bestimmt.
LASTPAG
Informiert über Dateien in Abhängigkeit vom belegten Speicherplatz (d.h. von der Anzahl beschriebener PAM-Seiten).
= ANY
Der belegte Speicherplatz ist kein Auswahlkriterium.
= zahl
Informiert über alle Dateien mit genau der angegebenen Anzahl beschriebener PAM-Seiten.
= (zahl,)
Informiert über alle Dateien mit mindestens der angegebenen Anzahl beschriebener PAM-Seiten.
= (,zahl)
Informiert über alle Dateien mit höchstens der angegebenen Anzahl beschriebener PAM-Seiten.
= (zahl1,zahl2)
Informiert über alle Dateien, deren Anzahl beschriebener PAM-Seiten im angegebenen
Bereich liegt (zahl1 < zahl2).
LBPOINT
Informiert über Dateien in Abhängigkeit von der Eigenschaft des Last Byte Pointers (LBP).
= *ANY
Der Last Byte Pointer dient nicht als Auswahlkriterium.
= *NO
Informiert über Dateien, die keinen gültigen Last Byte Pointer besitzen.
= *YES
Informiert über Dateien, die einen gültigen Last Byte Pointer besitzen.
= *ZERO
Informiert über Dateien, die einen gültigen Last Byte Pointer mit dem Wert Null besitzen.
= *NONZERO
Informiert über Dateien, die einen gültigen Last Byte Pointer mit einem Wert ungleich Null besitzen.
LCDATE
Informiert über alle Dateien entsprechend dem Datum des letzten Schreibzugriffs.
Datumsangaben kann der Anwender durch eine Zeitangabe ergänzen. Die Regeln für die Datums- und Zeitangaben sind auf "Format von Datumsangaben" beschrieben.
Bereichsangaben gelten jeweils einschließlich der angegebenen Grenzen.
= ANY
Das Datum des letzten Schreibzugriffs ist kein Auswahlkriterium.
= NONE
Informiert über alle Dateien, für die noch kein Datum des letzten Schreibzugriffs im Katalog eingetragen ist, d.h. Dateien, die noch nicht eröffnet wurden.
= datum
Informiert über alle Dateien, auf die an dem angegebenen Tag zuletzt schreibend zugegriffen wurde.
= (datum[,])
Informiert über alle Dateien, auf die ab dem angegebenen Datum zuletzt schreibend zugegriffen wurde (letzter Zugriff >= datum).
= (,datum)
Informiert über alle Dateien, auf die bis zu dem angegebenen Datum zuletzt schreibend zugegriffen wurde (letzter Zugriff <= datum).
= (datum1,datum2)
Informiert über alle Dateien, auf die während des angegebenen Zeitraums zuletzt schreibend zugegriffen wurde (datum1 <= letzter Zugriff <= datum2).
= datum(zeit[,])
Informiert über alle Dateien, auf die an dem angegebenen Tag und ab der angegebenen Uhrzeit zuletzt schreibend zugegriffen wurde.
= datum(zeit1,zeit2)
Informiert über alle Dateien, auf die an dem angegebenen Tag und innerhalb des angegebenen Zeitraums zuletzt schreibend zugegriffen wurde.
= (datum(zeit)[,])
Informiert über alle Dateien, auf die ab dem angegebenen Tag und ab der angegebenen Uhrzeit zuletzt schreibend zugegriffen wurde.
= (,datum(zeit))
Informiert über alle Dateien, auf die vor dem angegebenen Tag und der angegebenen Uhrzeit zuletzt schreibend zugegriffen wurde.
= (datum1(zeit),datum2(zeit))
Informiert über alle Dateien, auf die in dem angegebenen Zeitraum zuletzt schreibend zugegriffen wurde. Die Ober- und Untergrenze des angegebenen Zeitraums werden jeweils durch Angabe einer Uhrzeit genauer bestimmt.
MANCLAS
Informiert über alle Dateien entsprechend der HSMS-Management-Klasse zur Dateisicherung auf SM-Pubsets.
= *ANY
Die HSMS-Management-Klasse ist kein Auswahlkriterium.
= *NONE
Nur Dateien, für die keine HSMS-Management-Klasse definiert ist, werden ausgewählt.
= <c-string 1..8>
Nur Dateien mit der angegebenen HSMS-Management-Klasse werden ausgewählt.
MF
Die Formen des MF-Operanden sind detailliert im Anhang ("Typen von Makroaufrufen") beschrieben. In allen Makroaufrufen, die sich durch den MF-Operanden unterscheiden (MF=L/E/D/...), muss der Operand VERSION den gleichen Wert haben.
Besonderheit bei MF=D/C:
Über den Operanden CEINFO kann der Benutzer steuern, welche Ausgabeblöcke generiert werden sollen (XPAND=OUTPUT). Es werden nur die Blöcke bei MF=D/C expandiert, die der Benutzer bei CEINFO spezifiziert hat.
MIGRATE
Informiert über alle Dateien, die im Katalog den angegebenen Eintrag für MIGRATE besitzen. Dieser Eintrag wird vom Hierarchischen Speicher Management System HSMS bei der Verdrängung (Migration) von Dateien ausgewertet (siehe Makro CATAL, Operand MIGRATE "CATAL - Katalogeintrag bearbeiten"). Bei Angabe in Listenform werden alle Dateien selektiert, die einer der Bedingungen genügen.
= ANY
Der MIGRATE-Eintrag ist kein Auswahlkriterium.
= ALLOWED
Informiert nur über Dateien, für die im Katalogeintrag MIGRATE=ALLOWED vereinbart wurde, d.h. Dateien, die auf die Speicherebene S1 oder S2 verdrängt werden dürfen.
= INHIBIT
Informiert nur über Dateien, für die im Katalogeintrag MIGRATE=INHIBIT vereinbart wurde, d.h. Dateien, die kurzfristig (z.B. für Reorganisationszwecke) verdrängt werden dürfen.
= FORBIDDEN
Informiert nur über Dateien, für die im Katalogeintrag MIGRATE=FORBIDDEN vereinbart wurde, d.h. Dateien, die nicht verdrängt werden dürfen.
= (list-of-migrate)
Der Anwender kann die gewünschten Werte in einer Liste angeben. Informiert über alle Dateien, für die im Katalog einer der angegebenen Werte vereinbart wurde.
OTHERAR
Informiert über Dateien in Abhängigkeit von den Zugriffsrechten, die in ihren BASIC-ACL-Einträgen für alle Anwender außerhalb der Benutzergruppe des Dateieigentümers festgelegt sind.
= ANY
Die BASIC-ACL-Einträge für alle Anwender außerhalb der Benutzergruppe des Dateieigentümers sind kein Auswahlkriterium.
= NO-ACCESS
Informiert über alle Dateien, auf die Anwender außerhalb der Benutzergruppe des Eigentümers nicht zugreifen dürfen.
= zugriffsliste
Informiert über alle Dateien, in deren BASIC-ACL-Eintrag für Anwender außerhalb der Benutzergruppe des Dateieigentümers mindestens eines der in der Liste angegebenen Zugriffsrechte vereinbart ist.
zugriffsliste hat folgendes Format:
Langform:
([READ=YES / READ=NO][,WRITE=YES / WRITE=NO][,EXEC=YES / EXEC=NO])Kurzform:
([R=Y / R=N][,W=Y / W=N][,X=Y / X=N])
Die runden Klammern sind Bestandteil des Operandenwertes und müssen mit angegeben werden.
Die einzelnen Elemente der Zugriffsliste haben folgende Bedeutung:
READ=YES bzw. R=Y | Informiert über alle Dateien, auf die Anwender außerhalb der Benutzergruppe des Eigentümers lesend zugreifen dürfen. |
READ=NO bzw. R=N | Informiert über alle Dateien, auf die Anwender außerhalb der Benutzergruppe des Eigentümers nicht lesend zugreifen dürfen. |
WRITE=YES bzw. W=Y | Informiert über alle Dateien, auf die Anwender außerhalb der Benutzergruppe des Eigentümers schreibend zugreifen dürfen. |
WRITE=NO bzw. W=N | Informiert über alle Dateien, auf die Anwender außerhalb der Benutzergruppe des Eigentümers nicht schreibend zugreifen dürfen. |
EXEC=YES bzw. X=Y | Informiert über alle Dateien, die Anwender außerhalb der Benutzergruppe des Eigentümers ausführen dürfen. |
EXEC=NO bzw. X=N | Informiert über alle Dateien, die Anwender außerhalb der Benutzergruppe des Eigentümers nicht ausführen dürfen. |
OUTAREA
Ausgabebereich für Informationen aus dem Katalogeintrag.
= (<list-of-elements-002>)
Der Ausgabebereich wird in Listenform angegeben, bestehend aus:
Adresse des Ausgabebereichs. Sie kann nur als Konstante oder als Equate angegeben werden und muss auf Wortgrenze ausgerichtet sein.
Länge des Ausgabebereiches (in Byte). Welcher Wert anzugeben ist, hängt vom Informationsumfang ab, der über den Operanden OUTPUT angefordert wird. Sie kann nur als Konstante oder als Equate angegeben werden.
Das Format des Ausgabebereiches ist auf "Hinweise zur Programmierung (VERSION=2, 3 und 4)" beschrieben.
Hinweis
Für die beiden Ausgabebereiche (OUTAREA, STOUTAR) werden intern SPECIFIED-Bits gesetzt. Wenn eine Ausgabe erfolgen soll, muss das jeweilige AREA-SPECIFIED-Bit gesetzt sein. Die Bits werden bei MF=L gesetzt. Aus diesem Grund ist es sinnvoll, beim MF=L-Aufruf den Operand OUTAREA bzw. STOUTAR mit Dummy-Werten zu versorgen.
OUTPUT
Die Ausgabestruktur in Blöcken besteht aus zwei unabhängigen Teilen: Informationen aus dem Katalogeintrag und statistische Informationen über alle selektierten Katalogeinträge. Zum Aufbau der verschiedenen Informationsblöcke siehe "Hinweise zur Programmierung (VERSION=2, 3 und 4)".
Die Informationen aus dem Katalogeintrag werden in den durch den Operanden OUTAREA spezifizierten Ausgabebereich übertragen.
Die statistischen Informationen werden in den durch den Operanden STOUTAR spezifizierten Ausgabebereich übertragen.
= RC-ONLY
Es wird nur der Returncode zurückgegeben. Ein Ausgabebereich wird nicht benötigt.
= FNAM-ONLY
Es werden nur die Pfadnamen (mit PVSID, USERID und FILENAME) in den Ausgabebereich übertragen (Beschreibung siehe "Hinweise zur Programmierung (VERSION=2, 3 und 4)").
Die Pfadnamen werden in den durch den Operanden OUTAREA spezifizierten Ausgabebereich übertragen.
= CEINFO
Es werden Informationen aus den Katalogeinträgen ausgegeben. Welche Informationen ausgegeben werden, kann über den Operanden CEINFO gesteuert werden. Statistische Informationen werden nicht gegeben (Beschreibung siehe "Hinweise zur Programmierung (VERSION=2, 3 und 4)").
Die Informationen aus dem Katalogeintrag werden in den durch den Operanden OUTAREA spezifizierten Ausgabebereich übertragen.
= STAT-SHORT
Es werden nur die statistischen Informationen in den statistischen Ausgabebereich übertragen (Beschreibung siehe "Hinweise zur Programmierung (VERSION=2, 3 und 4)").
Die statistischen Informationen werden in den durch den Operanden STOUTAR spezifizierten Ausgabebereich übertragen.
Hinweis
Es können keine statistischen Daten übertragen werden, wenn gleichzeitig der Operand FROM=(volume,device) spezifiziert wird. Ein derartiger Funktionsaufruf wird mit Returncode DMS0576 abgewiesen.
= STAT-LONG
Es werden nur die statistischen Informationen in den statistischen Ausgabebereich übertragen. Zusätzlich zur Ausgabe von STAT-SHORT werden auch statistische Informationen pro PVSID und USERID übertragen (Beschreibung siehe "Hinweise zur Programmierung (VERSION=2, 3 und 4)").
Die statistischen Informationen werden in den durch den Operanden STOUTAR spezifizierten Ausgabebereich übertragen.
Hinweis
Es können keine statistischen Daten übertragen werden, wenn gleichzeitig der Operand FROM=(volume,device) spezifiziert wird. Ein derartiger Funktionsaufruf wird mit Returncode DMS0576 abgewiesen.
= STAT-INFO
Es werden die Informationen der Katalogeinträge und die statistischen Informationen ausgegeben (entspricht der Ausgabemenge CEINFO + STAT-LONG).
Beide Teile der Ausgabe werden mit Pointern miteinander verkettet (Beschreibung siehe "Hinweise zur Programmierung (VERSION=2, 3 und 4)").
Die Informationen aus dem Katalogeintrag werden in den durch den Operanden OUTAREA spezifizierten Ausgabebereich übertragen.
Die statistischen Informationen werden in den durch den Operanden STOUTAR spezifizierten Ausgabebereich übertragen.
Hinweis
Es können keine statistischen Daten übertragen werden, wenn gleichzeitig der Operand FROM=(volume,device) spezifiziert wird. Ein derartiger Funktionsaufruf wird mit Returncode DMS0576 abgewiesen.
OWNERAR
Informiert über Dateien in Abhängigkeit von den Zugriffsrechten, die in ihren BASIC-ACL-Einträgen für die Dateieigentümer festgelegt sind.
= ANY
Die BASIC-ACL-Einträge für die Dateieigentümer sind kein Auswahlkriterium.
= NO-ACCESS
Informiert über alle Dateien, auf die der Eigentümer nicht zugreifen darf.
= zugriffsliste
Informiert über alle Dateien, in deren BASIC-ACL-Eintrag für den Dateieigentümer mindestens eines der in der Liste angegebenen Zugriffsrechte vereinbart ist.
zugriffsliste hat folgendes Format:
Langform:
([READ=YES / READ=NO][,WRITE=YES / WRITE=NO][,EXEC=YES / EXEC=NO])Kurzform:
([R=Y / R=N][,W=Y / W=N][,X=Y / X=N])
Die runden Klammern sind Bestandteil des Operandenwertes und müssen mit angegeben werden.
Die einzelnen Elemente der Zugriffsliste haben folgende Bedeutung:
READ=YES bzw. R=Y | Informiert über alle Dateien, auf die der Eigentümer lesend zugreifen darf. |
READ=NO bzw. R=N | Informiert über alle Dateien, auf die der Eigentümer nicht lesend zugreifen darf. |
WRITE=YES bzw. W=Y | Informiert über alle Dateien, auf die der Eigentümer schreibend zugreifen darf. |
WRITE=NO bzw. W=N | Informiert über alle Dateien, auf die der Eigentümer nicht schreibend zugreifen darf. |
EXEC=YES bzw. X=Y | Informiert über alle Dateien, die der Eigentümer ausführen darf. |
EXEC=NO bzw. X=N | Informiert über alle Dateien, die der Eigentümer nicht ausführen darf. |
PASS
Informiert über Dateien/Dateigenerationsgruppen in Abhängigkeit von einem mit CATAL definierten Kennwortschutz. Werden mehrere Kennwortarten in Listenform angegeben, nimmt das System eine logische Oder-Verknüpfung vor und informiert über alle Dateien, die einer der genannten Bedingungen genügen. Kennwörter werden nicht ausgegeben.
= ANY
Der Kennwortschutz ist kein Auswahlkriterium.
= NONE
Informiert über Dateien, für die kein Kennwortschutz besteht.
= RDPASS
Informiert darüber, welche Dateien durch ein Lesekennwort geschützt sind.
= WRPASS
Informiert darüber, welche Dateien durch ein Schreibkennwort geschützt sind.
= EXPASS
Informiert darüber, welche Dateien mit einem Ausführungskennwort geschützt sind.
= (list-of-pass)
In einer Liste kann der Anwender mehrere Arten des Kennwortschutzes angeben. Informiert über alle Dateien, die mit einem der angegebenen Kennworttypen geschützt sind.
PASSW
Der Operand PASSW bestimmt, wie Kennwörter in den Ausgabebereich übertragen werden.
= NO
Kennwörter werden im Ausgabebereich nicht explizit dargestellt. Die entsprechenden Felder sind binär 0 gesetzt.
= YES
Nur für privilegierte Anwender
Kennwörter werden im Ausgabebereich explizit dargestellt.
PREFIX
wird nur in Verbindung mit MF=C oder MF=D ausgewertet und legt fest, mit welchen Zeichen die Feldnamen und Equates beginnen, die bei der Makroauflösung im Datenbereich generiert werden.
Voreinstellung: PREFIX = D
= pre
„pre“ ist ein 1-3 Zeichen langes Präfix, mit dem die vom Assembler generierten Feldnamen und Equates beginnen sollen.
PREFORM
Informiert über Dateien abhängig von deren (beabsichtigten) Dateiformaten auf SM-Pubsets.
= *ANY
Das Dateiformat ist kein Auswahlkriterium.
= *NONE
Informiert über alle Dateien, für die kein PREFORMAT-Wert definiert wurde.
= *K
Informiert über alle Dateien, die das beabsichtigte Dateiformat *K besitzen.
= *NK2
Informiert über alle Dateien, die das beabsichtigte Dateiformat *NK2 besitzen.
= *NK4
Informiert über alle Dateien, die das beabsichtigte Dateiformat *NK4 besitzen.
= (list-of-preform)
Informiert über alle Dateien, die einem der angegebenen Dateiformate entsprechen. Innerhalb der Liste können alle Werte außer ANY angegeben werden.
PROTACT
Informiert über die Dateien abhängig von der Schutzstufe der höchsten aktivierten Zugriffskontrolle.
Für Zugriffe auf die Datei gilt der höchste aktivierte Zugriffsschutz. Die nachfolgende Tabelle zeigt Art der Zugriffskontrolle, Schutzmerkmal, das im CATAL-Makroaufruf anzugeben ist, und die Rangfolge (Schutzstufe):
Zugriffsschutz | Schutzmerkmal | Schutzstufe |
Standard-Zugriffskontrolle | ACCESS u. SHARE | 0 |
Einfache Zugriffskontroll-Liste | BASACL, OWNERAR, GROUPAR, OTHERAR | 1 |
Zugriffskontrolle über GUARDS | GUARDS | 2 |
Alle weiteren Schutzmerkmale der Datei (z.B. Kennwörter) werden unabhängig von der realisierten Schutzstufe ausgewertet.
= ANY
Informiert über alle Dateien, unabhängig von der Schutzstufe der höchsten aktivierten Zugriffskontrolle.
= LEVEL-0
Informiert über alle Dateien, bei denen die Zugriffe über die Standard-Zugriffskontrolle erfolgen.
= LEVEL-1
Informiert über alle Dateien, bei denen die Zugriffe über eine einfache Zugriffskontroll-Liste (BASIC-ACL-Schutz) erfolgen.
= LEVEL-2
Informiert über alle Dateien, bei denen die Zugriffe über GUARDS erfolgen.
= (list-of-protact)
Der Anwender kann in einer Liste maximal 3 Schutzstufen angeben. Informiert über alle Dateien, bei denen die Zugriffe über eine Zugriffskontrolle erfolgen, die einer der angegebenen Schutzstufen entspricht.
RELSPAC
Informiert über alle Dateien, abhängig von einer vereinbarten Sperre gegen Freigabe von nicht belegtem Speicherplatz mit dem FILE-Makroaufruf bzw. dem Kommando MODIFY-FILE-ATTRIBUTES. Die Sperre kann mit dem CATAL-Makro im Katalog vereinbart werden.
= ANY
Die Sperre gegen Freigabe von nicht belegtem Speicherplatz ist kein Auswahlkriterium.
= ALLOWED
Es werden alle Dateien bearbeitet, bei denen nicht belegter Speicherplatz freigegeben werden darf.
= IGNORED
Es werden alle Dateien bearbeitet, bei denen nicht belegter Speicherplatz nicht freigegeben werden darf.
SHARE
Informiert über Dateien/Dateigenerationsgruppen in Abhängigkeit davon, ob sie mehrbenutzbar sind. Ist mit „$userid.“ eine fremde Benutzerkennung, die nicht Miteigentümer ist, angegeben, gilt immer implizit SHARE=YES. Der Anwender kann die zu bearbeitenden Dateien auswählen abhängig von ihrer Mehrbenutzbarkeit (siehe Operand SHARE im CATAL-Makro).
= ANY
Die Mehrbenutzbarkeit ist kein Auswahlkriterium.
= YES
Informiert über alle Dateien, die mehrbenutzbar sind, d.h. Dateien, die bei aktiver Standard-Zugriffskontrolle auch für fremde Benutzerkennungen zugreifbar sind.
= NO
Informiert über alle Dateien, die nicht mehrbenutzbar sind, d.h. Dateien, die bei aktiver Standard-Zugriffskontrolle nur für den Dateieigentümer zugreifbar sind.
= SPECIAL
Informiert über alle Dateien, die auch für die Kennung mit dem Privileg Hardware-Maintenance zugreifbar sind.
= (list-of-share)
In einer Liste können mehrere Operandenswerte angegeben werden.
SIZE
Informiert über Dateien/Dateigenerationen in Abhängigkeit von der Größe des reservierten Speicherplatzes. Als Werte sind ganze Zahlen von 0 bis 2147483647 erlaubt.
= ANY
Die Größe des reservierten Speicherplatzes ist kein Auswahlkriterium.
= FSIZE
Informiert über Dateien, bei denen die Zahl der reservierten PAM-Seiten gleich der der freien Seiten ist.
= zahl
Informiert über Dateien mit genau der angegebenen Anzahl reservierter PAM-Seiten.
= (zahl[,])
Informiert über Dateien mit min. der angegebenen Anzahl reservierter PAM-Seiten.
= (,zahl)
Informiert über Dateien mit max. der angegebenen Anzahl reservierter PAM-Seiten.
= (zahl1,zahl2)
Informiert über Dateien, deren Anzahl reservierter PAM-Seiten im angegebenen
Bereich liegt (zahl1 < zahl2).
SLEVEL
Informiert über Dateien, die sich auf den angegebenen Speicherhierarchie-Ebenen befinden (siehe Handbuch „HSMS“ [10]). HSMS unterstützt die folgenden Speicherhierarchie-Ebenen:
S0: | realisiert durch Plattenspeicher mit schnellem Zugriff (Online-Verarbeitung) |
S1: | realisiert durch Plattenspeicher mit hoher Kapazität (online verfügbare Hintergrundebene) |
S2: | realisiert durch Magnetband- oder Magnetbandkassettenarchive (offline verfügbare Hintergrundebene) |
= ANY
Die Speicherhierarchie-Ebene ist kein Auswahlkriterium.
= S0
Informiert nur über Dateien, die sich auf der Ebene S0 befinden.
= S1
Informiert nur über Dateien, die sich auf der Ebene S1 befinden.
= S2
Informiert nur über Dateien, die sich auf der Ebene S2 befinden.
= (list-of-slevel)
In einer Liste können mehrere Speicherhierarchie-Ebenen angegeben werden.
SORT
Der Operand SORT bestimmt die Sortierung der Katalogeinträge/Pfadnamen in der Ausgabe.
= FILENAM
Die Katalogeinträge/Pfadnamen werden alphabetisch sortiert ausgegeben.
= NO
Die Katalogeinträge/Pfadnamen werden in der Reihenfolge ausgegeben, wie sie im Katalog stehen.
STATE
Informiert über alle Dateien entsprechend ihrem momentanen Bearbeitungszustand.
= ANY
Der momentane Bearbeitungszustand ist kein Auswahlkriterium.
= NOCLOS
Informiert über alle Dateien, die momentan schreibend geöffnet sind. Das können sein:
normal eröffnete Dateien (Openmodus OUTIN, INOUT, OUTPUT)
in einer vorherigen Session nicht geschlossene Dateien
in der laufenden Session nicht geschlossene Dateien, weil der Prozess abgebrochen wurde.
Hinweis
STATE=NOCLOS setzt implizit GEN=YES, d.h. geöffnete Dateigenerationen werden immer mit ausgegeben.
= CLOSED
Informiert über alle Dateien, die bereits geschlossen wurden, d.h. Dateien, die nicht durch NOCLOS ausgewählt werden.
= CACHED
Informiert über alle Dateien, die momentan in einem Cache befinden.
= NOT-CACHED
Informiert über alle Dateien, die momentan nicht über einen Cache verarbeitet werden.
= CACHE-NOT-SAVED
Informiert über alle Dateien, für die es beim Schließen nicht möglich war, alle Schreibdaten vom Cache auf einen Plattenspeicher zu sichern.
= REPAIR-NEEDED
Informiert über alle Dateien, die in einer vorherigen Session nicht geschlossen wurden und auf die noch kein VERIFY durchgeführt wurde (siehe VERIFY-Makro, "VERIF - Datei wiederherstellen").
= DEFECT-REPORTED
Informiert über alle Dateien, die defekte Plattenblöcke enthalten können.
= NO-OPEN-ALLOWED
Informiert über alle Dateien, die wegen Dateninkonsistenz nicht geöffnet werden können.
= OPEN-ALLOWED
Informiert über alle Dateien, die geöffnet werden können.
= (list-of-state)
Der Anwender kann in einer Liste maximal 7 Dateizustände angeben. Informiert über alle Dateien, die sich in einem der angegebenen Zustände befinden.
STOCLAS
Informiert über alle Dateien entsprechend der Storage-Klasse zur Dateiablage auf SM-Pubsets.
= *ANY
Die Storage-Klasse ist kein Auswahlkriterium.
= *NONE
Nur Dateien, für die keine Storage-Klasse definiert ist, werden ausgewählt.
= <c-string 1..8>
Nur Dateien mit der angegebenen Storage-Klasse werden ausgewählt.
STOTYPE
Informiert über alle Dateien entsprechend des Speichertyps.
= *ANY
Der Speichertyp ist kein Auswahlkriterium.
= *PUBSPACE
Nur Dateien, die auf gemeinschaftlichen Datenträgern liegen, werden ausgewählt.
= *NETSTOR
Nur Dateien, die auf Net-Storage-Volumes liegen, werden ausgewählt.
STOUTAR
Ausgabebereich für statistische Informationen.
= (<list-of-elements-002>)
Der Ausgabebereich wird in Listenform angegeben, bestehend aus:
Adresse des Ausgabebereichs. Sie kann nur als Konstante oder als Equate angegeben werden und muss auf Wortgrenze ausgerichtet sein.
Länge des Ausgabebereiches (in Byte). Welcher Wert anzugeben ist, hängt vom Informationsumfang ab, der über den Operanden OUTPUT angefordert wird. Sie kann nur als Konstante oder als Equate angegeben werden.
Das Format des Ausgabebereiches ist auf "Hinweise zur Programmierung (VERSION=2, 3 und 4)" beschrieben.
Hinweis
Für die beiden Ausgabebereiche (OUTAREA, STOUTAR) werden intern SPECIFIED-Bits gesetzt. Wenn eine Ausgabe erfolgen soll, muss das jeweilige AREA-SPECIFIED-Bit gesetzt sein. Die Bits werden bei MF=L bzw. MF=M gesetzt. Aus diesem Grund ist es sinnvoll, beim MF=L-Aufruf den Operand OUTAREA bzw. STOUTAR mit Dummywerten zu versorgen.
SUPPORT
Informiert über Dateien/Dateigenerationen/Dateigenerationsgruppen, abhängig davon, auf welchem Datenträgertyp sie gespeichert sind.
= ANY
Der Datenträgertyp ist kein Auswahlkriterium.
= PUBLIC
Informiert über Dateien usw. auf gemeinschaftlichen Datenträgern oder Net-Storage-Volumes.
= PRDISC
Informiert über Dateien usw. auf Privatplatten.
= TAPE
Informiert über auf Band gespeicherte Dateien, Dateigenerationen oder Dateigenerationsgruppen.
= (list-of-support)
Der Anwender kann in einer Liste maximal 3 Datenträgertypen angeben. Informiert über alle Dateien, die auf einem der angegebenen Datenträgertypen abgespeichert sind.
S0MIGR
Informiert über Dateien abhängig davon, ob eine Umallokierung (Migration) auf S0-Ebene erlaubt ist.
= *ANY
Die Migrations-Erlaubnis ist kein Auswahlkriterium.
= *ALLOWED
Informiert über Dateien, für die eine Migration innerhalb der S0-Ebene erlaubt ist.
= *FORBIDDEN
Informiert über Dateien, für die eine Migration innerhalb der S0-Ebene nicht erlaubt ist.
= (list-of-s0migr)
Der Anwender kann die gewünschten Werte in einer Liste angeben. Informiert über alle Dateien, für die im Katalog einer der angegebenen Werte vereinbart wurde.
TIMBASE
Steuert, ob die absoluten Datumseingaben in UTC- oder lokaler Zeit erfolgen. An diesen Operanden ist auch das Datumsformat der FSTAT-Ausgabe gekoppelt.
= *UTC
Absolute Datumseingaben und alle Datumsausgaben erfolgen in UTC-Zeit.
= *LTI
Absolute Datumseingaben und alle Datumsausgaben erfolgen in lokaler Zeit.
TYPE
Informiert über alle Dateien entsprechend ihrem Typ.
= ANY
Informiert über alle Dateien unabhängig von ihrem Typ.
= FILE
Informiert über alle Dateien mit Ausnahme der Dateigenerationsgruppen.
= FGG
Informiert nur über Dateigenerationsgruppen und bei Angabe von GEN=YES auch über Dateigenerationen (siehe Operand „GEN").
= PLAM
Informiert nur über PLAM-Bibliotheken. Dies ist eine Untermenge der Dateien, die bei der Angabe TYPE=FILE ausgewählt werden.
= (list-of-type)
Informiert über alle Dateien, die den angegebenen Typen entsprechen. Der Anwender kann in einer Liste maximal 3 Typen angeben.
USRINFO
Informiert abhängig von der benutzereigenen Metainformation über Dateien/Dateigenerationen.
= *ANY
Die benutzereigene Metainformation ist kein Auswahlkriterium.
= *NONE
Informiert über Dateien, die keine benutzereigene Metainformation besitzen.
= <c-string 1..8>
Informiert über Dateien mit der angegebenen benutzereigenen Metainformation.
VERSION
Gibt an, welche Version der Parameterliste generiert werden soll.
Hinweis
Wird der FSTAT mit VERSION=0/1 in einer Umgebung aufgerufen, die „große Dateien“ unterstützt, besteht ein Prüfungs- und evtl. ein Umstellungsaufwand. Nähere Informationen dazu finden Sie ab "Hinweise zur Programmierung (VERSION=0 und 1)".
= 0
Es wird das Parameterlistenformat generiert, das vor BS2000 V8.0A unterstützt wurde. Dieses Format unterstützt allerdings auch nur die bis dahin bekannten Parameter. Z.B. darf der Pfadname nur ohne Musterzeichen angegeben werden und von den Selektionsparametern ist nur VOLUME und POS erlaubt. Die unterstützten Operanden/Operandenwerte können der Tabelle „Versionsunterschiede - VERSION=0/1/2/3/4/5" entnommen werden.
= 1
Es wird das Parameterlistenformat generiert, das in BS2000 V8.0 bis einschließlich V10.0 unterstützt wurde.
Dieses Format unterstützt allerdings auch nur die bis dahin bekannten Parameter. Die unterstützten Operanden/Operandenwerte können der Tabelle „Versionsunterschiede - VERSION=0/1/2/3/4/5" entnommen werden.
= 2
Es wird das Parameterlistenformat für Versionen ab BS2000/OSD-BC V1.0 generiert.
= 3
Es wird das Parameterlistenformat für Versionen ab BS2000/OSD-BC V3.0 generiert.
= 4
Es wird das Parameterlistenformat für Versionen ab BS2000/OSD-BC V9.0 generiert.
= 5
Es wird das Parameterlistenformat für Versionen ab BS2000 OSD/BC V11.0 generiert.
Hinweis
Wenn schon bestehende Software neu übersetzt werden soll, die Manipulationen an der generierten Parameterliste vornimmt, muss das alte Format angefordert werden. Ansonsten liegt Source-Kompatibilität vor.
VERSION-BACKUP
Der Anwender kann die zu bearbeitenden Dateien über ihre Teilnahme am Versions-Backup auswählen.
= *ANY
Die Teilnahme am Versions-Backup ist kein Auswahlkriterium.
= *ENABLED
Informiert über alle Dateien, die am Versions-Backup teilnehmen (NUM-OF-BACKUP-VERS > 0).
= *DISABLED
Informiert über alle Dateien, die nicht am Versions-Backup teilnehmen (NUM-OF-BACKUP-VERS = 0).
VOLSET
Der Anwender kann die zu bearbeitenden Dateien über den Volume-Set auswählen, auf dem sie liegen.
= *ANY
Der Volume-Set ist kein Auswahlkriterium.
= *CONTROL
Informiert über alle Dateien, die auf dem Control-Volume-Set des SM-Pubsets liegen.
= <c-string 1..4>
Informiert über alle Dateien, die auf dem spezifizierten Volume-Set liegen.
VOLUME
Der Anwender kann die zu bearbeitenden Dateien über die Archivnummer (VSN) ihres Datenträgers auswählen.
= ANY
Die Archivnummer (VSN) des Datenträgers ist kein Auswahlkriterium.
= vsn
Informiert über alle Dateien/Dateigenerationsgruppen, die für den Datenträger mit der angegebenen Archivnummer („vsn“) einen Eintrag in ihrer Datenträgerliste enthalten. Bezeichnet „vsn“ keine Privatplatte, so wird über Dateigenerationsgruppen nicht informiert.
VTOC
Der Anwender kann entscheiden, ob die angeforderten Informationen der VTOC (= Volume Table of Contents) einer Privatplatte bzw. eines Net-Storage-Volumes entnommen werden sollen oder dem System-Dateikatalog TSOSCAT. Der Operand VTOC kann nicht auf teilqualifizierte Dateinamen angewendet werden oder in Zusammenhang mit GEN=YES.
= NO
Gibt den aktuellen Eintrag im TSOSCAT aus.
= YES
Gibt die VTOC-Katalogeinträge (aus dem F1-Kennsatz einer privaten Platte bzw. dem Katalog eines Net-Storage-Volumes) aus, entsprechend dem letzten aktuellen Zustand im gesamten Rechnernetz. Der Datenträger muss zugewiesen sein. Der VTOC-Eintrag des Datenträgers ersetzt den entsprechenden TSOSCAT-Eintrag. So kann die Konsistenz zwischen VTOC- und TSOSCAT-Eintrag wiederhergestellt werden.
Wenn sich die angegebene Datei nicht mehr auf dem im TSOSCAT-Eintrag eingetragenen Datenträger befindet, wird der TSOSCAT-Eintrag gelöscht.
WORKFIL
Informiert über Dateien auf SM-Pubsets, abhängig davon, ob sie vom Systemverwalter gelöscht werden können (Arbeitsdateien).
= *ANY
Es ist kein Auswahlkriterium, ob die Dateien Arbeitsdateien sind oder nicht.
= *NO
Informiert über alle Dateien, die keine Arbeitsdateien sind.
= *YES
Informiert über alle Dateien, die Arbeitsdateien sind.
WTQUIET
Steuert, ob bei einem Shared Pubset bzw. Remote-Imported Pubset, der sich zum Zeitpunkt des FSTAT-Aufrufs bereits im Zustand QUIET befand, auf Beendigung des QUIET--Zustandes gewartet wird. Diese Wartezeit ist mit DIALOG-WAIT-TIME bzw. BATCH-WAIT-TIME im entsprechenden MRSCAT-Eintrag festgelegt.
Andernfalls wird entweder der Auftrag sofort mit dem Returncode DMS0502 abgebrochen oder, bei Wildcards-Angabe in der catid, der Pubset übersprungen.
= *YES
Ist ein Pubset im Zustand QUIET, so führt dies zu einem Wartezustand.
= *NO
Ist ein Pubset im Zustand QUIET, so führt dies zu dem Returncode DMS0502 oder, falls Wildcards in der catid angegeben sind, zum Überspringen des Pubsets.
XPAND
Durch diesen Operanden wird gesteuert, welcher Eingabeparameterbereich (mit oder ohne Selektionsparameterbereich) generiert werden soll. Darüber hinaus können mit XPAND die Datenbeschreibungen (DSECTs) für den Ausgabebereich generiert werden.
= PLSHORT
Der Eingabeparameterbereich wird ohne Selektionsparameterbereich generiert.
= PLLONG
Der Eingabeparameterbereich wird mit Selektionsparameterbereich generiert.
= OUTPUT
Es werden alle Datenbeschreibungen (DSECTs) zur Beschreibung der Ausgabe-Informationsblöcke generiert.
= (PLSHORT,OUTPUT)
Der Eingabeparameterbereich wird ohne Selektionsparameterbereich generiert. Alle Datenbeschreibungen (DSECTs) zur Beschreibung der Ausgabe-Informationsblöcke werden generiert.
= (PLLONG,OUTPUT)
Der Eingabeparameterbereich wird mit Selektionsparameterbereich generiert. Alle Datenbeschreibungen (DSECTs) zur Beschreibung der Ausgabe-Informationsblöcke werden generiert.
Returncodes
Der Fehlercode wird nur noch im Standardheader der Parameterliste und nicht mehr wie in Version 2 im Mehrzweckregister 15 zurückgeliefert.
Hinweis
Sind in der catid-Angabe Wildcards vorhanden, so werden folgende Returncodes unterdrückt.
X'02000000'
X'00400503'
X'00400616'
X'00820504'
X'00400501'
X'00400505'
X'00820502'
X'00820506'
Tritt kein anderer Fehler auf und wurde eine Datei selektiert, so ist der Returncode 0, wurde keine Datei selektiert, wird DMS06CC zurückgeliefert.
Standardheader: ccbbaaaa
Über die Ausführung des Makros FSTAT wird im Standardheader folgender Returncode übergeben (cc = SUBCODE2, bb = SUBCODE1, aaaa = MAINCODE):
X'cc' | X'bb' | X'aaaa' | Erläuterung |
X'00' | X'0000' | Kein Fehler | |
X'02' | X'00' | X'0000' | Ausgabe auf Grund defekter Volume-Sets nicht vollständig; |
X'40' | X'0501' | Angeforderter Katalog nicht verfügbar | |
X'82' | X'0502' | Angeforderter Katalog im Ruhezustand | |
X'40' | X'0503' | Falsche Information im MRSCAT | |
X'82' | X'0504' | Fehler im Katalog-Verwaltungs-System | |
X'40' | X'0505' | Fehler bei der Rechner-Kommunikation (MRS) | |
X'80' | X'0506' | Operation wegen Masterwechsel abgebrochen | |
X'40' | X'0510' | Fehler beim Aufruf einer internen Funktion | |
X'40' | X'0512' | Angeforderter Katalog unbekannt | |
X'40' | X'051B' | Benutzerkennung im angegebenen Pubset unbekannt | |
X'40' | X'051C' | Kein Zugriffsrecht auf angegebenen Pubset | |
X'40' | X'051D' | LOGON-Passwort auf angegebenem Pubset anders | |
X'40' | X'052E' | Datenträger nicht mehr verfügbar | |
X'20' | X'0530' | Fehler bei der Speicherplatzanforderung | |
X'20' | X'0531' | Unerwarteter Fehler beim Katalogzugriff | |
X'40' | X'0533' | Angegebene Datei nicht gefunden | |
X'82' | X'0534' | Privater Datenträger kann nicht zugewiesen werden | |
X'20' | X'053B' | Systemfehler beim Dateizugriff | |
X'40' | X'053D' | Katalog oder F1-Etikett-Block ist zerstört | |
X'20' | X'054F' | Unerwarteter Fehler beim Zugriff auf JOIN-Datei | |
X'82' | X'055A' | Geräte zurzeit belegt | |
X'40' | X'055F' | Datenträger konnte nicht belegt werden | |
X'01' | X'0576' | Widersprüchliche Operandenkombination oder reservierte Felder des Parameterbereiches verwendet oder Selektion enthält große Dateien | |
X'20' | X'0577' | Interner Fehler beim Zugriff auf die Auftragsumgebung | |
X'82' | X'0594' | Nicht genug virtueller Speicher verfügbar (auch bei einer Auswahlangabe (Wildcard), wenn zu viele Dateien selektiert wurden) | |
X'01' | X'0599' | Operand wird in der RFA-BS-Version nicht unterstützt | |
X'01' | X'05A8' | Angeforderter Gerätetyp im System nicht gefunden | |
X'01' | X'05AB' | Adresse des Ausgabebereiches falsch oder nicht angegeben | |
X'82' | X'05B0' | Zurzeit kein passendes Gerät verfügbar | |
X'40' | X'05B4' | Datenträger kann nicht bereitgestellt werden | |
X'01' | X'05B7' | Fehlerhafter Pfadname angegeben | |
X'20' | X'05C7' | Interner Fehler im DMS | |
X'40' | X'05D1' | Fehler bei der Geräteanforderung | |
X'01' | X'05EA' | VTOC=YES mit teilqualifizierten Dateinamen oder Dateigenerationsgruppen unzulässig | |
X'01' | X'05EE' | Dateiname zu lang | |
X'40' | X'05FC' | Angegebene Benutzerkennung nicht im Home-Pubset | |
X'40' | X'0616' | Ausgabe auf Grund defekter Volume-Sets nicht möglich; | |
X'01' | X'06B8' | Fehlerhafter Operand angegeben | |
X'01' | X'06C7' | Ungültige Generationsnummer angegeben | |
X'xx' | X'00' | X'06CB' | Ausgabebereich zu kurz |
X'40' | X'06CC' | nur bei Auswahlangabe (Wildcard): | |
X'01' | X'06FD' | Parameterbereich ungültig oder nicht zugreifbar | |
X'40' | X'06FF' | BCAM-Verbindung abgebrochen | |
X'01' | X'FFFF' | Falsche Funktionsnummer im Parameterbereichs-Header | |
X'03' | X'FFFF' | Falsche Versionsnummer im Parameterbereichs-Header |