Dateigenerationen einer Dateigenerationsgruppe löschen
Komponente: | BS2000 |
Funktionsbereich: | Dateiverarbeitung |
Anwendungsbereich: | FILE-GENERATION-GROUP |
Privilegierung: | STD-PROCESSING |
Berechtigungsschlüssel: | $ (bei NBCONOPI=N) bzw. E (bei NBCONOPI=Y) |
Funktionsbeschreibung
Mit dem Kommando DELETE-FILE-GENERATION kann der Anwender in Abhängigkeit von Auswahlkriterien, die im Kommando anzugeben sind, Dateigenerationen löschen, die unter der eigenen Benutzerkennung katalogisiert sind. Durch bestimmte Löschoperationen kann der Anwender Speicherplatz freigeben. Der Anwender wird dabei durch geführten Dialog unterstützt. Die Operanden des Kommandos DELETE-FILE-GENERATION lassen sich in vier Gruppen einteilen, die den verschiedenen Funktionsebenen entsprechen (siehe „Funktionsübersicht" in Abschnitt "DELETE-FILE-GENERATION").
Selektion
Mit Selektionsparametern definiert der Anwender, welche Dateigenerationen/Katalogeinträge bearbeitet werden. Als Auswahlkriterien dienen im Gruppeneintrag hinterlegte Eigenschaften. Zu diesem Zweck entsprechen einige Operanden des Kommandos DELETE-FILE-GENERATION den Operanden des Kommandos SHOW-FILE-ATTRIBUTES.
Dateischutz
Dateischutzparameter ersparen dem Anwender die Eingabe der Kommandos MODIFY-FILE-GROUP-ATTRIBUTES bzw. ADD-PASSWORD, wenn Dateien gelöscht werden sollen, für die Dateischutzmerkmale wie Kennwörter, Schutzfrist o.Ä. definiert wurden.
Kommandoausführung
Aktionsparameter steuern den internen Ablauf der Bearbeitung von DELETE-FILE-GENERATION. Der Anwender kann zum einen den Umfang des Löschens bestimmen, zum anderen aber auch Bedingungen für das Löschen definieren.
Kontrollparameter
Kontrollparameter erlauben es dem Anwender, sich die Benutzerschnittstelle in gewissem Rahmen selbst zu definieren. So kann er z.B. im Dialog eine Dialogführung nutzen, er kann ein SYSOUT-Protokoll anfordern oder DMS-Fehler ignorieren lassen (bzgl. Spin-Off-Mechanismus bzw. SDF-P-Fehlerbehandlung).
Privilegierte Funktionen
Die privilegierten Funktionen für die Systembetreuung umfassen neben der Angabe jeder Benutzerkennung auch die Möglichkeit, Schutzattribute der zu löschenden Dateigenerationen zu ignorieren, sowie im Falle eines Wechsels der Benutzerkennung in einen geführten Dialog zu verzweigen.
Die Systembetreuung (Privileg TSOS) ist standardmäßig Mit-Eigentümer aller Dateien (kann somit also auch Dateigenerationen unter jeder Benutzerkennung löschen). 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 Dateigenerationsgruppen seiner Benutzerkennung einräumen. Eine Dateigeneration kann dann auch von einem Mit-Eigentümer der Dateigenerationsgruppe gelöscht werden.
Funktionsübersicht
Funktion / Bedeutung | Operand 1.Stufe | Operand 2./3. Stufe |
|---|---|---|
Name der Dateigeneration, die gelöscht werden soll. |
| |
relative Angabe der Dateigeneration, die gelöscht werden soll |
| |
Auswahlkriterien für die zu löschenden Dateigenerationen | ||
Datumsangabe | ||
| ||
| ||
Speicherplatz | ||
| ||
| =*ANY | |
Datensicherheit/Datenschutz | ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
Löschparameter | OPTION | |
| ||
| ||
| ||
| ||
| ||
Montieraufforderung | ||
Kontrollparameter | DIALOG-CONTROL | |
| ||
| ||
| ||
| ||
| ||
| ||
Meldung für erfolgreich gelöschte Dateien | ||
| =*NO | |
| =*SYSOUT | |
Schutzmerkmale ignorieren | ||
| ||
| ||
| ||
Kennwortschutz, der durch die angegebenen Kennwörter definiert wurde, wird ignoriert | ||
Fehlersituation unterdrücken |
Format
DELETE-FILE-GENERATION | Kurzname: DLFGN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
GENERATION-NAME = *DUMMY / <filename 1..54 without-vers with-wild(80)>
Name einer Bezugsgeneration, ab der oder bis zu der gelöscht werden soll (siehe Operand DELETE).
Nur die eigene Benutzerkennung oder eine Benutzerkennung, für die der Benutzer Mit-Eigentümer ist, darf angegeben werden.
GENERATION-NAME = *DUMMY
Bezeichnet die Pseudodateigeneration, die als „stets vorhanden“ gilt und alle Auswahlkriterien erfüllt. 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.
DELETE = *GENERATIONS-BEFORE / GENERATIONS-AFTER
Gibt an, welche Dateigenerationen zu löschen sind: alle, deren Nummer kleiner oder alle, deren Generationsnummer größer ist als die der Bezugsgeneration.
SELECT = *ALL
Die in GENERATION-NAME definierte Dateimenge wird nicht eingeschränkt.
SELECT = *BY-ATTRIBUTES(...)
Schränkt die in FILE-NAME definierte Dateimenge auf Generationen ein, die den nachfolgenden Angaben genügen.
Der Default-Wert *ANY bzw. ANY bedeutet jeweils, dass keine Einschränkungen der Dateigenerationsmenge bezüglich des entsprechenden Merkmals gewünscht sind.
EXPIRATION-DATE = *ANY / *NONE / *TOMORROW(...) / *TODAY(...) / *YESTERDAY(...) /
<integer -99999..991231>(...) / <date>(...) / *INTERVAL(...)
Der Anwender kann über das Freigabedatum (Expiration Date) die Dateigenerationen auswählen, die gelöscht werden sollen. Eine Schutzfrist besteht, wenn das Freigabedatum größer als das aktuelle Tagesdatum ist.
Für ein angegebendes Datum kann die Auswahl auf ein Zeitintervall, in dem die letzte Dateiänderung erfolgte, eingeschränkt werden (siehe Operand TIME der jeweiligen Struktur). Hierbei ist zu beachten, dass derzeit als Freigabezeitpunkt immer die Uhrzeit 00:00:00 im Dateikatalog eingetragen ist.
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 Dateigenerationen gelöscht, in deren Gruppeneintrag für EXPIRATION-DATE kein Freigabedatum (NONE) eingetragen ist, d.h. Dateigenerationen, die noch nicht eröffnet wurden.
EXPIRATION-DATE = *TOMORROW(...)
Es werden nur Dateigenerationen gelöscht, deren Gruppeneintrag für EXPIRATION-DATE das Datum des Folgetages enthält.
TIME = *ANY / *INTERVAL(...)
Beschränkt die Dateiauswahl auf eine Zeitspanne bezogen auf ein Freigabedatum mit dem Datum des Folgetages. Der Zeitstempel für EXPIRATION-DATE ist derzeit immer mit 00:00:00 eingetragen!
TIME = *INTERVAL(...)
Es werden nur Dateigenerationen gelöscht, deren Freigabedatum innerhalb des nachfolgend angegebenen Zeitintervalls liegt.
FROM = 00:00:00 / <time>
Wählt Dateigenerationen aus, deren Freigabezeitpunkt >= angegebener Zeitpunkt ist.
TO = 23:59:59 / <time>
Wählt Dateigenerationen aus, deren Freigabezeitpunkt <= angegebener Zeitpunkt ist.
EXPIRATION-DATE = *TODAY(...)
Es werden nur Dateigenerationen gelöscht, deren Gruppeneintrag für EXPIRATION-DATE das aktuelle Tagesdatum enthält.
TIME = *ANY / *INTERVAL(...)
Beschränkt die Dateiauswahl auf eine Zeitspanne bezogen auf ein Freigabedatum mit dem aktuellen Tagesdatum. Der Zeitstempel für EXPIRATION-DATE ist derzeit immer mit 00:00:00 eingetragen!
TIME = *INTERVAL(...)
Es werden nur Dateigenerationen gelöscht, deren Freigabedatum innerhalb des nachfolgend angegebenen Zeitintervalls liegt.
FROM = 00:00:00 / <time>
Wählt Dateigenerationen aus, deren Freigabezeitpunkt >= angegebener Zeitpunkt ist.
TO = 23:59:59 / <time>
Wählt Dateigenerationen aus, deren Freigabezeitpunkt <= angegebener Zeitpunkt ist.
EXPIRATION-DATE = *YESTERDAY(...)
Es werden nur Dateigenerationen gelöscht, deren Gruppeneintrag für EXPIRATION-DATE das Datum des Vortages enthält.
TIME = *ANY / *INTERVAL(...)
Beschränkt die Dateiauswahl auf eine Zeitspanne bezogen auf ein Freigabedatum mit dem Datum des Vortages. Der Zeitstempel für EXPIRATION-DATE ist derzeit immer mit 00:00:00 eingetragen!
TIME = *INTERVAL(...)
Es werden nur Dateigenerationen gelöscht, deren Freigabedatum innerhalb des nachfolgend angegebenen Zeitintervalls liegt.
FROM = 00:00:00 / <time>
Wählt Dateigenerationen aus, deren Freigabezeitpunkt >= angegebener Zeitpunkt ist.
TO = 23:59:59 / <time>
Wählt Dateigenerationen aus, deren Freigabezeitpunkt <= angegebener Zeitpunkt ist.
EXPIRATION-DATE = <integer -99999..991231>(...)
Es werden nur Dateigenerationen gelöscht, deren Gruppeneintrag 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)
TIME = *ANY / *INTERVAL(...)
Beschränkt die Dateiauswahl auf eine Zeitspanne bezogen auf das angegebene Freigabedatum. Der Zeitstempel für EXPIRATION-DATE ist derzeit immer mit 00:00:00 eingetragen!
TIME = INTERVAL(...)
Es werden nur Dateigenerationen gelöscht, deren Freigabedatum innerhalb des nachfolgend angegebenen Zeitintervalls liegt.
FROM = 00:00:00 / <time>
Wählt Dateigenerationen aus, deren Freigabezeitpunkt >= angegebener Zeitpunkt ist.
TO = 23:59:59 / <time>
Wählt Dateigenerationen aus, deren Freigabezeitpunkt <= angegebener Zeitpunkt ist.
EXPIRATION-DATE = <date>(...)
Es werden nur Dateigenerationen gelöscht, deren Gruppeneintrag für EXPIRATION-DATE das angegebene Datum enthält. Der Anwender kann das Freigabedatum in der Form [yy]yy-mm-dd angeben.
TIME = *ANY / *INTERVAL(...)
Beschränkt die Dateiauswahl auf eine Zeitspanne bezogen auf das angegebene Freigabedatum. Der Zeitstempel für EXPIRATION-DATE ist derzeit immer mit 00:00:00 eingetragen!
TIME = *INTERVAL(...)
Es werden nur Dateigenerationen gelöscht, deren Freigabedatum innerhalb des nachfolgend angegebenen Zeitintervalls liegt.
FROM = 00:00:00 / <time>
Wählt Dateigenerationen aus, deren Freigabezeitpunkt >= angegebener Zeitpunkt ist.
TO = 23:59:59 / <time>
Wählt Dateigenerationen aus, deren Freigabezeitpunkt <= angegebener Zeitpunkt ist.
EXPIRATION-DATE = *INTERVAL(...)
Es werden nur die Dateigenerationen gelöscht, deren Freigabe im nachfolgend angegebenen Zeitraum liegt, d.h. Dateigenerationen, 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 Löschen 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 Dateigenerationen gelöscht, deren Schutzfrist nach dem angegebenes Datum erlischt (EXPIRATION-DATE >= angegebenes Datum).
FROM = *TOMORROW(...)
Es werden nur Dateigenerationen gelöscht, deren EXPIRATION-DATE >= Datum des Folgetages ist.
TIME = 00:00:00 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren EXPIRATION-DATE nach dem angegebenen Zeitpunkt liegt. Der Zeitstempel für EXPIRATION-DATE ist derzeit immer mit 00:00:00 eingetragen!
FROM = *TODAY(...)
Es werden nur Dateigenerationen gelöscht, deren EXPIRATION-DATE >= aktuelles Tagesdatum ist.
TIME = 00:00:00 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren EXPIRATION-DATE nach dem angegebenen Zeitpunkt liegt. Der Zeitstempel für EXPIRATION-DATE ist derzeit immer mit 00:00:00 eingetragen!
FROM = *YESTERDAY(...)
Es werden nur Dateigenerationen gelöscht, deren EXPIRATION-DATE >= Datum des Vortages ist.
TIME = 00:00:00 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren EXPIRATION-DATE nach dem angegebenen Zeitpunkt liegt. Der Zeitstempel für EXPIRATION-DATE ist derzeit immer mit 00:00:00 eingetragen!
FROM = <integer -99999..991231>(...)
Es werden nur Dateigenerationen gelöscht, deren EXPIRATION-DATE >= angegebenes Datum ist.
TIME = 00:00:00 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren EXPIRATION-DATE nach dem angegebenen Zeitpunkt liegt. Der Zeitstempel für EXPIRATION-DATE ist derzeit immer mit 00:00:00 eingetragen!
FROM = <date>(...)
Es werden nur Dateigenerationen gelöscht, deren EXPIRATION-DATE >= angegebenes Datum ist.
TIME = 00:00:00 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren EXPIRATION-DATE nach dem angegebenen Zeitpunkt liegt. Der Zeitstempel für EXPIRATION-DATE ist derzeit immer mit 00:00:00 eingetragen!
TO = *LATEST / *TOMORROW(...) / *TODAY(...) / *YESTERDAY(...) /
<integer -99999..991231>(...) / <date>(...)
Es werden nur die Dateigenerationen gelöscht, deren Schutzfrist spätestens an dem angegebenen Datum erloschen ist (EXPIRATION-DATE <= angegebenes Datum)
TO = *TOMORROW(...)
Es werden nur Dateigenerationen gelöscht, für die EXPIRATION-DATE <= Datum des Folgetages ist.
TIME = 23:59:59 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren EXPIRATION-DATE vor dem angegebenen Zeitpunkt liegt. Der Zeitstempel für EXPIRATION-DATE ist derzeit immer mit 00:00:00 eingetragen!
TO = *TODAY(...)
Es werden nur Dateigenerationen gelöscht, für die EXPIRATION-DATE <= aktuelles Tagesdatum ist.
TIME = 23:59:59 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren EXPIRATION-DATE vor dem angegebenen Zeitpunkt liegt. Der Zeitstempel für EXPIRATION-DATE ist derzeit immer mit 00:00:00 eingetragen!
TO = *YESTERDAY(...)
Es werden nur Dateigenerationen gelöscht, für die EXPIRATION-DATE ≤ Datum des Vortages ist.
TIME = 23:59:59 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren EXPIRATION-DATE vor dem angegebenen Zeitpunkt liegt. Der Zeitstempel für EXPIRATION-DATE ist derzeit immer mit 00:00:00 eingetragen!
TO = <integer -99999..991231>(...)
Es werden nur Dateigenerationen gelöscht, für die EXPIRATION-DATE <= angegebenes Datum ist.
TIME = 23:59:59 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren EXPIRATION-DATE vor dem angegebenen Zeitpunkt liegt. Der Zeitstempel für EXPIRATION-DATE ist derzeit immer mit 00:00:00 eingetragen!
TO = <date>(...)
Es werden nur Dateigenerationen gelöscht, für die EXPIRATION-DATE <= angegebenes Datum ist.
TIME = 23:59:59 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren EXPIRATION-DATE vor dem angegebenen Zeitpunkt liegt. Der Zeitstempel für EXPIRATION-DATE ist derzeit immer mit 00:00:00 eingetragen!
SUPPORT = *ANY / *PRIVATE-DISK
Der Anwender kann über den Datenträgertyp festlegen, welche Dateigenerationen gelöscht werden sollen.
SUPPORT = *ANY
Der Datenträgertyp dient nicht als Auswahlkriterium.
SUPPORT = *PRIVATE-DISK
Nur Dateigenerationen auf Privatplatten werden gelöscht.
ACCESS = *ANY / *READ / *WRITE
Als Auswahlkriterium dient die angegebene Zugriffsart (ACCESS-Wert im Gruppeneintrag.)
ACCESS = ANY
Der ACCESS-Wert wird als Auswahlkriterium nicht berücksichtigt.
ACCESS = *READ
Es werden nur die Dateigenerationen gelöscht, für die Schreibzugriff mit ACCESS= READ unterbunden ist, d.h. für die nur Lesezugriff zulässig ist.
PASSWORD = *ANY / list-poss(4): *NONE / *READ-PASSWORD / *WRITE-PASSWORD /
*EXEC-PASSWORD
Der Anwender kann über den Kennworttyp die Dateigenerationen auswählen, die gelöscht werden sollen.
PASSWORD = *ANY
Der Kennwortschutz dient nicht als Auswahlkriterium.
PASSWORD = *NONE
Es werden nur Dateigenerationen gelöscht, für die kein Kennwortschutz besteht.
PASSWORD = *READ-PASSWORD
Es werden nur Dateigenerationen gelöscht, die durch ein Lesekennwort geschützt sind.
PASSWORD = *WRITE-PASSWORD
Es werden nur Dateigenerationen gelöscht, die durch ein Schreibkennwort geschützt sind.
USER-ACCESS = *ANY / list-poss(2): *OWNER-ONLY / *ALL-USERS
Der Anwender kann die Zugriffsberechtigung einer Dateigeneration als Auswahlkriterium nutzen.
USER-ACCESS = *ANY
Die Zugriffsberechtigung dient nicht als Auswahlkriterium.
USER-ACCESS = *OWNER-ONLY
Es werden nur Dateigenerationen gelöscht, die nur dem Eigentümer zugänglich sind.
USER-ACCESS = *ALL-USERS
Es werden nur Dateigenerationen bearbeitet, auf die mehrere Benutzer Zugriff haben.
BACKUP-CLASS = *ANY / list-poss(5): *A / *B / *C / *D / *E
Der Anwender kann über den BACKUP-CLASS-Level die Dateigenerationen auswählen, die gelöscht werden sollen.
BACKUP-CLASS = *ANY
Der BACKUP-CLASS-Level dient nicht als Auswahlkriterium.
BACKUP-CLASS = *A
Nur Dateigenerationen, deren Gruppeneintrag den Wert BACKUP=*A enthält, werden bearbeitet (häufigste Sicherung).
BACKUP-CLASS = *B
Nur Dateigenerationen, deren Gruppeneintrag den Wert BACKUP=*B enthält, werden bearbeitet.
BACKUP-CLASS = *C
Nur Dateigenerationen, deren Gruppeneintrag den Wert BACKUP=*C enthält, werden bearbeitet.
BACKUP-CLASS = *D
Nur Dateigenerationen, deren Gruppeneintrag den Wert BACKUP=*D enthält, werden bearbeitet.
BACKUP-CLASS = *E
Nur Dateigenerationen, deren Gruppeneintrag den Wert BACKUP=*E enthält, werden bearbeitet.
MIGRATE = *ANY / list-poss(3): *ALLOWED / *INHIBITED / *FORBIDDEN
Der Anwender kann über die im Gruppeneintrag gewählte Migration (s. Kommando CREATE-FILE-GROUP, Operand MIGRATE) die Dateigenerationen auswählen, die gelöscht werden sollen.
MIGRATE = *ANY
Es werden die angegebenen Dateigenerationen gelöscht, unabhängig vom Wert des jeweiligen MIGRATE-Operanden im Gruppeneintrag.
MIGRATE = *ALLOWED
Es werden nur Dateigenerationen gelöscht, für die im Gruppeneintrag der entsprechende Operandenwert vereinbart wurde, d.h. Dateigenerationen, die auf die Speicherebenen S1 und S2 verdrängt werden dürfen.
MIGRATE = *INHIBITED
Es werden nur Dateigenerationen bearbeitet, für die im Gruppeneintrag der entsprechende Operandenwert vereinbart wurde, d.h. Dateigenerationen, die nicht verdrängt werden dürfen.
MIGRATE = *FORBIDDEN
Es werden nur Dateigenerationen bearbeitet, für die im Katalogeintrag der entsprechende Operandenwert vereinbart wurde, d.h. Dateigenerationen, für die eine verschärfte Migrations-Sperre vereinbart ist. Die Dateigenerationen dürfen auch nicht kurzzeitig verdrängt werden (z.B. bei einer Reorganisation).
CODED-CHARACTER-SET = *ANY / *NONE / <name 1..8>
Auswahlkriterium ist die im Gruppeneintrag vereinbarte Codierung (Bedeutung siehe Kommando CREATE-FILE; siehe auch Kommando SHOW-FILE-ATTRIBUTES, Ausgabefeld COD-CH-SET, wenn ein CCS vereinbart wurde).
CODED-CHARACTER-SET = *ANY
Die vereinbarte Codierung ist kein Auswahlkriterium.
CODED-CHARACTER-SET = *NONE
Es werden nur Dateigenerationen gelöscht, für die eine Codierung nicht explizit festgelegt wurde.
CODED-CHARACTER-SET = <name 1..8>
Es werden nur Dateigenerationen gelöscht, für die die angegebene Codierung festgelegt wurde.
SPACE-RELEASE-LOCK = *ANY / *NO / *YES
Auswahlkriterium ist die Sperre gegen Freigabe von nicht belegtem Speicherplatz (siehe auch Kommando SHOW-FILE-ATTRIBUTES, Ausgabefeld SP-REL-LOCK).
SPACE-RELEASE-LOCK = *ANY
Die Erlaubnis zur Freigabe von nicht belegtem Speicherplatz ist kein Auswahlkriterium.
SPACE-RELEASE-LOCK = *NO
Es werden nur Dateigenerationen gelöscht, bei denen nicht belegter Speicherplatz freigegeben werden darf.
SPACE-RELEASE-LOCK = *YES
Es werden nur Dateigenerationen gelöscht, bei denen die Freigabe von Speicherplatz nicht erlaubt ist.
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 Dateigenerationen gelöscht, die keinen BASIC-ACL-Eintrag im Katalog besitzen.
BASIC-ACL = *YES
Es werden nur Dateigenerationen gelöscht, die einen BASIC-ACL-Eintrag im Katalog besitzen.
BASIC-ACL = *PARAMETERS(...)
Es werden nur Dateigenerationen gelöscht, 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.
GROUP = *ANY / *NO-ACCESS / *PARAMETERS(...)
Gibt an, welche Zugriffsrechte 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.
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.
GUARDS = *ANY / *NO / *YES / *PARAMETERS(...)
Auswahlkriterium ist der Zugriffsschutz mit GUARDS (siehe Kommando CREATE-FILE-GROUP bzw. MODIFY-FILE-GROUP-ATTRIBUTES).
GUARDS = *ANY
Der Zugriffsschutz mit GUARDS ist kein Auswahlkriterium.
GUARDS = *NO
Es werden nur Dateigenerationen gelöscht, die nicht mit GUARDS gegen unberechtigte Zugriffe geschützt sind (siehe auch Operand PROTECTION-LEVEL).
GUARDS = *YES
Es werden nur Dateigenerationen gelöscht, die mit GUARDS gegen unberechtigte Zugriffe geschützt sind, d.h. die Zugriffskontrolle erfolgt für diese Dateien über GUARDS.
GUARDS = *PARAMETERS(...)
Es werden nur Dateigenerationen gelöscht, die in der angegebenen Weise mit
GUARDS gegen unberechtigte Zugriffe geschützt sind, d.h. die Zugriffskontrolle erfolgt über GUARDS:
Der Zugriff auf die Dateigeneration wird über einen Guard geregelt, d.h. ein spezielles Objekt, das alle Bedingungen enthält, unter denen ein Benutzer die Zugriffserlaubnis erhält: z.B. Datum, Uhrzeit, Benutzerkennung. Ein Guard kann nur mit der Funktionseinheit GUARDS des kostenpflichtigen Software-Produkts SECOS erstellt und verwaltet werden (siehe Handbuch „SECOS“ [35]).
Jede Zugriffsart kann über einen eigenen Guard kontrolliert werden. Ist für eine Zugriffsart kein Guard vereinbart (*NONE), so sind keine entsprechenden Zugriffe erlaubt.
Ist ein vereinbarter Guard nicht zugreifbar, so sind die mit ihm geschützten Zugriffe nicht erlaubt. Ist das Subsystem GUARDS zum Zeitpunkt des Zugriffs nicht verfügbar, so sind keinerlei Zugriffe möglich.
READ = *ANY / *NONE / <filename 1..18 without-cat-gen-vers>
Es werden nur Dateigenerationen gelöscht, die mit dem angegebenen Guard gegen unberechtigte Lesezugriffe geschützt sind.
Die Voreinstellung *ANY bedeutet, dass die Auswahl der Dateigenerationen unabhängig von dem Leseschutz mit einem Guard erfolgt.
Mit *NONE werden Dateigenerationen ausgewählt, für die keine Lesezugriffe erlaubt sind.
WRITE = *ANY / *NONE / <filename 1..18 without-cat-gen-vers>
Es werden nur Dateigenerationen gelöscht, die mit dem angegebenen Guard gegen unberechtigte Schreibzugriffe geschützt sind.
Die Voreinstellung *ANY bedeutet, dass die Auswahl der Dateigenerationen unabhängig von dem Schreibschutz mit einem Guard erfolgt.
Mit *NONE werden Dateigenerationen ausgewählt, für die keine Schreibzugriffe erlaubt sind. Diese Dateigenerationen können mit IGNORE-PROTECTION= *ACCESS gelöscht werden.
MANAGEMENT-CLASS = *ANY / *NONE / <composed-name 1..8>
Auswahlkriterium ist die HSMS-Management-Klasse.
MANAGEMENT-CLASS = *ANY
Die HSMS-Management-Klasse ist kein Auswahlkriterium.
MANAGEMENT-CLASS = *NONE
Es werden nur Dateigenerationen gelöscht, denen keine HSMS-Management-Klasse zugewiesen ist.
MANAGEMENT-CLASS = <composed-name 1..8>
Es werden nur Dateigenerationen gelöscht, denen die angegebene HSMS-Management-Klasse zugewiesen ist.
FREE-FOR-DELETION = *ANY / *NONE / *TOMORROW(...) / *TODAY(...) / *YESTERDAY(...) /
<integer - 99999..0>(...) / <date>(...) / *INTERVAL(...)
Der Benutzer kann über das Lösch-Freigabedatum die Dateigenerationen auswählen, die gelöscht werden sollen. Für ein angegebenes Datum kann die Auswahl auf ein Zeitintervall für das Lösch-Freigabedatum eingeschränkt werden (siehe Operand TIME der jeweiligen Struktur).
Siehe auch Kommando SHOW-FILE-ATTRIBUTES, Ausgabefelder FREE-DEL-D und FREE-DEL-T.
FREE-FOR-DELETION = *ANY
Das Lösch-Freigabedatum dient nicht als Auswahlkriterium.
FREE-FOR-DELETION = *NONE
Es werden nur Dateigenerationen gelöscht, für die noch kein Lösch-Freigabedatum im Katalog eingetragen ist.
FREE-FOR-DELETION = *TOMORROW(...)
Es werden nur Dateigenerationen gelöscht, in deren Katalogeintrag das Datum des Folgetages als Lösch-Freigabedatum eingetragen ist.
TIME = *ANY / *INTERVAL(...)
Beschränkt die Dateiauswahl auf eine Zeitspanne bezogen auf das Datum des Folgetages.
TIME = *INTERVAL(...)
Es werden nur Dateigenerationen gelöscht, deren Lösch-Freigabedatum innerhalb des nachfolgend angegebenen Zeitintervalls liegt.
FROM = 00:00:00 / <time>
Wählt Dateien aus, deren Lösch-Freigabedatum >= angegebener Zeitpunkt ist.
TO = 23:59:59 / <time>
Wählt Dateien aus, deren Lösch-Freigabedatum <= angegebener Zeitpunkt ist.
FREE-FOR-DELETION = *TODAY(...)
Es werden nur Dateigenerationen gelöscht, in deren Katalogeintrag das aktuelle Tagesdatum als Lösch-Freigabedatum eingetragen ist.
TIME = *ANY / *INTERVAL(...)
Beschränkt die Dateiauswahl auf eine Zeitspanne bezogen auf das aktuelle Tagesdatum.
TIME = *INTERVAL(...)
Es werden nur Dateigenerationen gelöscht, deren Lösch-Freigabedatum innerhalb des nachfolgend angegebenen Zeitintervalls liegt.
FROM = 00:00:00 / <time>
Wählt Dateigenerationen aus, deren Lösch-Freigabedatum >=l angegebener Zeitpunkt ist.
TO = 23:59:59 / <time>
Wählt Dateigenerationen aus, deren Lösch-Freigabedatum <= angegebener Zeitpunkt ist.
FREE-FOR-DELETION = *YESTERDAY(...)
Es werden nur Dateigenerationen gelöscht, in deren Katalogeintrag als Lösch-Freigabedatum das Datum des Vortages eingetragen ist.
TIME = *ANY / *INTERVAL(...)
Beschränkt die Dateiauswahl auf eine Zeitspanne bezogen auf das Datum des Vortages.
TIME = *INTERVAL(...)
Es werden nur Dateigenerationen gelöscht, deren Lösch-Freigabedatum innerhalb des nachfolgend angegebenen Zeitintervalls geändert wurde.
FROM = 00:00:00 / <time>
Wählt Dateigenerationen aus, deren Lösch-Freigabedatum >= angegebener Zeitpunkt ist.
TO = 23:59:59 / <time>
Wählt Dateigenerationen aus, deren Lösch-Freigabedatum <= angegebener Zeitpunkt ist.
FREE-FOR-DELETION = <integer -99999..99999>(...)
Es werden nur Dateigenerationen gelöscht, in deren Katalogeintrag das angegebene Lösch-Freigabedatum eingetragen ist. Das Lösch-Freigabedatum wird relativ zum aktuellen Tagesdatum angeben (in der Form -n für die Vergangenheit bzw. +n für die Zukunft).
TIME = *ANY / *INTERVAL(...)
Beschränkt die Dateiauswahl auf eine Zeitspanne bezogen auf das angegebene Lösch-Freigabedatum.
TIME = *INTERVAL(...)
Es werden nur Dateigenerationen gelöscht, deren Lösch-Freigabedatum innerhalb des nachfolgend angegebenen Zeitintervalls liegt.
FROM = 00:00:00 / <time>
Wählt Dateigenerationen aus, deren Lösch-Freigabedatum >= angegebener Zeitpunkt ist.
TO = 23:59:59 / <time>
Wählt Dateigenerationen aus, deren Lösch-Freigabedatum <= angegebener Zeitpunkt ist.
FREE-FOR-DELETION = <date>(...)
Es werden nur Dateigenerationen gelöscht, in deren Katalogeintrag als Lösch-Freigabedatum genau das angegebene Datum eingetragen ist.
Der Benutzer kann das Datum in der Form [yy]yy-mm-dd angeben, wobei zweistellige Jahreszahlen < 60 mit 20, Angaben >= 60 mit 19 ergänzt werden.
TIME = *ANY / *INTERVAL(...)
Beschränkt die Dateiauswahl auf eine Zeitspanne bezogen auf das angegebene Lösch-Freigabedatum.
TIME = *INTERVAL(...)
Es werden nur Dateigenerationen gelöscht, deren Lösch-Freigabedatum innerhalb des nachfolgend angegebenen Zeitintervalls liegt.
FROM = 00:00:00 / <time>
Wählt Dateigenerationen aus, deren Lösch-Freigabedatum >= angegebener Zeitpunkt ist.
TO = 23:59:59 / <time>
Wählt Dateigenerationen aus, deren Lösch-Freigabedatum <= angegebener Zeitpunkt ist.
FREE-FOR-DELETION = *INTERVAL(...)
Es werden nur Dateigenerationen gelöscht, deren Lösch-Freigabedatum innerhalb des angegebenen Zeitraums liegt.
Bereichsangaben gelten jeweils einschließlich der Bereichsgrenzen (siehe auch Erläuterungen zur Datumsangabe beim Operanden FREE-FOR-
DELETION=<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. Eine sinnvolle Informationsausgabe mit Bereichsgrenzen ist nur möglich, wenn die Untergrenze <= der Obergrenze gewählt wird.
FROM = *EARLIEST / *TOMORROW(...) / *TODAY(...) / *YESTERDAY(...) /
<integer -99999..99999>(...) / <date>(...)
Es werden nur Dateigenerationen gelöscht, deren Lösch-Freigabedatum >= angegebenes Datum ist.
FROM = *TOMORROW(...)
Es werden nur Dateigenerationen gelöscht, deren Lösch-Freigabedatum >= Datum des Folgetages ist.
TIME = 00:00:00 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateien, deren Lösch-Freigabedatum nach dem angegebenen Zeitpunkt liegt.
FROM = *TODAY(...)
Es werden nur Dateigenerationen gelöscht, deren Lösch-Freigabedatum >= aktuelles Tagesdatum ist.
TIME = 00:00:00 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren Lösch-Freigabedatum nach dem angegebenen Zeitpunkt liegt.
FROM = *YESTERDAY(...)
Es werden nur Dateigenerationen gelöscht, deren Lösch-Freigabedatum >= Datum des Vortages ist.
TIME = 00:00:00 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren Lösch-Freigabedatum nach dem angegebenen Zeitpunkt liegt.
FROM = <integer -99999..99999>(...)
Es werden nur Dateigenerationen gelöscht, deren relativ angegebenes Lösch-Freigabedatum >= angegebenes Datum ist (in der Form -n für die Vergangenheit bzw. +n für die Zukunft).
TIME = 00:00:00 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren Lösch-Freigabedatum nach dem angegebenen Zeitpunkt liegt.
FROM = <date>(...)
Es werden nur Dateigenerationen gelöscht, deren Lösch-Freigabedatum >= angegebenes Datum ist. Der Benutzer kann das Datum in der Form [yy]yy-mm-dd angeben, wobei zweistellige Jahreszahlen < 60 mit 20, Angaben >= 60 mit 19 ergänzt werden.
TIME = 00:00:00 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren Lösch-Freigabedatum nach dem angegebenen Zeitpunkt liegt.
TO = *LATEST / *TODAY(...) / *TOMORROW(...) / *YESTERDAY(...) /
<integer -99999..99999>(...) / <date>(...)
Es werden nur Dateigenerationen gelöscht, deren Lösch-Freigabedatum <= angegebenes Datum ist.
TO = *LATEST
Das Intervall für die Auswahl nach dem Lösch-Freigabedatum ist nach oben offen.
TO = *TODAY(...)
Es werden nur Dateien gelöscht, deren Lösch-Freigabedatum <= aktuelles Tagesdatum ist.
TIME = 23:59:59 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren Lösch-Freigabedatum vor dem angegebenen Zeitpunkt liegt.
TO = *TOMORROW(...)
Es werden nur Dateigenerationen gelöscht, deren Lösch-Freigabedatum <= Datum des Folgetages ist.
TIME = 23:59:59 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateien, deren Lösch-Freigabedatum vor dem angegebenen Zeitpunkt liegt.
TO = *YESTERDAY(...)
Es werden nur Dateigenerationen gelöscht, deren Lösch-Freigabedatum <= Datum des Vortages ist.
TIME = 23:59:59 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren Lösch-Freigabedatum vor dem angegebenen Zeitpunkt liegt.
TO = <integer -99999..99999>(...)
Es werden nur Dateigenerationen gelöscht, deren relativ angegebenes Lösch-Freigabedatum <= angegebenes Datum ist (in der Form -n für die Vergangenheit bzw. +n für die Zukunft).
TIME = 23:59:59 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren Lösch-Freigabedatum vor dem angegebenen Zeitpunkt liegt.
TO = <date>(...)
Es werden nur Dateigenerationen gelöscht, deren Lösch-Freigabedatum <= angegebenes Datum ist. Der Benutzer kann das Datum in der Form [yy]yy-mm-dd angeben, wobei zweistellige Jahreszahlen < 60 mit 20, Angaben >= 60 mit 19 ergänzt werden.
TIME = 23:59:59 / <time>
Uhrzeit zum angegebenen Datum. Ausgewählt werden alle Dateigenerationen, deren Lösch-Freigabedatum vor dem angegebenen Zeitpunkt liegt.
WORK-FILE-GROUP = *ANY / *NO / *YES
Auswahlkriterium ist die Kennzeichnung bezüglich Arbeitsdateien.
WORK-FILE-GROUP = *ANY
Die Kennzeichnung bezüglich Arbeitsdateien ist kein Auswahlkriterium.
WORK-FILE-GROUP = *NO
Es werden nur Dateigenerationen gelöscht, die nicht als Arbeitsdateien gekennzeichnet sind.
WORK-FILE-GROUP = *YES
Es werden nur Dateigenerationen gelöscht, die als Arbeitsdateien gekennzeichnet sind.
OPTION = *ALL / *SPACE / *DATA / *DATA-KEEP-ATTRIBUTES / *DESTROY-ALL
Angabe zum Löschen der Datei.
Ist im Katalogeintrag DESTROY-BY-DELETE=YES vereinbart, wird die Datei bzw. der freigegebenen Speicherplatz in jedem Fall mit binär null überschrieben. Anderenfalls wird, außer bei OPTION=DESTROY-ALL, nur logisch gelöscht.
OPTION = *ALL
Voreinstellung für Plattendateien.
Die Katalogeinträge der betroffenen Dateigenerationen werden gelöscht und ihr Speicherplatz freigegeben.
OPTION = *SPACE
nur für Dateigenerationen auf Public-Platten (bei Banddateien gilt die Voreinstellung *ALL):
Der Speicherplatz der mit DELETE-FILE-GENERATION gelöschten Dateigenerationen wird freigegeben, der Katalogeintrag bleibt erhalten, wird jedoch verändert: er ist dann identisch mit einem mit Kommando CREATE-FILE-GENERATION und SUPPORT=*NONE erstellten Katalogeintrag.
Für Dateigenerationen auf Privatplatten wird der Operand SPACE abgewiesen.
OPTION = *DATA
nur für Plattendateien (bei Banddateien gilt die Voreinstellung *ALL): Die Daten der betroffenen Dateigenerationen werden „logisch gelöscht“. Anschließend sind sie für den Anwender nicht mehr ansprechbar, da ihm der physikalische Zugriff auf Datenträger nicht gestattet ist. Gruppeneintrag und Speicherplatzzuweisung bleiben erhalten. Der Katalogeintrag ist identisch mit dem Eintrag für eine mit CREATE-FILE-GENERATION eingerichtete Dateigeneration, die noch nicht eröffnet wurde (FILE-STRUC=NONE, CRE-DATE=NONE).
OPTION = *DATA-KEEP-ATTRIBUTES
Nur für Plattendateien (bei Banddateien gilt die Voreinstellung ALL):
Die Daten der betroffenen Dateigenerationen werden wie bei OPTION=*DATA „logisch gelöscht“, aber die datenbezogenen Dateieigenschaften bleiben erhalten. Die Daten sind für den Benutzer nicht mehr ansprechbar.
OPTION = *DESTROY-ALL
Nur für Plattendateien (bei Banddateien gilt die Voreinstellung *ALL):
Der Speicherplatz der betroffenen Dateigenerationen wird freigegeben, der Gruppeneintrag gelöscht; zusätzlich wird der frei werdendeende Speicherplatz mit binär null überschrieben, sodass bei späterer Neuzuweisung des Speicherplatzes niemand die alten Daten lesen kann (Datenschutz). Für Dateigenerationen auf Privatplatte müssen zum Zeitpunkt des Löschens alle Datenträger der Datei bereitstehen.
Wird die Dateigeneration gelöscht, werden zunächst die Aktionsparameter ausgewertet. Zum Exportieren von Dateigenerationen siehe Kommando EXPORT-FILE. „Datenzerstörung“ beim Löschen kann auch über das Kommando CREATE-FILE-GROUP im Gruppeneintrag verankert werden; dort ist dann ein „DESTROY“-Kennzeichen gesetzt (DESTROY=YES). In diesem Fall wird bei Speicherplatzfreigabe der frei werdende Speicherplatz automatisch überschrieben.
MOUNT = *FIRST-DISK / *ALL-DISKS
Nur für Dateigenerationen auf Privatplatten:
Gibt an, ob alle Privatplatten, auf denen sich zu löschende Dateigenerationen befinden, zu montieren sind.
Der Anwender fordert die Bereitstellung der ersten oder aller benötigten Privatplatten an. Der MOUNT-Operand sollte zusammen mit den Operanden ALL oder DESTROY-ALL angegeben werden. Für Banddateien oder Dateigenerationen auf Public-Platten wird eine MOUNT-Angabe ignoriert.
MOUNT = *FIRST-DISK
Nur die Privatplatte, auf der die jeweilige zu löschende Dateigeneration beginnt und die den Gruppeneintrag der Dateigeneration enthält, muss online sein. Die übrigen Privatplatten müssen nicht online sein.
MOUNT = *ALL-DISKS
Alle Privatplatten, auf denen Teile der Dateigeneration gespeichert sind, müssen online sein. Fehlt eine Platte, wird die Datei nicht gelöscht; nach Abschluss der DELETE-FILE-GENERATION-Verarbeitung wird der Spin-Off-Mechanismus aktiviert.
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 Löschens 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 Dateigeneration bzw. Dateimenge wird gelöscht.
N: Die angegebene Dateigeneration bzw. Dateimenge wird nicht gelöscht.
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(4): ACCESS / EXDATE / RDPASS / WRPASS Gibt an, welche Schutzattribute beim Löschen ignoriert werden sollen. Die Angabe wirkt nur beim Kontrolldialog für eine einzelne Dateigeneration. RDPASS bzw. WRPASS kann nur der privilegierte Benutzer angeben.
,PASSWORD = list-poss(3): <c-string 1..4> / <x-string 1..8> / <integer -2147483648..2147483647>Ermöglicht das Löschen kennwortgeschützter Dateigenerationen (maximal 3 Kennwörter). Die Angabe wirkt nur beim Kontrolldialog für eine einzelne Dateigeneration.
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 DELETE-FILE-GENERATION-Verarbeitung nicht eingreifen; alle angegebenen Dateigenerationen werden gelöscht (d.h. kein Kontrolldialog).
DIALOG-CONTROL = *ERROR
Erfolgt das Löschen der ausgewählten Dateigenerationen ohne Fehler, werden wie bei *NO alle Dateigenerationen sofort gelöscht (d.h. kein Kontrolldialog).
Tritt beim Löschen jedoch ein behebarer Fehler auf, so wird ein Kontrolldialog 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 Bearbeitung von DELETE-FILE-GENERATION abbrechen oder versuchen den Fehler zu beheben. Außerdem kann er den DIALOG-CONTROL-Modus wechseln.
DIALOG-CONTROL = *FILE-CHANGE
Bei jeder zu löschenden Dateigeneration hat der Benutzer die beim ersten DIALOG-CONTROL-Operanden beschriebenen Eingriffsmöglichkeiten.
Der Anwender kann für jede Dateigeneration, die bearbeitet wird, im Dialog entscheiden, ob sie gelöscht 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 Dateigeneration ausgewertet und die Dateigeneration ohne weitere Rückfrage gelöscht (“YES“ muss ebenfalls angegeben werden!). Der Anwender kann auch die DELETE-FILE-GENERATION-Verarbeitung abbrechen oder den DIALOG-CONTROL-Modus wechseln.
Die betroffenen Dateigenerationen werden alphanumerisch sortiert aufgelistet.
DIALOG-CONTROL = *MORE-THAN-ONE-FILE
Wurde genau eine Dateigeneration spezifiziert, so wird diese sofort gelöscht. Ist GENERATION-NAME teilqualifiziert angegeben, sodass mehr als eine Dateigeneration angesprochen wird, oder enthält GENERATION-NAME Muster, kann der Anwender bei Wechsel der Katalogkennung entscheiden, ob Dateigenerationen aus dem jeweiligen Katalog gelöscht 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 GENERATION-NAME Muster angegeben wurden. Im Dialog kann die DELETE-FILE-GENERATION-Bearbeitung abgebrochen oder der DIALOG-CONTROL-Modus geändert werden.
DIALOG-CONTROL = *CATALOG-CHANGE
Ähnlich wie bei DIALOG-CONTROL = *MORE-THAN-ONE-FILE geht die DELETE-FILE-GENERATION-Verarbeitung in den geführten Dialog über, wenn Dateigenerationen aus verschiedenen Katalogen (Pubsets) betroffen sind. Der Benutzer bestimmt, ob die Dateigenerationen auf dem aktuellen Pubset gelöscht werden sollen (YES/NO), ob er die DELETE-FILE-GENERATION-Verarbeitung abbrechen oder den DIALOG-CONTROL-Modus wechseln will.
DIALOG-CONTROL = *USER-ID-CHANGE
Bei jedem Wechsel der Benutzerkennung beim Löschen der Dateigenerationen wird in den geführten Dialog verzweigt.
OUTPUT = *STD / *NO / *SYSOUT
Der Anwender kann bestimmen, ob für jede erfolgreich gelöschte Dateigeneration eine Meldung (DMS0800) mit dem Namen der gelöschten Dateigeneration nach SYSOUT ausgegeben werden soll. Die Voreinstellung *STD entspricht OUTPUT=*NO.
OUTPUT = *NO
Für erfolgreich gelöschte Dateigenerationen werden keine Meldungen nach SYSOUT ausgegeben.
OUTPUT = *SYSOUT
Für jede erfolgreich gelöschte Dateigeneration wird zusätzlich eine Meldung mit ihrem Namen nach SYSOUT ausgegeben.
IGNORE-PROTECTION = *NONE / list-poss(4): *ACCESS / *EXPIRATION-DATE /
*WRITE-PASSWORD / *READ-PASSWORD
Der Anwender kann bestimmen, ob ein vereinbarter Schutz gegen Schreibzugriffe oder eine vereinbarte Schutzfrist ignoriert werden sollen. Die Systembetreuung kann zusätzlich Kennwortschutz ignorieren.
Die Angabe IGNORE-PROTECTION im Kommando DELETE-FILE-GENERATION ersetzt so das Kommando MODIFY-FILE-GROUP-ATTRIBUTES, mit dem vor dem Löschen die Schutzattribute zurückgesetzt werden müssten.
IGNORE-PROTECTION = *NONE
Die Schutzmerkmale „Schreibsperre“ (ACCESS=READ) und „Schutzfrist“ (EXPIRATION-DATE) werden beim Löschen berücksichtigt.
IGNORE-PROTECTION = *ACCESS
Dateigenerationen, für die mit ACCESS=READ Schreibschutz definiert ist, dürfen dennoch mit DELETE-FILE-GENERATION gelöscht werden.
IGNORE-PROTECTION = EXPIRATION-DATE
Dateigenerationen, für die noch eine Schutzfrist besteht (EXPIR-DATE > aktuelles Tagesdatum), dürfen mit DELETE-FILE-GENERATION gelöscht werden.
IGNORE-PROTECTION = *WRITE-PASSWORD
Die Systembetreuung ist berechtigt, das Schutzattribut Schreibkennwort beim Löschen der Dateigeneration zu ignorieren.
IGNORE-PROTECTION = *READ-PASSWORD
Die Systembetreuung ist berechtigt, das Schutzattribut Lesekennwort beim Löschen der Dateigeneration 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 Dateigenerationen gelöscht werden können. Die Kennwörter werden nicht in die Kennworttabelle des Auftrags eingetragen und gelten nur für die aktuelle DELETE-FILE-GENERATION-Verarbeitung. In Listenform können maximal 3 Kennwörter angegeben werden.
Zum Löschen einer kennwortgeschützten Dateigeneration 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 / garantierte Meldungen |
|---|---|---|---|
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 garantierte Meldungen: |
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 der zugew. Privatplatte 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 | 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 |
Hinweise
Soll eine Dateigeneration, die auf einer privaten Platte steht, gelöscht werden, so wird für den Auftrag das Gerät angefordert, auf dem diese Platte bereitsteht. Nach dem Löschen wird das Gerät an das System zurückgegeben.
Für Dateigenerationen auf privaten Platten müssen zum Zeitpunkt der Kommandoausführung alle Datenträger der Dateigeneration bereitstehen, falls DESTROY-ALL oder MOUNT=*ALL-DISK gegeben wurde. Sonst muss der erste Datenträger der Dateigeneration bereitstehen. Die folgenden Datenträger werden erst während der Kommandoausführung angefordert.
Diese Regel gilt auch, wenn durch einen teilqualifizierten Dateigenerationnamen mehrere Dateigenerationen im DELETE-FILE-GENERATION-Kommando angesprochen werden. In diesem Fall brauchen nicht die Datenträger sämtlicher Dateigenerationen gleichzeitig bereitgestellt werden. Vom System werden dann nur so viele Geräte angefordert, wie für diejenige Dateigeneration erforderlich sind, welche die meisten Datenträger belegt.
Beispiel
/show-file-attr max.group.4,select=(generation=*yes) ——————————————————————— (1)
% 0 :2OS2:$USER1.MAX.GROUP.4 (FGG) % 3 :2OS2:$USER1.MAX.GROUP.4(*0001) % 3 :2OS2:$USER1.MAX.GROUP.4(*0002) % 3 :2OS2:$USER1.MAX.GROUP.4(*0003) % 3 :2OS2:$USER1.MAX.GROUP.4(*0004) % 3 :2OS2:$USER1.MAX.GROUP.4(*0005) % 3 :2OS2:$USER1.MAX.GROUP.4(*0006) % 3 :2OS2:$USER1.MAX.GROUP.4(*0007) % 3 :2OS2:$USER1.MAX.GROUP.4(*0008) %:2OS2: PUBLIC: 9 FILES RES= 24 FRE= 24 REL= 24 PAGES
/del-file-gen gen-name=max.group.4(*2),delete=*generation-before,output=*sysout
% DMS0800 SPECIFIED FILE ':2OS2:$USER1.MAX.GROUP.4(*0001)' DELETED——————————————(2)
/del-file-gen gen-name=max.group.4(*6),delete=*generation-after,output=*sysout
% DMS0800 SPECIFIED FILE ':2OS2:$USER1.MAX.GROUP.4(*0008)' DELETED—————————————(3) % DMS0800 SPECIFIED FILE ':2OS2:$USER1.MAX.GROUP.4(*0007)' DELETED
/del-file-gen gen-name=max.group.4(*2) —————————————————————————(4) ——————————
% CMD0051 INVALID OPERAND 'DELETE' % CMD0099 MANDATORY OPERAND INVALID OR MISSING————————————————————————————————(5)
/show-file-attr max.group.4,select=(generation=*yes) —————————————————————(6) —
% 0 :2OS2:$USER1.MAX.GROUP.4 (FGG) % 3 :2OS2:$USER1.MAX.GROUP.4(*0002) % 3 :2OS2:$USER1.MAX.GROUP.4(*0003) % 3 :2OS2:$USER1.MAX.GROUP.4(*0004) % 3 :2OS2:$USER1.MAX.GROUP.4(*0005) % 3 :2OS2:$USER1.MAX.GROUP.4(*0006) %:2OS2: PUBLIC: 6 FILES RES= 15 FRE= 15 REL= 15 PAGES
(1) | Das Kommando SHOW-FILE-ATTRIBUTES informiert über die Dateigenerationsgruppe MAX.GROUP und alle zugehörigen Generationen. |
(2) | Mit dem Kommando DELETE-FILE-GENERATION werden alle Generationen gelöscht, die vor der Generation *0002 erstellt wurden. Es wird angezeigt, dass die Generation *0001 gelöscht wurde (siehe Operand OUTPUT=*SYSOUT). |
(3) | Mit dem Kommando DELETE-FILE-GENERATION werden alle Generationen gelöscht, die nach Generation *0006 erstellt wurden. Es wird angezeigt, dass die Generationen *0007 und *0008 gelöscht wurden (siehe Operand OUTPUT=*SYSOUT). |
(4) | Das Kommando DELETE-FILE-GENERATION wird für die Generation *0002 abgesetzt, wobei keine Angabe zum Operanden DELETE erfolgt. |
(5) | Das Kommando wird abgewiesen, da der Operand DELETE ein Pflichtoperand ist. Im Kommando DELETE-FILE-GENERATION können die Generationen gelöscht werden, die vor bzw. nach der angegebenen Generation erstellt wurden. |
(6) | Das Kommando SHOW-FILE-ATTRIBUTES informiert über die aktuellen Katalogeinträge für die Dateigenerationsgruppe und ihre existierenden Generationen. |