Die Anweisung CONVERT-FILE dient zur Konvertierung von Dateien aus einem Format, bei dem der PAM-Schlüssel für die Datendarstellung verwendet wird, in ein Format, bei dem der PAM-Schlüssel nicht verwendet wird, oder zur Konvertierung in entgegengesetzter Richtung.
Des Weiteren dient die Anweisung CONVERT-FILE zur Umblockung (siehe Abschnitt „Umblockung“).
Die Anweisung CONVERT-FILE bietet drei Möglichkeiten:
Konvertieren: Änderung des Dateiformats, d.h. Umwandlung von K-Format in NK-Format oder umgekehrt.
Umblocken: Änderung der logischen Blockgröße. Keine Änderung im Dateiformat.
Konvertieren und Umblocken
Die Standardwerte für die Anweisung CONVERT-FILE werden mit der Anweisung MODIFY-CONVERT-FILE-DEFAULTS eingestellt.
Die durch Unterstreichung gekennzeichneten Standardwerte gelten nur, wenn keine anderen Werte eingestellt wurden.
Format
CONVERT-FILE | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operanden
DIRECTION = *TO-NONKEY / *NONKEY-TO-KEY
Bezeichnet die Richtung der Dateikonvertierung.
DIRECTION = *TO-NONKEY
Die Dateikonvertierung soll ins NK-Format erfolgen. Die Quelldatei kann im K-Format oder im NK-Format vorliegen.
DIRECTION = *NONKEY-TO-KEY
Die Dateikonvertierung soll vom NK-Format ins K-Format erfolgen.
FROM-FILE = <filename 1..54> / *LINK(...) / <partial-filename 2..53 with-wild(79)> / *ALL
Bezeichnet die Dateien, die konvertiert werden sollen.
FROM-FILE = <filename 1..54>
Bezeichnet die Datei, die konvertiert werden soll. Die Angabe einer Dateigeneration ist zulässig.
FROM-FILE = *LINK(...)
Die zu konvertierende Datei wurde durch ein vorher eingegebenes /ADD-FILE-LINK spezifiziert, der dort angegebene Dateikettungsname muss mit dem hier angegebenen übereinstimmen.
LINK-NAME = <filename 1..8 without-gen>
Bezeichnet den Dateikettungsnamen.
FROM-FILE = <partial-filename 2..53 with-wild(79)>
Bedeutet, dass alle Dateien, die der angegebenen Wildcardsyntax und den spezifizierten Auswahlkriterien entsprechen, konvertiert werden sollen.
FROM-FILE = *ALL
Bedeutet, dass alle Dateien, die den spezifizierten Auswahlkriterien entsprechen, konvertiert werden sollen.
SELECT = *ALL / *BY-ATTRIBUTES(...)
Gibt an, ob die Dateien, die konvertiert werden sollen, zusätzlich zum teilqualifizierten Dateinamen über bestimmte Auswahlkriterien ausgewählt werden sollen.
SELECT = *ALL
Für die Quelldateien werden keine zusätzlichen Auswahlkriterien festgelegt.
SELECT = *BY-ATTRIBUTES(...)
Bestimmt die Auswahlkriterien für die zu konvertierenden Dateien.
CREATION-DATE = *ANY / *INTERVAL(...) / <date> / *TODAY / *YESTERDAY
Bezeichnet das Erstellungsdatum als Auswahlkriterium.
CREATION-DATE = *ANY
Das Erstellungsdatum wird nicht als Auswahlkriterium herangezogen. Alle Dateien werden bei der Auswahl berücksichtigt.
CREATION-DATE = INTERVAL(...)
Dateien mit Erstellungsdatum innerhalb des angegebenen Intervalls werden selektiert. Die Grenzwerte für das Intervall legen die Operanden FROM und TO fest.
FROM = 0000-01-01 / *YESTERDAY / <date>
Dateien mit Erstellungsdatum gleich oder später dem angegebenen Grenzwert werden selektiert.
FROM = 0000-01-01
Der untere Grenzwert ist das früheste mögliche Datum.
FROM = *YESTERDAY
Der untere Grenzwert ist das gestrige Tagesdatum. Dateien mit Erstellungsdatum >= dem gestrigen Tagesdatum werden selektiert.
FROM = <date>
Der untere Grenzwert ist das angegebene Datum. Dateien mit Erstellungsdatum >= dem angegebenen Wert werden selektiert.
TO = TODAY / *YESTERDAY / <date>
Dateien mit Erstellungsdatum gleich oder früher dem angegebenen Grenzwert werden selektiert.
TO = *TODAY
Der obere Grenzwert ist das aktuelle Tagesdatum. Dateien mit Erstellungsdatum <= dem aktuellen Tagesdatum werden selektiert.
TO = *YESTERDAY
Der obere Grenzwert ist das gestrige Tagesdatum. Dateien mit Erstellungsdatum <= dem gestrigen Tagesdatum werden selektiert.
TO = <date>
Der obere Grenzwert ist das angegebene Datum. Dateien mit Erstellungsdatum <= dem angegebenen Wert werden selektiert.
LAST-ACCESS-DATE = *ANY / *INTERVAL(...) / <date> / *TODAY / *YESTERDAY
Bezeichnet das Datum des letzten Dateizugriffs als Auswahlkriterium.
Erklärung der Operanden ANY, INTERVAL(...), <date>, TODAY und YESTERDAY siehe Operand CREATION-DATE.
SIZE = *ANY / <integer 0..16777215> / *INTERVAL(...)
Bezeichnet die Dateigröße als Auswahlkriterium.
SIZE = *ANY
Die Dateigröße wird nicht als Auswahlkriterium herangezogen.
SIZE = <integer 0..16777215>
Dateien mit einer Dateigröße gleich dem angegebenen Wert werden selektiert.
SIZE = *INTERVAL(...)
Dateien mit einer Dateigröße innerhalb des angegebenen Intervalls werden selektiert. Die Grenzwerte für das Intervall legen die Operanden FROM und TO fest.
FROM = 0 / <integer 0..16777215>
Dateien mit einer Dateigröße >= dem angegebenen Grenzwert werden selektiert.
FROM = 0
Der untere Grenzwert ist die kleinste mögliche Größe.
FROM = <integer 0..16777215>
Der untere Grenzwert ist die angegebene Größe.
TO = 16777215 / <integer 0..16777215>
Dateien mit einer Dateigröße <= dem angegebenen Grenzwert werden selektiert.
TO = 16777215
Der obere Grenzwert ist die größte mögliche Größe.
TO = <integer 0..16777215>
Der obere Grenzwert ist die angegebene Größe.
FILE-STRUCTURE = *ANY / list-poss(3): *SAM / *ISAM / *PAM
Bezeichnet die Zugriffsmethode als Auswahlkriterium.
FILE-STRUCTURE = *ANY
Die Zugriffsmethode wird nicht als Auswahlkriterium herangezogen.
FILE-STRUCTURE = *SAM
Dateien mit Zugriffsmethode SAM werden selektiert.
FILE-STRUCTURE = *ISAM
Dateien mit Zugriffsmethode ISAM werden selektiert.
FILE-STRUCTURE = *PAM
Dateien mit Zugriffsmethode PAM werden selektiert.
BLKSIZE = *ANY / <integer 1..16>
Bezeichnet die Blockgröße als Auswahlkriterium.
BLKSIZE = *ANY
Die Blockgröße wird nicht als Auswahlkriterium herangezogen.
BLKSIZE = <integer 1..16>
Dateien mit der Blockgröße gleich dem angegebenen Wert werden selektiert.
BLKCTRL = *ANY / *PAMKEY / *NO / *DATA / *DATA2K / *DATA4K
Bezeichnet die Blockkontrolleigenschaft als Auswahlkriterium.
BLKCTRL = *ANY
Die Blockkontrolleigenschaft wird nicht als Auswahlkriterium herangezogen.
BLKCTRL = *PAMKEY
Dateien mit der Blockkontrolleigenschaft PAMKEY werden selektiert.
BLKCTRL = *NO
Dateien mit der Blockkontrolleigenschaft NO werden selektiert.
BLKCTRL = *DATA
Dateien mit der Blockkontrolleigenschaft DATA werden selektiert.
BLKCTRL = *DATA2K
Dateien mit der Blockkontrolleigenschaft DATA2K werden selektiert.
BLKCTRL = *DATA4K
Dateien mit der Blockkontrolleigenschaft DATA4K werden selektiert.
TO-FILE = <filename 1..54> / *LINK(...) / <partial-filename 2..53 with-wild(79)>
Bezeichnet die Dateien, die durch die Konvertierung erzeugt werden sollen.
TO-FILE = <filename 1..54>
Bezeichnet die Datei, die durch die Konvertierung erzeugt werden soll. Die Angabe einer Dateigeneration ist zulässig.
TO-FILE = *LINK(...)
Die zu erzeugende Datei wurde durch ein vorher eingegebenes /ADD-FILE-LINK spezifiziert, der dort angegebene Dateikettungsname muss mit dem hier angegebenen übereinstimmen.
LINK-NAME = <filename 1..8 without-gen>
Bezeichnet den Dateikettungsnamen.
TO-FILE = <partial-filename 2..53 with-wild(79)>
Bezeichnet die Dateien, die durch die Konvertierung erzeugt werden sollen, teilqualifiziert mit Wildcardsyntax.
TO-FILE-BLKSIZE = *STD / *NK4 / <integer 1..16>
Bezeichnet die logische Blockgröße der Zieldatei.
TO-FILE-BLKSIZE = *STD
Die logische Blockgröße der Zieldatei wird nicht vom Benutzer definiert. PAMCONV richtet sich nach den Gegebenheiten des Ziel-Pubsets und setzt, wenn notwendig, den Blockungsfaktor herauf. Es wird intern maximal um eins heraufgeblockt.
TO-FILE-BLKSIZE = *NK4
Die logische Blockgröße der Zieldatei wird so gesteuert, dass sie auf jeden Fall geradzahlig ist, d.h. die Zieldatei kann auf einem NK4-Pubset abgelegt werden. Es wird intern maximal um eins heraufgeblockt.
TO-FILE-BLKSIZE = <integer 1..16>
Die Zieldatei wird mit der Blockgröße gleich dem angegebenen Wert erzeugt, wenn die Angabe mit den übrigen Bedingungen der Umblockung verträglich ist (siehe Abschnitt „Umblockung“).
TO-FILE-BLKCTRL = *STD / *NK4
Bezeichnet die Blockkontroll-Information der Zieldatei. Dieser Operand ist nur für die Konvertierungsrichtung TO-NONKEY und ausschließlich für ISAM-Dateien relevant.
TO-FILE-BLKCTRL = *STD
Die Blockkontroll-Information wird entsprechend dem Zielpubset gesetzt. Bei NK2-Pubsets wird das Datenformat mit DATA2K, bei NK4-Pubsets mit DATA4K festgelegt.
TO-FILE-BLKCTRL = *NK4
Die Blockkontroll-Information erhält den Wert DATA4K.
REPLACE-OLD-FILES = *NO / *YES / *DIALOG
Gibt an, ob unter diesem Namen bereits existierende Dateien überschrieben werden sollen.
REPLACE-OLD-FILES = *NO
Dateien sollen nicht überschrieben werden, die Konvertierung dieser Datei wird nicht durchgeführt.
REPLACE-OLD-FILES = *YES
Dateien sollen in jedem Fall überschrieben werden, sofern nicht ein zusätzlicher Schutz (Passwort, ACCESS=*READ,..) vorhanden ist.
REPLACE-OLD-FILES = *DIALOG
Der Benutzer wird im Dialog aufgefordert, die Verfahrensweise für bereits existierende Dateien zu bestimmen. Nur im Dialogbetrieb möglich.
FILE-DISPOSAL = *KEEP / *RENAME / *REPLACE / *INPLACE
Gibt an, wie mit der Quell- und Zieldatei nach der Konvertierung verfahren werden soll.
FILE-DISPOSAL = *KEEP
Die Zieldateien sollen mit den Namen erzeugt werden, die für sie in der Konvertierungsanweisung angegeben sind. Die Zieldateien existieren neben den Quelldateien.
FILE-DISPOSAL = *RENAME
Die Zieldateien sollen mit den Namen erzeugt werden, die für sie in der Konvertierungsanweisung angegeben sind. Nach erfolgreicher Konvertierung sollen die Quelldateien gelöscht werden.
FILE-DISPOSAL = *REPLACE
Die Zieldateien sollen mit den Namen erzeugt werden, die für sie in der Konvertierungsanweisung angegeben sind. Nach erfolgreicher Konvertierung sollen die Quelldateien gelöscht werden und die Zieldateien die Namen der Quelldateien erhalten. Effektiv wird die Quelldatei durch die Zieldatei ersetzt.
FILE-DISPOSAL = *INPLACE
Die Zieldateien sollen mit den Namen erzeugt werden, die für sie in der Konvertierungsanweisung angegeben sind. Nach erfolgreicher Konvertierung soll versucht werden, die Quelldatei mit der Zieldatei zu überschreiben und der Zieldatei den Namen der Quelldatei zu geben. Dies bewirkt, dass die Zieldatei auch physikalisch in etwa den gleichen Platz wie die Quelldatei einnimmt. Effektiv wird die Quelldatei durch die Zieldatei ersetzt.
PROTECTION = *STD / *SAME
Gibt an, ob die Dateischutzattribute der Quelldatei in die Zieldatei übernommen werden sollen.
PROTECTION = *STD
Die Dateischutzattribute werden nicht übernommen.
PROTECTION = *SAME
Die Dateischutzattribute werden in die Zieldatei übernommen. Näheres siehe Abschnitt „Übernahme der Dateischutzattribute nach der Konvertierung“ (Besonderheiten bei der Konvertierung).
DEVICE-FOR-TEMPFILE = *NONE / *TAPE(...) / *DISK(...)
Bezeichnet das Speichermedium, auf dem die erzeugte Zwischendatei abgelegt werden soll.
DEVICE-FOR-TEMPFILE = *NONE
Es soll keine Zwischendatei auf einem privaten Datenträger abgelegt werden.
DEVICE-FOR-TEMPFILE = *TAPE(...)
Die erzeugte Zwischendatei soll auf Magnetband ablegt werden.
VOLUME = list-poss(100): <alphanum-name 1..6>
Bezeichnet die VSN des Bandes bzw. der Bänder, falls mehrere VSNs in Form einer Liste angegeben werden, das bzw. die als Speichermedium dienen soll(en).
DEVICE-TYPE = <device>
Bezeichnet den Bandgerätetyp, der verwendet werden soll.
DEVICE-FOR-TEMPFILE = *DISK(...)
Die erzeugte Zwischendatei soll auf einer Privatplatte abgelegt werden.
VOLUME = list-poss(100): <alphanum-name 1..6>
Bezeichnet die VSN der Privatplatte bzw. der Platten, falls mehrere VSNs in Form einer Liste angegeben werden, die als Speichermedium dienen soll(en).
DEVICE-TYPE = <device>
Bezeichnet den Plattengerätetyp, der verwendet werden soll.