CLASSIFY-FILE - Dateien nach Konvertierbarkeit klassifizieren

Es werden zu jeder ausgewählten Datei Aussagen angefordert darüber, ob sie konvertierbar ist und ob sich Inkompatibilitäten ergeben.

Die durch die Anweisung MODIFY-CONVERT-FILE-DEFAULTS eingestellten Standardwerte werden bei dieser Anweisung nicht berücksichtigt. Das Ergebnis der Anweisung CLASSIFY-FILE beschreibt die Konvertierbarkeit einer Quelldatei. Für Aussagen zur Zieldatei muss der Abschnitt „Umblockung“ berücksichtigt werden.

Format

CLASSIFY-FILE                                                                                                                                             

DIRECTION = *TO-NONKEY / *NONKEY-TO-KEY
,FROM-FILE = *LINK(...) / *ALL / <partial-filename 2..53 with-wild(79)> / <filename 1..54>
	*LINK(...)
		|	LINK-NAME = <filename 1..8 without-gen>
,SELECT = *ALL / *BY-ATTRIBUTES(...)
	BY-ATTRIBUTES(...)
		|	CREATION-DATE = *ANY / <date> / *TODAY / *YESTERDAY / *INTERVAL(...)
		|		*INTERVAL(...)
		|			|	FROM = 0000-01-01 / <date> / *YESTERDAY
		|			|	,TO = *TODAY / <date> / *YESTERDAY
		|	,LAST-ACCESS-DATE = *ANY / <date> / *TODAY / *YESTERDAY / *INTERVAL(...)
		|		*INTERVAL(...)
		|			|	FROM = 0000-01-01 / <date> / *YESTERDAY
		|			|	,TO = *TODAY / <date> / *YESTERDAY
		|	,SIZE = *ANY / <integer 0..16777215> / *INTERVAL(...)
		|		*INTERVAL(...)
		|			|	FROM = 0 / <integer 0..16777215>
		|			|	,TO = 16777215 / <integer 0..16777215>
		|	,FILE-STRUCTURE = *ANY / list-poss(3): *SAM / *ISAM / *PAM
		|	,BLKSIZE = *ANY / <integer 1..16>
		|	,BLKCTRL = *ANY / *PAMKEY / *NO / *DATA / *DATA2K / *DATA4K

Operanden

DIRECTION = *TO-NONKEY / *NONKEY-TO-KEY
Bezeichnet die Richtung der Dateikonvertierung, die vom Anwender vorgesehen ist. Da die Einteilung je nach Konvertierungsrichtung unterschiedlich ist, ist diese hier zu spezifizieren.

DIRECTION = *TO-NONKEY
Die Konvertierung von Dateien soll ins NK-Format erfolgen.

DIRECTION = *NONKEY-TO-KEY
Die Konvertierung von Dateien soll vom NK-Format ins K-Format erfolgen.

FROM-FILE = <filename 1..54> / *LINK(...) / <partial-name 2..79 with-wild> / *ALL
Bezeichnet die Dateien, die geprüft werden sollen.

FROM-FILE = <filename 1..54>
Bezeichnet den vollqualifizierten Dateinamen. Die Angabe einer Dateigeneration ist zulässig.

FROM-FILE = *LINK(...)
Bezeichnet die Dateien über einen Dateikettungsnamen.

LINK-NAME = <filename 1..8 without-gen>
Bezeichnet den Dateikettungsnamen.

FROM-FILE = <partial-filename 2..53 with-wild(79)>
Bezeichnet den teilqualifizierten Dateinamen mit Wildcardsyntax.

FROM-FILE = *ALL
Alle Dateien der Benutzerkennung sollen geprüft werden.

SELECT = *ALL / *BY-ATTRIBUTES(...)
Gibt an, ob die Dateien, die klassifiziert werden sollen, über bestimmte Auswahlkriterien zusätzlich zum teilqualifizierten Dateinamen ausgewählt werden sollen.

SELECT = *ALL
Für die Quelldateien werden keine zusätzlichen Auswahlkriterien getroffen.

SELECT = *BY-ATTRIBUTES(...)
Bestimmt die Auswahlkriterien für die zu klassifizierenden 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.

Das Ausgabeziel wird durch den Operanden OUTPUT der Anweisung MODIFY-LOGGING-OPTIONS bestimmt.

Die Prüfergebnisse werden in folgender Form nach SYSLST ausgegeben (Zeilenlänge max. 132 Zeichen):

%//CLASSIFY-FILE   FROM-FILE=>from-file<
% CLASSIFY-FILE    >from-file<    DIRECTION = >direction<
%
% FILENAME                                          !  PAM-  !FCB- !CONVER-!  INCOMPATIBILITIES  !
%                                                   !  PAGES !TYPE !TIBLE  !                     !
% ------------------------------------------------------------------------------------------------
% :CATID:$USERID.>filename 1< ..................... ! >size< !>fcb<!>yesno<!      >reason<       !
% :CATID:$USERID.>filename 2< ..................... ! >size< !>fcb<!>yesno<!      >reason<       !
% :CATID:$USERID.>filename 3< ..................... ! >size< !>fcb<!>yesno<!      >reason<       !
%                                                   !        !     !       !                     !
%                                                   !        !     !       !                     !
% :CATID:$USERID.>filename n< ..................... ! >size< !>fcb<!>yesno<!      >reason<       !
% ------------------------------------------------------------------------------------------------
%            >n<       FILE(S) LISTED

Die Prüfergebnisse werden in folgender Form nach SYSOUT ausgegeben (Zeilenlänge max. 80 Zeichen):

% CLASSIFY-FILE   FROM-FILE=>from-file<
% CLASSIFY-FILE   >from-file<    DIRECTION = >direction<
%
% FILENAME                                                      ! CONVER- !
%                                                               ! TIBLE   !
% -------------------------------------------------------------------------
% :CATID:$USERID.>filename 1< ................................  ! >yesno< !
% :CATID:$USERID.>filename 2< ................................  ! >yesno< !
% :CATID:$USERID.>filename 3< ................................  ! >yesno< !
%
%
% :CATID:$USERID.>filename n< ................................  ! >yesno< !
% -------------------------------------------------------------------------
%            >n<       FILE(S) LISTED

Bedeutung der Ausgabefelder:

>from-file<

In der Anweisung CLASSIFY-FILE angegebene Dateinamen.

>direction<    

In der Anweisung CLASSIFY-FILE angegebene vorgesehene Konvertierungsrichtung

>filename<

Dateiname der geprüften Datei

>size<

Größe der geprüften Datei

>fcb<

FCB-Typ der geprüften Datei

>n<

Gesamtzahl der geprüften Dateien

>yesno<

Aussage, ob die Datei konvertierbar ist. Mögliche Werte:

YES	Datei ist konvertierbar.
NO	Datei ist nicht konvertierbar.
NK2	Datei ist nur auf NK2-Pubsets mit Standard-Blksize konvertierbar (PLAM-Bibliotheken).
NK4 ...	Datei ist nur auf NK4-Pubsets konvertierbar (z.B. SAM-Dateien mit BLKSIZE=RECSIZE und Standard-Blksize).

>reason<

Grund der Inkompatibilität. Mögliche Werte:

NONE

keine Inkompatibilitäten, Datei ist konvertierbar.

RECSIZE EXCEEDS MAXIMUM

Die Satzlänge überschreitet den durch BLKSIZE bestimmten Maximalwert. Die Datei kann durch Heraufsetzen des Blockungsfaktors konvertiert werden.

RECSIZE EXCEEDS MAX(NK2)

Die Satzlänge würde auf NK2-Pubsets den durch BLKSIZE bestimmten Maximalwert überschreiten. Eine Konvertierung auf NK4-Pubsets ist möglich.

PLAM(NK4) NO KONVERT

PLAM-Bibliotheken mit BLKSIZE > 2 werden von PAMCONV nicht konvertiert.

FILE ALREADY IN KEY-FORMAT

Die Datei liegt bereits im K-Format vor. Die Datei im K-Format kann nicht ins K-Format konvertiert werden.

FILESIZE INCREASES

Durch die Bildung von OVERFLOW-Blöcken wird die Zieldatei größer, Datei ist konvertierbar.

KEYPOS IN OVERFLOW-BLOCK

Der ISAM-Schlüssel würde in einem OVERFLOW-Block abgelegt werden müssen. Die Datei kann durch Heraufsetzen des Blockungsfaktors konvertiert werden.

LMR-LIBRARY

Datei ist eine LMR-Bibliothek, sie ist nicht konvertierbar.

PAMKEY IS USED

Datei verwendet den Userteil des PAM-Schlüssels, Datei ist nicht konvertierbar.

PAMKEY CONTAINS SPECIAL FLAG

Datei enthält im ersten Byte des Userteils vom PAM-Schlüssel nur das Zeichen X'01' oder X'80'. Die Datei ist konvertierbar.