Katalogeintrag von Dateien löschen (Dateien exportieren)
Komponente: | BS2000 |
Funktionsbereich: | Dateiverarbeitung |
Anwendungsbereich: | FILE |
Privilegierung: | STD-PROCESSING |
Berechtigungsschlüssel: | $ (bei NBCONOPI=N) bzw. E (bei NBCONOPI=Y) |
Funktionsbeschreibung
Das Kommando EXPORT-FILE löscht die Katalogeinträge von Dateien, die sich auf privatem Datenträger oder einem Net-Storage-Volume vom Typ NETSTOR befinden (Dateien exportieren). Speicherplatz und Daten der Dateien bleiben erhalten.
Standardmäßig exportiert das Kommando Dateien auf Privatplatte. Wenn Dateien auf einem Net-Storage-Volume vom Typ NETSTOR exportiert werden sollen, muss entweder das Volume oder der Speichertyp *NET-STORAGE explizit angegeben werden. Dateien auf einem Net-Storage-Volume vom Typ NETVOL können nicht exportiert werden, da sie keinen Dateikatalog (.bs2fscat) auf dem Net-Storage-Volume haben.
Mit dem Kommando IMPORT-FILE kann der Katalogeintrag wieder erstellt werden (Dateien importieren).
Privilegierte Funktionen
Die Systembetreuung kann Dateien jeder Benutzerkennung exportieren. Dabei kann sie nicht nur Kennwörter von geschützten Dateien ignorieren, sondern auch bei jedem Wechsel der Benutzerkennung in den geführten Dialog verzweigen.
Die Systembetreuung (Privileg TSOS) ist standardmäßig Mit-Eigentümer aller Dateien (kann somit also auch Dateien unter jeder Benutzerkennung exportieren). Diese Mit-Eigentümerschaft kann bei Einsatz von SECOS eingeschränkt werden.
In Verbindung mit dem Software-Produkt SECOS kann ein Benutzer anderen Benutzerkennungen die Mit-Eigentümerschaft an Dateien seiner Benutzerkennung einräumen. Eine Datei kann dann auch von einem ihrer Mit-Eigentümer exportiert werden.
Funktionsübersicht
Funktion / Bedeutung | Operand 1. Stufe | Operand 2./3. Stufe |
|---|---|---|
Kennzeichen des Datenträgers, der exportiert werden soll |
| |
Name der Datei oder Dateigeneration, die exportiert werden soll | ||
| =*NAME | |
| =*GENERATIONS-BEFORE | |
| =*GENERATIONS-AFTER | |
Auswahlkriterien für die zu löschenden Dateien | ||
Datumsangabe |
| |
| ||
| ||
| ||
| ||
| ||
Speicherplatz | ||
| ||
| ||
| ||
| ||
| ||
| ||
Datensicherheit/Datenschutz | ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
Kontrollparameter | DIALOG-CONTROL | |
| ||
| ||
| ||
| ||
| ||
| ||
Meldung für erfolgreich exportierte Dateien | ||
| =*NO | |
| =*SYSOUT | |
Kennwortschutz (allgemein) ignorieren | ||
Kennwortschutz, der durch die angegebenen Kennwörter definiert wurde, ignorieren | ||
Fehlersituation unterdrücken |
Tabelle 48: Funktionsübersicht Kommando EXPORT-FILE
Format
EXPORT-FILE | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
VOLUME = *ANY / <alphanum-name 1..6>
Datenträgerkennzeichen des Datenträgers, auf dem sich die zu exportierende Datei befindet.
Aus der Menge der im Operanden FILE ausgewählten Dateien werden nur diejenigen exportiert, die sich auf dem angegebenen Datenträger befinden.
Der Operand darf nicht für Dateigenerationsgruppen auf Band verwendet werden.
Beim Exportieren eines Datenträgers, der Generationen einer Dateigenerationsgruppe enthält, können Lücken in dieser Dateigenerationsgruppe entstehen, wenn im Operanden VOLUME eine private Platte vereinbart wird, die zwar die Dateigeneration, nicht aber den Gruppeneintrag enthält. Diese Lücke betrifft nur den Katalogeintrag; auf den Platten ist die Dateigenerationsgruppe vollständig vorhanden.
VOLUME = *ANY
Sämtliche unter dem Operanden FILE angegebenen Dateien auf privatem Datenträger oder Net-Storage-Volumes vom Typ NETSTOR werden exportiert.
FILE = *NAME(...) / *GENERATIONS-BEFORE(...) / *GENERATIONS-AFTER
Vereinbart die zu exportierenden Dateien oder Dateigenerationsgruppen. Dabei bezeichnet *DUMMY eine Pseudodatei oder die Pseudodateigenerationen, die als „stets vorhanden“ gelten und alle Auswahlkriterien erfüllen. Alle übrigen Operanden (außer DIALOG-CONTROL, OUTPUT und SUPPRESS-ERRORS) werden nur auf formale Richtigkeit überprüft. *DUMMY dient vor allem dem Test von Prozeduren.
FILE = *NAME(...)
Beschränkt auf die in VOLUME vereinbarten Datenträger werden folgende Dateien ausgewählt:
FILE-NAME = *ALL / <filename 1..54 with-wild(80)> / *DUMMY
Name der Datei, die zu exportieren ist.
Nur die eigene Benutzerkennung oder eine Benutzerkennung, für die der Benutzer Mit-Eigentümer ist, darf angegeben werden.
FILE = *GENERATIONS-BEFORE(...)
Beschränkt auf die in VOLUME vereinbarten Datenträger, werden alle Dateigenerationen exportiert, die älter als folgende Dateigeneration sind:
GENERATION-NAME = <filename 1..54 with-wild(80)> / *DUMMY
Name einer Bezugsgeneration. Exportiert werden alle Dateigenerationen, deren Nummer kleiner ist als die der Bezugsgeneration.
FILE = *GENERATIONS-AFTER(...)
Beschränkt auf die in VOLUME vereinbarten Datenträger, werden alle Dateigenerationen exportiert, die jünger als folgende Dateigeneration sind:
GENERATION-NAME = <filename 1..54 with-wild(80)> / *DUMMY
Name einer Bezugsgeneration. Exportiert werden alle Dateigenerationen, deren Nummer größer ist als die der Bezugsgeneration.
SELECT = *ALL
Die beim Operanden FILE-NAME definierte Dateimenge wird nicht eingeschränkt.
SELECT = *BY-ATTRIBUTES(...)
Schränkt die beim Operanden FILE-NAME definierte Dateimenge auf Dateien ein, die den nachfolgenden Angaben genügen.
Der Default-Wert *ANY bzw. ANY bedeutet jeweils, dass keine Einschränkungen der Dateimenge bezüglich des entsprechenden Merkmals gewünscht sind.
CREATION-DATE = *ANY / *NONE / *TODAY / *YESTERDAY /
<integer -99999..991231> / <date> / *INTERVAL(...)
Der Anwender kann über das Erstellungsdatum die Dateien auswählen, die exportiert werden sollen.
Siehe auch Kommando SHOW-FILE-ATTRIBUTES, Ausgabefelder CRE-DATE und CRE-TIME.
CREATION-DATE = *ANY
Das Erstellungsdatum dient nicht als Auswahlkriterium.
CREATION-DATE = *NONE
Es werden nur die Dateien exportiert, in deren Katalogeintrag für CREATION-DATE der Wert NONE eingetragen ist, d.h. Dateien, die noch nicht eröffnet wurden.
CREATION-DATE = *TODAY
Es werden nur die Dateien exportiert, in deren Katalogeintrag für CREATION-DATE das aktuelle Tagesdatum eingetragen ist.
CREATION-DATE = *YESTERDAY
Es werden nur die Dateien exportiert, in deren Katalogeintrag für CREATION-DATE das Datum des Vortags eingetragen ist.
CREATION-DATE = <integer -99999..991231>
Es werden nur die Dateien exportiert, in deren Katalogeintrag für CREATION-DATE das angegebene Datum eingetragen ist. Der Anwender kann hier das Erstellungsdatum auf zwei Arten angeben:
als absolute Datumsangabe
(6-stellig) ein konkretes Datum in der Form yymmdd
(yy = Jahr, mm = Monat, dd = Tag)als relative Datumsangabe
(6-stellig einschl. Vorzeichen) Distanz zum aktuellen Tagesdatum in der Form-n für die Vergangenheit und +n für die Zukunft;
(YESTERDAY entspricht -1, TODAY entspricht ±0)
CREATION-DATE = <date>
Es werden nur die Dateien exportiert, in deren Katalogeintrag für CREATION-DATE das angegebene Datum eingetragen ist. Der Anwender kann das Erstellungsdatum in der Form [yy]yy-mm-dd angeben.
CREATION-DATE = *INTERVAL(...)
Es werden nur die Dateien exportiert, die innerhalb des angegebenen Zeitraums erstellt wurden.
Bereichsangaben gelten jeweils einschließlich der Bereichsgrenzen (siehe auch Erläuterungen zur Datumsangabe über <integer>-Angabe).
Es ist auch möglich, nur den Operanden FROM (Untergrenze) oder den Operanden TO (Obergrenze) anzugeben. Für den jeweils nicht angegebenen Operanden wird der Default-Wert als Bereichsgrenze eingesetzt. Ein sinnvolles Exportieren mit Bereichsgrenzen ist nur möglich, wenn die Untergrenze <= der Obergrenze gewählt wird.
FROM = *EARLIEST / *TODAY / *YESTERDAY / <integer -99999..991231> / <date>
Es werden nur die Dateien exportiert, die seit dem angegebenen Datum erstellt wurden (CREATION-DATE >= angegebenes Datum). Bei EARLIEST wird vom System das frühest mögliche Datum eingestellt.
FROM = *TODAY
Es werden nur Dateien exportiert, die zum aktuellen Tagesdatum erstellt wurden.
FROM = *YESTERDAY
Es werden nur Dateien exportiert, die seit dem Datum des Vortags erstellt wurden (CREATION-DATE >= Datum des Vortags).
FROM = <integer -99999..991231>
Es werden nur Dateien exportiert, die seit dem angegebenen Datum erstellt wurden (CREATION-DATE >= angegebenes Datum).
FROM = <date>
Es werden nur Dateien exportiert, die seit dem angegebenen Datum erstellt wurden (CREATION-DATE >= angegebenes Datum).
TO = *TODAY / *YESTERDAY / <integer -99999..991231> / <date>
Es werden nur die Dateien exportiert, die bis zum angegebenen Datum erstellt wurden (CREATION-DATE <= angegebenes Datum).
TO = *TODAY
Es werden nur die Dateien exportiert, die bis zum aktuellen Tagesdatum erstellt wurden (CREATION-DATE <= aktuelles Tagesdatum).
TO = *YESTERDAY
Es werden nur die Dateien exportiert, die bis zum Datum des Vortags erstellt wurden (CREATION-DATE <= Datum des Vortags).
TO = <integer -99999..991231>
Es werden nur die Dateien exportiert, die bis zum angegebenen Datum erstellt wurden (CREATION-DATE <= angegebenes Datum).
TO = <date>
Es werden nur die Dateien exportiert, die bis zum angegebenen Datum erstellt wurden (CREATION-DATE <= angegebenes Datum).
EXPIRATION-DATE = *ANY / *NONE / *TOMORROW / *TODAY / *YESTERDAY /
<integer -99999..991231> / <date> / *INTERVAL(...)
Der Anwender kann über das Freigabedatum (Expiration Date) die Dateien auswählen, die exportiert werden sollen. Siehe auch Kommando SHOW-FILE-ATTRIBUTES, Ausgabefelder EXPIR-DATE und EXPIR-TIME.
EXPIRATION-DATE = *ANY
Das Freigabedatum dient nicht als Auswahlkriterium.
EXPIRATION-DATE = *NONE
Es werden nur Dateien exportiert, in deren Katalogeintrag für EXPIRATION-DATE kein Freigabedatum (NONE) eingetragen ist.
EXPIRATION-DATE = *TOMORROW
Es werden nur Dateien exportiert, deren Katalogeintrag für EXPIRATION-DATE das Datum des folgenden Tages enthält.
EXPIRATION-DATE = *TODAY
Es werden nur Dateien exportiert, deren Katalogeintrag für EXPIRATION-DATE das aktuelle Tagesdatum enthält.
EXPIRATION-DATE = *YESTERDAY
Es werden nur Dateien exportiert, deren Katalogeintrag für EXPIRATION-DATE das Datum des Vortags enthält.
EXPIRATION-DATE = <integer -99999..991231>
Es werden nur Dateien exportiert, deren Katalogeintrag für EXPIRATION-DATE das angegebene Datum enthält. Der Anwender kann hier das Freigabedatum auf zwei Arten angeben:
als absolute Datumsangabe
(6-stellig) ein konkretes Datum in der Form yymmdd
(yy = Jahr, mm = Monat, dd = Tag)als relative Datumsangabe
(6-stellig einschl. Vorzeichen) Distanz zum aktuellen Tagesdatum in der Form-n für die Vergangenheit und +n für die Zukunft;
(YESTERDAY entspricht -1, TODAY entspricht ±0 oder TOMORROW entspricht +1)
EXPIRATION-DATE = <date>
Es werden nur Dateien exportiert, deren Katalogeintrag für EXPIRATION-DATE das angegebene Datum enthält. Der Anwender kann das Freigabedatum in der Form [yy]yy-mm-dd angeben.
EXPIRATION-DATE = *INTERVAL(...)
Es werden nur die Dateien exportiert, deren Freigabe im nachfolgend angegebenen Zeitraum liegt, d.h. Dateien, deren Schutzfrist in dem angegebenen Zeitraum erloschen ist.
Bereichsangaben gelten jeweils einschließlich der Bereichsgrenzen (siehe auch Erläuterungen zur Datumsangabe bei EXPIRATION-DATE = <integer...>).
Es ist auch möglich, nur den Operanden FROM (Untergrenze) oder den Operanden TO (Obergrenze) anzugeben. Für den jeweils nicht angegebenen Operanden wird der Default-Wert als Bereichsgrenze eingesetzt. Ein sinnvolles Exportieren mit Bereichsgrenzen ist nur möglich, wenn die Untergrenze <= der Obergrenze gewählt wird.
FROM = *EARLIEST / *TOMORROW / *TODAY / *YESTERDAY /
<integer -99999..991231> / <date>
Bei EARLIEST wird vom System das frühest mögliche Datum eingestellt.
Es werden nur die Dateien exportiert, deren Schutzfrist nach dem angegebenen Datum erlischt (EXPIRATION-DATE >= angegebenes Datum).
FROM = *TOMORROW
Es werden nur Dateien exportiert, deren Schutzfrist frühestens am folgenden Tag erlischt.
FROM = *TODAY
Es werden nur Dateien exportiert, deren Schutzfrist frühestens zum aktuellen Tagesdatum erlischt.
FROM = *YESTERDAY
Es werden nur Dateien exportiert, deren Schutzfrist frühestens zum Datum des Vortags erlischt.
FROM = <integer -99999..991231>
Es werden nur Dateien exportiert, deren Schutzfrist frühestens zum angegebenes Datum erlischt.
FROM = <date>
Es werden nur Dateien exportiert, deren Schutzfrist frühestens zum angegebenes Datum erlischt.
TO = *LATEST / *TOMORROW / *TODAY / *YESTERDAY / <integer -99999..991231> / <date>
Es werden nur die Dateien exportiert, deren Schutzfrist spätestens an dem angegebenen Datum erloschen ist (EXPIRATION-DATE <= angegebenes Datum)
TO = *TOMORROW
Es werden nur Dateien exportiert, deren Schutzfrist spätestens zum Datum des
TO = *TOMORROW
Es werden nur Dateien exportiert, deren Schutzfrist spätestens zum Datum des folgenden Tages erloschen ist.
TO = *TODAY
Es werden nur Dateien exportiert, deren Schutzfrist spätestens zum aktuellen Tagesdatum erloschen ist.
TO = *YESTERDAY
Es werden nur Dateien exportiert, deren Schutzfrist spätestens zum Datum des Vortages erloschen ist.
TO = <integer -99999..991231>
Es werden nur Dateien exportiert, deren Schutzfrist spätestens zum angegebenen Datum erloschen ist.
TO = <date>
Es werden nur Dateien exportiert, deren Schutzfrist spätestens zum angegebenen Datum erloschen ist.
LAST-ACCESS-DATE = *ANY / *NONE / *TODAY / *YESTERDAY / <integer -99999..991231> /
<date> / *INTERVAL(...)
Der Anwender kann über das Datum des letzten Zugriffs die Dateien auswählen, die exportiert werden sollen.
Siehe auch Kommando SHOW-FILE-ATTRIBUTES, Ausgabefelder ACC-DATE und ACC-TIME.
LAST-ACCESS-DATE = *ANY
Das Datum des letzten Zugriffes dient nicht als Auswahlkriterium.
LAST-ACCESS-DATE = *NONE
Es werden nur die Dateien exportiert, in deren Katalogeintrag das Feld LADATE den Wert NONE enthält, d.h. Dateien, die noch nicht eröffnet wurden.
LAST-ACCESS-DATE = *TODAY
Es werden nur Dateien exportiert, deren Katalogeintrag für LAST-ACCESS-DATE das aktuelle Tagesdatum enthält.
LAST-ACCESS-DATE = *YESTERDAY
Es werden nur Dateien exportiert, deren Katalogeintrag für LAST-ACCESS-DATE das Datum des Vortages enthält.
LAST-ACCESS-DATE = <integer -99999..991231>
Es werden nur Dateien exportiert, deren Katalogeintrag für LAST-ACCESS-DATE das angegebene Datum enthält. Der Anwender kann hier das Datum des letzten Zugriffs auf zwei Arten angeben:
als absolute Datumsangabe
(6-stellig) ein konkretes Datum in der Form yymmdd
(yy = Jahr, mm = Monat, dd = Tag)als relative Datumsangabe
(6-stellig einschl. Vorzeichen) Distanz zum aktuellen Tagesdatum in der Form-n für die Vergangenheit und +n für die Zukunft;
(YESTERDAY entspricht -1, TODAY entspricht ±0)
LAST-ACCESS-DATE = <date>
Es werden nur Dateien exportiert, deren Katalogeintrag für LAST-ACCESS-DATE das angegebene Datum enthält. Der Anwender kann das Erstellungsdatum in der Form [yy]yy-mm-dd angeben.
LAST-ACCESS-DATE = *INTERVAL(...)
Es werden nur die Dateien exportiert, auf die während des angegebenen Zeitraums letztmals zugegriffen wurde.
Bereichsangaben gelten jeweils einschließlich der Bereichsgrenzen (siehe auch Erläuterungen zur Datumsangabe über <integer>-Angabe).
Es ist auch möglich, nur den Operanden FROM (Untergrenze) oder den Operanden TO (Obergrenze) anzugeben. Für den jeweils nicht angegebenen Operanden wird der voreingestellte Wert als Bereichsgrenze eingesetzt. Ein sinnvolles Exportieren mit Bereichsgrenzen ist nur möglich, wenn die Untergrenze <= der Obergrenze gewählt wird.
FROM = *EARLIEST / *TODAY / *YESTERDAY / <integer -99999..991231> / <date>
Es werden nur die Dateien exportiert, auf die seit dem angegebenen Datum noch zugegriffen wurde (LAST-ACCESS-DATE >= angegebenes Datum).
Bei EARLIEST wird vom System das frühest mögliche Datum eingestellt.
FROM = *TODAY
Es werden nur Dateien exportiert, auf die zum aktuellen Tagesdatum noch zugegriffen wurde.
FROM = *YESTERDAY
Es werden nur Dateien exportiert, auf die seit dem Datum des Vortags noch zugegriffen wurde. Informiert über Dateien, deren LAST-ACCESS-DATE >= angegebenes Datum ist.
FROM = <integer -99999..991231>
Es werden nur Dateien exportiert, deren LAST-ACCESS-DATE >= angegebenes Datum ist.
FROM = <date>
Es werden nur Dateien exportiert, deren LAST-ACCESS-DATE >= angegebenes Datum ist.
TO = *TODAY / *YESTERDAY / <integer -99999..991231> / <date>
Es werden nur die Dateien exportiert, auf die bis zu dem angegebenen Datum zuletzt zugegriffen wurde (LAST-ACCESS-DATE <= angegebenes Datum)
TO = *TODAY
Es werden nur Dateien exportiert, auf die bis zum aktuellen Tagesdatum noch zugegriffen wurde.
TO = *YESTERDAY
Es werden nur Dateien exportiert, auf die bis zum Datum des Vortags noch zugegriffen wurde.
TO = <integer -99999..991231>
Es werden nur Dateien exportiert, auf die bis zum angegebenen Datum zuletzt zugegriffen wurde.
TO = <date>
Es werden nur Dateien exportiert, auf die bis zum angegebenen Datum zuletzt zugegriffen wurde.
SUPPORT = *ANY / list-poss(2): *PRIVATE-DISK / *TAPE
Der Anwender kann über den Datenträgertyp festlegen, welche Dateien mit EXPORT-FILE exportiert werden sollen.
SUPPORT = *ANY
Der Datenträgertyp dient nicht als Auswahlkriterium.
SUPPORT = *PRIVATE-DISK
Nur Dateien auf Privatplatten werden exportiert.
SUPPORT = *TAPE
Nur Dateien auf Magnetband oder Magnetbandkassette werden exportiert.
STORAGE-TYPE = *ANY / *NET-STORAGE(...)
Der Anwender kann über den Speichertyp des Ablageorts der Datei festlegen, welche Dateien mit EXPORT-FILE exportiert werden sollen.
STORAGE-TYPE = *ANY
Der Speichertyp dient nicht als Auswahlkriterium.
STORAGE-TYPE = *NET-STORAGE(...)
Nur Dateien auf einem Net-Storage-Volume vom Typ NETSTOR werden exportiert. Dateien auf einem Net-Storage-Volume vom Typ NETVOL können nicht exportiert werden, da sie keinen Dateikatalog (.bs2fscat) auf dem Net-Storage-Volume haben.
FILE-TYPE = *ANY / *BS2000 / *NODE-FILE
Der Anwender kann über den Dateityp festlegen, welche Dateien mit EXPORT-FILE exportiert werden sollen.
FILE-TYPE = *ANY
Der Dateityp dient nicht Auswahlkriterium.
FILE-TYPE = *BS2000
Nur BS2000-Dateien auf Net-Storage-Volumes vom Typ NETSTOR werden exportiert.
FILE-TYPE = *NODE-FILE
Nur Node-Files auf Net-Storage-Volumes vom Typ NETSTOR werden exportiert.
SIZE = *ANY / *FREESIZE / <integer 0..2147483647> / *INTERVAL(...)
nur für Dateien auf Platten und Net-Storage-Volumes:
Der Anwender kann über die Dateigröße bzw. Größe des reservierten Speicherplatzes (= Anzahl der PAM-Seiten) bestimmen, welche Dateien von EXPORT-FILE exportiert werden sollen.
Der Operand SIZE gibt eine Anzahl PAM-Seiten an; Bereichsangaben gelten jeweils einschließlich der Bereichsgrenzen;
SIZE = *ANY
Die Dateigröße dient nicht als Auswahlkriterium.
SIZE = *FREESIZE
Es werden nur Dateien exportiert, für die zwar Speicherplatz reserviert ist, die jedoch noch keinen Speicherplatz belegen (HIGH-US-PA=0).
SIZE = <integer 0..2147483647>
Es werden nur Dateien exportiert, für die genau die angegebene Anzahl von PAM-Seiten reserviert ist.
SIZE = *INTERVAL(...)
Es werden nur die Dateien exportiert, deren Seitenanzahl im angegebenen Bereich liegt.
Bereichsangaben gelten jeweils einschließlich der Bereichsgrenzen (siehe auch Erläuterungen zu SIZE=<integer>).
Es ist auch möglich, nur den Operanden FROM (Untergrenze) oder den Operanden TO (Obergrenze) anzugeben. Für den jeweils nicht angegebenen Operanden wird der voreingestellte Wert als Bereichsgrenze eingesetzt.
Ein sinnvolles Exportieren mit Bereichsgrenzen ist nur möglich, wenn die Untergrenze <= der Obergrenze gewählt wird. Es werden nur Dateien bearbeitet, für die mindestens so viele PAM-Seiten reserviert wurden wie bei FROM angegeben und höchstens so viele wie bei TO angegeben (FROM <= SIZE <= TO)
FROM = 0 / <integer 0..2147483647>
Es werden nur die Dateien exportiert, für die mindestens so viele PAM-Seiten reserviert wurden, wie angegeben (SIZE >= angegebener Wert).
TO = 2147483647 / <integer 0..2147483647>
Es werden nur die Dateien exportiert, für die höchstens so viele PAM-Seiten reserviert wurden, wie angegeben (SIZE <= angegebener Wert).
NUMBER-OF-EXTENTS = *ANY / <integer 0..65535> / *INTERVAL(...)
nur für Plattendateien: Der Anwender kann die Zahl der Extents, in die eine Datei „zerfällt“, als Auswahlkriterium für die EXPORT-FILE-Verarbeitung nutzen. Ein Extent ist ein zusammenhängender Bereich, den eine Datei auf einer Platte belegt; wie viele Extents eine Datei hat, zeigt das Ausgabefeld EXTENTS.
NUMBER-OF-EXTENTS = *ANY
Die Anzahl Extents dient nicht als Auswahlkriterium.
NUMBER-OF-EXTENTS = <integer 0..65535>
Es werden nur Plattendateien mit genau der angegebenen Zahl von Extents (EXTENTS =zahl) exportiert.
NUMBER-OF-EXTENTS = *INTERVAL(...)
Ausgewählt werden alle Dateien, deren Extent-Anzahl im angegebenen Bereich liegt.Bereichsangaben gelten jeweils einschließlich der Bereichsgrenzen. Es ist auch möglich, nur den Operanden FROM (Untergrenze) oder den Operanden TO (Obergrenze) anzugeben. Für den jeweils nicht angegebenen Operanden wird der voreingestellte Wert als Bereichsgrenze eingesetzt.
Ein sinnvolles Exportieren mit Bereichsgrenzen ist nur möglich, wenn die Untergrenze <= der Obergrenze gewählt wird. Es werden nur die Plattendateien bearbeitet, die mindestens so viele EXTENTS haben, wie bei FROM angegeben und höchstens so viele wie, bei TO angegeben (FROM <= EXTENTS <= TO)
FROM = 0 / <integer 0..65535>
Es werden nur die Plattendateien bearbeitet, die mindestens so viele Extents haben wie angegeben (EXTENTS >= zahl).
TO = 65535 / <integer 0..65535>
Es werden nur Plattendateien bearbeitet, die höchstens so viele Extents haben wie angegeben (EXTENTS <= zahl).
NUMBER-OF-FREE-PAGES = *ANY / *SIZE / <integer 0..2147483647> / *INTERVAL(...)
nur für Dateien auf Platten und Net-Storage-Volumes: Der Anwender kann anhand der freien PAM-Seiten, d.h. des für die Datei reservierten, aber nicht belegten Speicherplatzes die Dateien auswählen, die bearbeitet werden sollen.
NUMBER-OF-FREE-PAGES = *ANY
Die Anzahl der freien PAM-Seiten dient nicht als Auswahlkriterium.
NUMBER-OF-FREE-PAGES = *SIZE
Es werden nur die Dateien exportiert, die keinen Speicherplatz belegen (d.h. es ist keine PAM-Seite beschrieben).
NUMBER-OF-FREE-PAGES = <integer 0..2147483647>
Es werden nur die Dateien exportiert, die genau so viele reservierte, aber nicht belegte (=freie) PAM-Seiten haben wie, mit <integer> angegeben.
NUMBER-OF-FREE-PAGES = *INTERVAL(...)
Ausgewählt werden alle Dateien, deren Anzahl nicht belegter PAM-Seiten im angegebenen Bereich liegt. Bereichsangaben gelten jeweils einschließlich der Bereichsgrenzen (siehe auch Erläuterungen zu NUMBER-OF-FREE-PAGES = <integer ...>).
Es ist auch möglich, nur den Operanden FROM (Untergrenze) oder den Operanden TO (Obergrenze) anzugeben. Für den jeweils nicht angegebenen Operanden wird der voreingestellte Wert als Bereichsgrenze eingesetzt.
Ein sinnvolles Exportieren mit Bereichsgrenzen ist nur möglich, wenn die Untergrenze <= der Obergrenze gewählt wird.
Es werden nur die Dateien exportiert, die mindestens so viele freie PAM-Seiten haben, wie bei FROM angegeben und höchstens so viele, wie bei TO angegeben
(FROM <= FREE <= TO).
FROM = 0 / <integer 0..2147483647>
Es werden nur die Dateien exportiert, die mindestens so viele freie PAM-Seiten haben wie angegeben (FREE >= zahl).
TO = 2147483647 / <integer 0..2147483647>
Es werden nur die Dateien exportiert, die höchstens so viele freie PAM-Seiten haben wie angegeben (FREE <= zahl).
ACCESS = *ANY / *READ / *WRITE
Als Auswahlkriterium dient die angegebene Zugriffsart (Ausgabefeld ACCESS).
ACCESS = *ANY
Der ACCESS-Wert wird als Auswahlkriterium nicht berücksichtigt.
ACCESS = *READ
Es werden nur die Dateien exportiert, für die Schreibzugriff mit ACCESS=*READ unterbunden ist, d.h. für die nur Lesezugriff zulässig ist.
ACCESS = *WRITE
Es werden nur die Dateien exportiert, für die Schreibzugriff erlaubt ist.
PASSWORD = *ANY / list-poss(4): *NONE / *READ-PASSWORD / *WRITE-PASSWORD /
*EXEC-PASSWORD
Der Anwender kann über den Kennworttyp die Dateien auswählen, die mit EXPORT-FILE bearbeitet werden sollen.
PASSWORD = *ANY
Der Kennwortschutz dient nicht als Auswahlkriterium.
PASSWORD = *NONE
Es werden nur Dateien exportiert, für die kein Kennwortschutz besteht.
PASSWORD = *READ-PASSWORD
Es werden nur Dateien exportiert, die durch ein Lesekennwort geschützt sind.
PASSWORD = *WRITE-PASSWORD
Es werden nur Dateien exportiert, die durch ein Schreibkennwort geschützt sind.
PASSWORD = *EXEC-PASSWORD
Es werden nur Dateien exportiert, die durch ein Ausführungskennwort geschützt sind.
USER-ACCESS = *ANY / listposs(3): *OWNER-ONLY / *ALL-USERS / *SPECIAL
Der Anwender kann die Zugriffsberechtigung einer Datei als Auswahlkriterium nutzen.
USER-ACCESS = *ANY
Die Zugriffsberechtigung dient nicht als Auswahlkriterium.
USER-ACCESS = *OWNER-ONLY
Es werden nur Dateien exportiert, die nur dem Eigentümer zugänglich sind.
USER-ACCESS = *ALL-USERS
Es werden nur Dateien exportiert, auf die mehrere Benutzer Zugriff haben.
USER-ACCESS = *SPECIAL
Es werden nur Dateien exportiert, auf die alle Benutzerkennungen einschließlich der Wartungskennungen (Benutzerkennungen mit dem Privileg HARDWARE-MAINTENANCE) Zugriff haben.
FILE-STRUCTURE = *ANY / list-poss(5): *PAM / *SAM / *ISAM / *BTAM / *NONE
Der Anwender kann über die Zugriffsmethode (Ausgabefeld FILE-STRUC) die Dateien auswählen, die exportiert werden sollen.
FILE-STRUCTURE = *ANY
Zugriffsmethode dient nicht als Auswahlkriterium.
FILE-STRUCTURE = *PAM
Es werden nur PAM-Dateien bearbeitet.
FILE-STRUCTURE = *SAM
Es werden nur SAM-Dateien exportiert.
FILE-STRUCTURE = *ISAM
Es werden nur ISAM-Dateien exportiert.
FILE-STRUCTURE = *BTAM
Es werden nur BTAM-Dateien exportiert. BTAM-Dateien sind Banddateien.
FILE-STRUCTURE = *NONE
Es werden nur die Dateien exportiert, für die FILE-STRUC=NONE gilt, d.h. Dateien, die noch nicht eröffnet wurden.
BACKUP-CLASS = *ANY / list-poss(5): *A / *B / *C / *D / *E
Der Anwender kann über den BACKUP-CLASS-Level die Dateien auswählen, die exportiert werden sollen.
BACKUP-CLASS = *ANY
Der BACKUP-CLASS-Level dient nicht als Auswahlkriterium.
BACKUP-CLASS = *A
Es werden nur Dateien exportiert, für die im Katalog BACKUP-CLASS mit dem Wert *A eingetragen ist (häufigste Sicherung).
BACKUP-CLASS = *B
Es werden nur Dateien exportiert, für die im Katalog BACKUP-CLASS mit dem Wert *B eingetragen ist.
BACKUP-CLASS = *C
Es werden nur Dateien exportiert, für die im Katalog BACKUP-CLASS mit dem Wert *C eingetragen ist.
BACKUP-CLASS = *D
Es werden nur Dateien exportiert, für die im Katalog BACKUP-CLASS mit dem Wert *D eingetragen ist.
BACKUP-CLASS = *E
Es werden nur Dateien exportiert, für die im Katalog BACKUP-CLASS mit dem Wert *E eingetragen ist.
BLOCK-CONTROL-INFO = ANY / list-poss(4): NONE / NO / WITHIN-DATA-BLOCK /
WITHIN-DATA-2K-BLOCK / WITHIN-DATA-4K-BLOCK / PAMKEY / NK / NK2 / NK4
Der Anwender kann über das Dateiformat (Ausgabefeld BLK-CONTR) die Dateien auswählen, die exportiert werden sollen.
BLOCK-CONTROL-INFO = *ANY
Der BLOCK-CONTROL-Eintrag dient nicht als Auswahlkriterium.
BLOCK-CONTROL-INFO = *NONE
Es werden nur die Dateien exportiert, für die noch keine Blockkontrollinformationen definiert sind, d.h. die noch nicht eröffnet wurden.
BLOCK-CONTROL-INFO = *NO
Es werden nur die Dateien exportiert, die kein Blockkontrollfeld enthalten.
BLOCK-CONTROL-INFO = *WITHIN-DATA-BLOCK
Es werden nur die Dateien exportiert, die mit BLOCK-CONTROL-INFO=*WITHIN-DATA-BLOCK erzeugt wurden, d.h. deren Blockkontrollinformationen in einem Blockkontrollfeld am Anfang und innerhalb des Datenblocks stehen.
BLOCK-CONTROL-INFO = *WITHIN-DATA-2K-BLOCK
Es werden nur die Dateien exportiert, die mit BLOCK-CONTROL-INFO=*WITHIN-DATA-2K-BLOCK erstellt wurden, d.h. deren Blockkontrollinformationen zu Beginn jedes 2KByte-Blockes stehen.
BLOCK-CONTROL-INFO = *WITHIN-DATA-4K-BLOCK
Es werden nur die Dateien exportiert, die mit BLOCK-CONTROL-INFO=*WITHIN-DATA-4K-BLOCK erstellt wurden, d.h. deren Blockkontrollinformationen zu Beginn jedes 4KByte-Blockes stehen.
BLOCK-CONTROL-INFO = *PAMKEY
Es werden nur die Dateien exportiert, die für das Blockkontrollfeld einen separaten PAM-Schlüssel nutzen (Blockkontroll-Information steht in einem separaten Schlüsselfeld außerhalb des PAM-Blockes).
BLOCK-CONTROL-INFO = *NK
Es werden nur NK-Dateien exportiert, d.h. Dateien die auch auf NK-Datenträgern (NK2 oder NK4) gespeichert werden können.
BLOCK-CONTROL-INFO = *NK2
Es werden nur die Dateien exportiert, die auch auf NK2-Datenträgern, aber nicht auf NK4-Datenträgern gespeichert werden können.
BLOCK-CONTROL-INFO = *NK4
Es werden nur die Dateien exportiert, die auch auf NK4-Datenträgern gespeichert werden können.
MIGRATE = *ANY / list-poss(2): *ALLOWED / *INHIBITED / *FORBIDDEN
Der Anwender kann über die im Katalogeintrag gewählte Migration (s. Kommando CREATE-FILE, Operand MIGRATE) die Dateien angeben, die von EXPORT-FILE exportiert werden sollen.
MIGRATE = *ANY
Es werden die angegebenen Dateien exportiert, unabhängig vom Wert des jeweiligen MIGRATE-Operanden im Katalogeintrag.
MIGRATE = *ALLOWED
Es werden nur Dateien exportiert, für die im Katalogeintrag der entsprechende Operandenwert vereinbart wurde, d.h. Dateien, die auf die Speicherebenen S1 und S2 verdrängt werden dürfen.
MIGRATE = *INHIBITED
Es werden nur Dateien exportiert, für die im Katalogeintrag der entsprechende Operandenwert vereinbart wurde, d.h. Dateien, die nicht verdrängt werden dürfen.
MIGRATE = *FORBIDDEN
Es werden nur Dateien exportiert, für die im Katalogeintrag der entsprechende Operandenwert vereinbart wurde, d.h. Dateien, für die eine verschärfte Migrations-Sperre vereinbart ist. Die Dateien dürfen auch nicht kurzzeitig verdrängt werden (z.B. bei einer Reorganisation).
STATUS = *ANY / *PARAMETERS(...)
Auswahlkriterium ist der momentane Dateizustand.
STATUS = *ANY
Der Dateizustand dient nicht als Auswahlkriterium.
STATUS = *PARAMETERS(...)
Es werden nur Dateien exportiert, die sich in dem angegebenen Zustand befinden. Dabei sind nachfolgende Auswahlkriterien möglich:
CLOSED-OUTPUT = *ANY / *YES / *NO
Gibt an, ob der Zustand „Datei geschlossen“ Auswahlkriterium sein soll.
CLOSED-OUTPUT = *YES
Es werden nur Dateien exportiert, die bereits geschlossen wurden.
CLOSED-OUTPUT = *NO
Es werden nur Ausgabedateien exportiert, die in einem Programm (OPEN OUTIN, INOUT oder OUTPUT) eröffnet wurden, und Dateien, die in einem vorhergehenden Systemlauf oder wegen Auftragsabbruchs nicht geschlossen wurden.
REPAIR-NEEDED = *ANY / *YES
Gibt an, ob Dateien ausgewählt werden sollen, die in einem vorangegangen Systemlauf nicht geschlossen wurden und die noch nicht mit REPAIR-DISK-FILES rekonstruiert wurden.
REPAIR-NEEDED = *ANY
Exportiert Dateien unabhängig von der Notwendigkeit, sie zu rekonstruieren.
REPAIR-NEEDED = *YES
Es werden nur Dateien exportiert, die in einem vorangegangenen Systemlauf nicht geschlossen und noch nicht rekonstruiert wurden.
BASIC-ACL = *ANY / *NONE / *YES / *PARAMETERS(...)
Auswahlkriterium ist der BASIC-ACL-Eintrag im Dateikatalog.
BASIC-ACL = *ANY
Der BASIC-ACL-Eintrag ist kein Auswahlkriterium.
BASIC-ACL = *NONE
Es werden nur Dateien exportiert, die keinen BASIC-ACL-Eintrag im Katalog besitzen.
BASIC-ACL = *YES
Es werden nur Dateien exportiert, die einen BASIC-ACL-Eintrag im Katalog besitzen.
BASIC-ACL = *PARAMETERS(...)
Es werden nur Dateien exportiert, die den angegebenen BASIC-ACL-Eintrag besitzen. NO-ACCESS bedeutet, dass keine Zugriffsrechte vergeben wurden.
OWNER = *ANY / *NO-ACCESS / *PARAMETERS(...)
Gibt an, welche Zugriffsrechte für den Eigentümer gesetzt sein sollen.
OWNER = *PARAMETERS(...)
Zugriffsrechte, die für den Eigentümer bestehen sollen (logische Oder-Verknüpfung):
READ = *ANY / *NO / *YES
Gibt an, ob Lesezugriff bestehen soll.
WRITE = *ANY / *NO / *YES
Gibt an, ob Schreibzugriff bestehen soll.
EXEC = *ANY / *NO / *YES
Gibt an, ob Ausführungsrecht bestehen soll.
GROUP = *ANY / *NO-ACCESS / *PARAMETERS(...)
Gibt an, welche Zugriffrechte für die Benutzergruppe des Eigentümers gesetzt sein sollen.
GROUP = *PARAMETERS(...)
Zugriffsrechte, die für die Benutzergruppe des Eigentümers bestehen sollen (logische Oder-Verknüpfung):
READ = *ANY / *NO / *YES
Gibt an, ob Lesezugriff bestehen soll.
WRITE = *ANY / *NO / *YES
Gibt an, ob Schreibzugriff bestehen soll.
EXEC = *ANY / *NO / *YES
Gibt an, ob Ausführungsrecht bestehen soll.
OTHERS = *ANY / *NO-ACCESS / *PARAMETERS(...)
Gibt an, welche Zugriffsrechte für alle anderen Benutzer gesetzt sein sollen.
OTHERS = *PARAMETERS(...)
Zugriffsrechte, die für alle anderen Benutzer bestehen sollen (logische Oder-Verknüpfung):
READ = *ANY / *NO / *YES
Gibt an, ob Lesezugriff bestehen soll.
WRITE = *ANY / *NO / *YES
Gibt an, ob Schreibzugriff bestehen soll.
EXEC = *ANY / *NO / *YES
Gibt an, ob Ausführungsrecht bestehen soll.
PROTECTION-ACTIVE = *ANY / list-poss(3): *LEVEL-0 / *LEVEL-1
Auswahlkriterium ist die Schutzstufe der höchsten aktivierten Zugriffskontrolle. Exportiert werden nur Dateien mit einem Zugriffschutz kleiner oder gleich der angegebenen Schutzstufe.
Die Schutzstufe 2 kann bei EXPORT-FILE nicht explizit angegeben werden.
Für Zugriffe auf die Datei gilt der höchste aktivierte Zugriffsschutz. Die nachfolgende Tabelle zeigt Art der Zugriffskontrolle, Schutzmerkmal und Rangfolge (Schutzstufe):
Zugriffsschutz | Schutzmerkmal | Schutzstufe |
|---|---|---|
Standard-Zugriffskontrolle | ACCESS u. USER-ACCESS | 0 |
Einfache Zugriffskontroll-Liste | BASIC-ACL | 1 |
Zugriffskontrolle über GUARDS | GUARDS | 2 |
Tabelle 49: Rangfolge der Zugriffskontrollmöglichkeiten
Alle weiteren Schutzmerkmale der Datei (z.B. Kennwörter) werden unabhängig von der realisierten Schutzstufe ausgewertet.
PROTECTION-ACTIVE = *ANY
Die Art Zugriffskontrolle ist kein Auswahlkriterium.
PROTECTION-ACTIVE = *LEVEL-0
Es werden nur Dateien exportiert, bei denen die Zugriffe über die Standard-Zugriffskontrolle erfolgen.
PROTECTION-ACTIVE = *LEVEL-1
Es werden nur Dateien exportiert, bei denen die Zugriffe über eine einfache Zugriffskontroll-Liste (BASIC-ACL-Schutz) erfolgen.
ACCESS-COUNTER = *ANY / <integer 0..2147483647> / *INTERVAL(...)
Auswahlkriterium ist der Zugriffzähler der Datei (siehe auch Kommando SHOW-FILE-ATTRIBUTES, Ausgabefeld ACC-COUNT).
ACCESS-COUNTER = *ANY
Der Zugriffszähler ist kein Auswahlkriterium.
ACCESS-COUNTER = <integer 0..2147483647>
Es werden nur Dateien exportiert, deren Zugriffszähler genau den angegebenen Wert besitzt.
ACCESS-COUNTER = *INTERVAL(...)
Es werden nur Dateien exportiert, deren Zugriffszähler in dem nachfolgend angegebenen Intervall liegt.
FROM = 0 / <integer 0..2147483647>
Es werden nur Dateien exportiert, deren Zugriffszähler >= dem angegebenen Wert ist.
TO = 2147483647 / <integer 0..2147483647>
Es werden nur Dateien exportiert, deren Zugriffszähler <= dem angegebenen Wert ist.
HIGHEST-USED-PAGE = *ANY / <integer 0..2147483647> / *INTERVAL(...)
Auswahlkriterium ist die Anzahl der belegten PAM-Seiten, d.h. der Last Page Pointer zeigt auf die angegebene Seite (siehe auch Kommando SHOW-FILE-ATTRIBUTES, Ausgabefeld HIGH-US-PA).
HIGHEST-USED-PAGE = *ANY
Die Anzahl der belegten PAM-Seiten dient nicht als Auswahlkriterium.
HIGHEST-USED-PAGE = <integer 0..2147483647>
Es werden nur Dateien exportiert, bei denen die angegebene Anzahl von PAM-Seiten beschrieben ist (Last Page Pointer zeigt auf die angegebene Seite).
HIGHEST-USED-PAGE = *INTERVAL(...)
Es werden nur Dateien exportiert, deren Anzahl beschriebener Seiten im angegebenen Bereich liegt.
FROM = 0 / <integer 0..2147483647>
Es werden nur Dateien exportiert, deren Anzahl beschriebener Seiten >= angegebener Anzahl ist.
TO = 2147483647 / <integer 0..2147483647>
Es werden nur Dateien exportiert, deren Anzahl beschriebener Seiten ≤ der angegebenen Anzahl ist.
TYPE-OF-FILES = *ANY / list-poss(2): *FILE / *PLAM-LIBRARY
Gibt an, ob Informationen abhängig vom Dateityp auszuwählen sind. Die Auswahl der zu löschenden Dateien kann entweder auf Dateien oder auf PLAM-Bibliotheken beschränkt werden.
TYPE-OF-FILES = *ANY
Exportiert Dateien unabhängig vom Dateityp.
TYPE-OF-FILES = *FILE
Es werden nur Dateien exportiert.
TYPE-OF-FILES = *PLAM-LIBRARY
Es werden nur PLAM-Bibliotheken exportiert.
DIALOG-CONTROL = *STD / *NO / *ERROR / *FILE-CHANGE / *MORE-THAN-ONE-FILE /
*CATALOG-CHANGE/ *USER-ID-CHANGE
Gibt an, ob und unter welcher Bedingung während des Exportierens ein Kontrolldialog mit dem Benutzer geführt werden soll.
Ein Kontrolldialog ist nur im Dialogbetrieb, dort aber auch in Prozeduren, möglich. Im Batchbetrieb kann nur der Operandenwert *STD oder *NO angegeben werden.
Der Benutzer hat im Kontrolldialog folgende Eingriffsmöglichkeiten:
- Y: Die angegebene Datei bzw. Dateimenge wird exportiert.
- N: Die angegebene Datei bzw. Dateimenge wird nicht exportiert.
- T: Die Bearbeitung des Kommandos wird abgebrochen.
- ?: Aufzählung und Erklärung der Antwortmöglichkeiten.
Zusätzlich können folgende Optionen getrennt durch Komma angegeben werden:
- ,CHECK = NO
Der DIALOG-CONTROL-Modus wird auf „*NO“ geändert. - ,CHECK = PVS
Der DIALOG-CONTROL-Modus wird auf „*CATALOG-CHANGE“ geändert. - ,CHECK = MULTIPLE
Der DIALOG-CONTROL-Modus wird auf „*MORE-THAN-ONE-FILE“ geändert. - ,CHECK = SINGLE
Der DIALOG-CONTROL-Modus wird auf „*FILE-CHANGE“ geändert. - ,CHECK = ERROR
Der DIALOG-CONTROL=Modus wird auf „*ERROR“ geändert. - ,IGNORE = list-poss(3): RDPASS / WRPASS / EXPASS
Die Angabe ist nur für den privilegierten Benutzer möglich.
Gibt an, welche Art von Kennwortschutz beim Exportieren ignoriert werden soll. Die Angabe wirkt nur beim Kontrolldialog für eine einzelne Datei. - ,PASSWORD = list-poss(3): <c-string 1..4> /
<x-string 1..8> / <integer -2147483648..2147483647>
Ermöglicht das Exportieren kennwortgeschützter Dateien (maximal 3 Kennwörter). Die Angabe wirkt nur beim Kontrolldialog für eine einzelne Datei.
DIALOG-CONTROL = *STD
Die Voreinstellung *STD entspricht im interaktiven Dialog (SYSCMD ist der Datensichtstation zugeordnet) dem Wert *MORE-THAN-ONE-FILE, in Prozeduren und im Batchbetrieb dem Wert NO.
DIALOG-CONTROL = *NO
Der Anwender kann in den Ablauf der EXPORT-FILE-Verarbeitung nicht eingreifen; alle angegebenen Dateien werden exportiert (kein Kontrolldialog).
DIALOG-CONTROL = *ERROR
Erfolgt das Exportieren der ausgewählten Dateien ohne Fehler, werden wie bei NO alle Dateien sofort exportiert (d.h. kein Kontrolldialog).
Tritt beim Exportieren jedoch ein behebbarer Fehler auf, so wird ein Dialog geführt wie bei DIALOG-CONTROL = *FILE-CHANGE.
DIALOG-CONTROL = *ERROR gilt implizit, wenn DIALOG-CONTROL = *FILE-CHANGE eingestellt ist. Im Fehlerfall kann der Anwender die Fehlermeldung quittieren, die EXPORT-FILE-Bearbeitung abbrechen oder versuchen, den Fehler zu beheben.
Außerdem kann er den DIALOG-CONTROL-Modus wechseln (siehe die unter dem ersten DIALOG-CONTROL-Operanden beschriebenen Eingriffsmöglichkeiten).
DIALOG-CONTROL = *FILE-CHANGE
Bei jeder zu exportierenden Datei hat der Benutzer die unter dem ersten DIALOG-CONTROL-Operanden beschriebenen Eingriffsmöglichkeiten.
Der Anwender kann für jede Datei, die bearbeitet wird, im Kontrolldialog entscheiden, ob sie exportiert werden soll oder nicht (Antwort: YES/NO). Gibt er im Dialog mit „IGNORE“ Schutzattribute an oder mit „PASSWORD“ ein oder mehrere Kennwörter, werden diese Angaben für die betreffende Datei ausgewertet und die Datei ohne weitere Rückfrage exportiert („YES“ muss ebenfalls angegeben werden!). Der Anwender kann auch die EXPORT-FILE-Verarbeitung abbrechen oder den DIALOG-CONTROL-Modus wechseln. Die betroffenen Dateien werden alphanumerisch sortiert aufgelistet.
DIALOG-CONTROL = *MORE-THAN-ONE-FILE
Wurde genau eine Datei spezifiziert, so wird diese sofort exportiert. Ist FILE-NAME teilqualifiziert angegeben, sodass mehr als eine Datei angesprochen wird, oder enthält die unter dem Operanden FILE-NAME angegebene Datei Muster, kann der Anwender bei Wechsel der Katalogkennung entscheiden, ob Dateien aus dem jeweiligen Katalog exportiert werden sollen (siehe die unter dem ersten DIALOG-CONTROL-Operanden beschriebenen Eingriffsmöglichkeiten). Er muss die ausgegebene „Frage“ mit „YES“ oder „NO“ beantworten. DIALOG-CONTROL = *MORE-THAN-ONE-FILE ist sinnvoll, wenn für „catid“ im FILE-NAME Muster angegeben wurden. Im Kontrolldialog kann die EXPORT-FILE-Bearbeitung abgebrochen oder der DIALOG-CONTROL-Modus geändert werden.
DIALOG-CONTROL = *CATALOG-CHANGE
Ähnlich wie bei DIALOG-CONTROL = *MORE-THAN-ONE-FILE verzweigt die EXPORT-FILE-Verarbeitung in einen Kontrolldialog, wenn Dateien aus verschiedenen Katalogen (Pubsets) betroffen sind. Der Benutzer bestimmt, ob die Dateien auf dem aktuellen Pubset exportiert werden sollen (YES/NO), ob er die EXPORT-FILE-Verarbeitung abbrechen oder den DIALOG-CONTROL-Modus wechseln will.
DIALOG-CONTROL = *USER-ID-CHANGE
Bei jedem Wechsel der Benutzerkennung beim Exportieren der Dateien wird in den geführten Dialog verzweigt.
OUTPUT = *STD / *NO / *SYSOUT
Der Anwender kann bestimmen, ob für jede erfolgreich exportierte Datei eine Meldung (DMS0800) mit dem Namen der exportierten Datei nach SYSOUT ausgegeben werden soll. Die Voreinstellung *STD entspricht OUTPUT=*NO.
OUTPUT = *NO
Für erfolgreich exportierte Dateien werden keine Meldungen nach SYSOUT ausgegeben.
OUTPUT = *SYSOUT
Für jede erfolgreich exportierte Datei wird zusätzlich eine Meldung mit ihrem Namen nach SYSOUT ausgegeben.
IGNORE-PROTECTION = *NONE / list-poss(3): *WRITE-PASSWORD /
*READ-PASSWORD / *EXEC-PASSWORD
Operandenwerte ungleich *NONE sind dem privilegierten Anwender vorbehalten.
Die Systembetreuung kann bestimmen, ob der Kennwortschutz ignoriert werden soll.
Die Angabe IGNORE-PROTECTION im Kommando EXPORT-FILE ersetzt so das Kommando MODIFY-FILE-ATTRIBUTES, mit dem vor dem Exportieren die Schutzattribute zurückgesetzt werden müssten.
IGNORE-PROTECTION = *WRITE-PASSWORD
Die Systembetreuung ist berechtigt, das Schutzattribut Schreibkennwort beim Exportieren der Datei zu ignorieren.
IGNORE-PROTECTION = *READ-PASSWORD
Die Systembetreuung ist berechtigt, das Schutzattribut Lesekennwort beim Exportieren der Datei zu ignorieren.
IGNORE-PROTECTION = *EXEC-PASSWORD
Die Systembetreuung ist berechtigt, das Schutzattribut Ausführungskennwort beim Exportieren der Datei zu ignorieren.
PASSWORDS-TO-IGNORE = *NONE / *SECRET / list-poss(3): <x-string 1..8> /
<c-string 1..4> / <integer -2147483648..2147483647>
Der Anwender kann ein oder mehrere Kennwörter angeben, sodass die durch diese Kennwörter geschützten Dateien exportiert werden können. Die Kennwörter werden nicht in die Kennworttabelle des Auftrags eingetragen und gelten nur für die aktuelle EXPORT-FILE-Verarbeitung. In Listenform können maximal 3 Kennwörter angegeben werden.
Zum Exportieren einer kennwortgeschützten Datei muss das höchstwertige Kennwort angegeben werden (siehe Kommando ADD-PASSWORD).
Der Operand PASSWORD-TO-IGNORE hat folgende Besonderheiten:
- Der eingegebene Wert wird nicht protokolliert.
- Im geführten Dialog ist das Eingabefeld automatisch dunkelgesteuert.
- Bei Angabe von *SECRET oder ^ stellt SDF im ungeführten Dialog und in Vordergrundprozeduren ein dunkelgesteuertes Eingabefeld zur verdeckten Eingabe des Kennwortes zur Verfügung.
PASSWORDS-TO-IGNORE = *NONE
Es werden keine Kennwörter angegeben.
SUPPRESS-ERRORS = *NONE / list-poss(3): <alphanum-name 7..7>
In Prozeduren kann der Anwender festlegen, ob jeder Fehlerfall (mit Ausnahme von Syntaxfehler) den Spin-Off-Mechanismus bzw. die SDF-P-Fehlerbehandlung auslösen soll oder ob bestimmte Fehlerbedingungen ignoriert werden können.
SUPPRESS-ERRORS = *NONE
Alle Fehler lösen den Spin-Off-Mechanismus bzw. die SDF-P-Fehlerbehandlung aus.
SUPPRESS-ERRORS = list-poss(3): <alphanum-name 7..7>
Der Anwender kann über den DMS-Fehlerschlüssel <alphanum-name 7..7> definieren, welche Fehler unterdrückt werden sollen. Bei Auftreten des angegebenen Fehlers wird der Spin-Off-Mechanismus nicht ausgelöst. Maximal 3 Fehlerschlüssel können angegeben werden.
DMS-Fehlerschlüssel: 7 Zeichen, die ersten drei Zeichen sind immer „DMS“; die letzten 4 Zeichen kennzeichnen den Fehler; es sind die Zeichen 0...9 und A...F erlaubt. Bei der Eingabe wird nicht geprüft, ob ein gültiger Fehlerschlüssel angegeben wurde.
Gültige DMS-Fehlerschlüssel finden Sie über eine HTML-Anwendung auf dem Manual-Server (URL: http://bs2manuals.ts.fujitsu.com ) und auf der DVD „BS2000 SoftBooks“.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
|---|---|---|---|
0 | CMD0001 | Kommando ausgeführt | |
1 | 0 | CMD0001 | Keine Aktion nötig |
2 | 0 | DMS05F7 | Datei-Generation existiert nicht, aber Gruppen-Eintrag wird geändert |
2 | 0 | DMS06D6 | Fehler beim Löschen einiger Dateien |
1 | CMD0202 | Syntax- oder Semantikfehler im Kommando | |
32 | DMS0584 | Während der Verarbeitung wurde ein Zustand gemeldet, der die Fortführung der Funktion nicht zulässt. | |
64 | CMD0102 | Unterbrechung mit K2-Taste | |
64 | CMD0216 | Privilegien-Fehler | |
64 | DMS0501 | Angeforderter Katalog nicht verfügbar | |
64 | DMS0512 | Angeforderter Katalog nicht gefunden | |
64 | DMS051B | Gewünschte Benutzerkennung nicht im Pubset | |
64 | DMS051C | Benutzer hat auf Pubset kein Zugriffsrecht | |
64 | DMS0535 | Angegebene Datei nicht mehrfach benutzbar | |
64 | DMS055C | Der Katalogeintrag konnte auf dem zugewiesenen Datenträger nicht gefunden werden | |
64 | DMS057B | Ungültiger Operand für migrierte Datei | |
64 | DMS057C | Bearbeitung wegen HSMS-Fehler nicht möglich | |
64 | DMS057D | RECALL einer migrierten Datei ohne Verzögerung nicht möglich | |
64 | DMS057E | Datei migriert, HSMS nicht verfügbar | |
64 | DMS0585 | Während der Katalogverarbeitung bzw. während der Mehrrechnerverarbeitung wurde ein Fehler festgestellt. | |
64 | DMS0586 | Der Zugriff bzw. die Belegung eines Datenträgers ist derzeit nicht möglich | |
64 | DMS0587 | Die Benutzung des angegebenen Kommandos wurde von der Systembetreuung eingeschränkt | |
64 | DMS05C9 | Nur Dateien auf privaten Datenträgern oder auf Net-Storage-Volume vom Typ NETSTOR können exportiert werden | |
64 | DMS05FC | Angegebene Benutzer-Kennung nicht im HOME-Pubset | |
64 | DMS0609 | Zugriff auf Systemdatei nicht erlaubt | |
64 | DMS06FF | BCAM-Verbindung unterbrochen | |
130 | DMS0524 | Systemadressraum erschöpft | |
130 | DMS0582 | Die Datei ist derzeit gesperrt oder in Gebrauch und kann nicht bearbeitet werden | |
130 | DMS0585 | Während der Katalogverarbeitung bzw. während der Mehrrechnerverarbeitung wurde ein Fehler festgestellt. | |
130 | DMS0586 | Der Zugriff bzw. die Belegung eines Datenträgers ist derzeit nicht möglich | |
130 | DMS0594 | Nicht genügend virtueller Speicherplatz vorhanden |
Beispiele
Beispiele zur Anwendung des Kommandos EXPORT-FILE sind in den Beispielen zu dem Kommando IMPORT-FILE enthalten.
Hinweise
Soll eine Datei, die auf einer privaten Platte oder einem Net-Storage-Volume steht, exportiert werden, so wird für den Auftrag das Gerät angefordert, auf dem diese Platte bereitsteht. Nach dem Exportieren wird das Gerät an das System zurückgegeben.
Für Dateien auf privaten Platten müssen zum Zeitpunkt der Kommandoausführung alle Datenträger der Datei bereitstehen, falls OPTION= *DESTROY-ALL oder MOUNT= *ALL-DISK gegeben wurde. Sonst muss der erste Datenträger der Datei bereitstehen. Die folgenden Datenträger werden erst während der Kommandoausführung angefordert.
Diese Regel gilt auch, wenn durch einen teilqualifizierten Dateinamen mehrere Dateien im EXPORT-FILE-Kommando angesprochen werden. In diesem Fall brauchen nicht die Datenträger sämtlicher Dateien gleichzeitig bereitgestellt werden. Vom System werden dann nur so viele Geräte angefordert, wie für diejenige Datei erforderlich sind, welche die meisten Datenträger belegt.