CLASSIFY-FILE - Classify files according to their convertibility

On each selected file, information as to its convertibility and any incompatibilities is requested.

The default values set via the MODIFY-CONVERT-FILE-DEFAULTS statement are not taken into account here.The results of the CLASSIFY-FILE statement indicate the convertibility of a source file. For similar information on the target file, see the section “Reblocking”.

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

Operands

DIRECTION = *TO-NONKEY / *NONKEY-TO-KEY
Designates the user-defined direction of file conversion. This must be specified here because it influences the classification type.

DIRECTION = *TO-NONKEY
Files are to be converted to NK format.

DIRECTION = *NONKEY-TO-KEY
Files are to be converted from NK to K format.

FROM-FILE = <filename 1..54> / *LINK(...) / <partial-name 2..79 with-wild> / *ALL
Defines the files to be checked.

FROM-FILE = <filename 1..54>
Designates the fully qualified file name. Specification of a file generation is possible.

FROM-FILE = *LINK(...)
Identifies the files via a link name.

LINK-NAME = <filename 1..8 without-gen>
Specifies the link name.

FROM-FILE = <partial-filename 2..53 with-wild(79)>
Identifies the partially qualified file name with wildcard syntax.

FROM-FILE = *ALL
All files of the user ID are to be checked.

SELECT = *ALL / *BY-ATTRIBUTES(...)
Specifies whether the files to be classified are selected via specific selection criteria in addition to the partially qualified file name.

SELECT = *ALL
No additional selection criteria are specified for the source files.

SELECT = *BY-ATTRIBUTES(...)
Defines the selection criteria for the files to be classified.

CREATION-DATE = *ANY / *INTERVAL(...) / <date> / *TODAY / *YESTERDAY
Designates the creation date as a selection criterion.

CREATION-DATE = *ANY
The creation date is not used as a selection criterion. All files are taken into account for selection.

CREATION-DATE = *INTERVAL(...)
Files with a creation date within the specified interval are selected. The range limits are defined by the FROM and TO operands.

FROM = 0000-01-01 / *YESTERDAY / <date>
Files with a creation date equal to or later than the specified limit are selected.

FROM = 0000-01-01
The lower limit is the earliest possible date.

FROM = *YESTERDAY
The lower limit is yesterday’s date. Files with a creation date ≥ yesterday’s date are selected.

FROM = <date>
The lower limit is the specified date. Files with a creation date ≥ the specified value are selected.

TO = *TODAY / *YESTERDAY / <date>
Files with a creation date equal to or earlier than the specified limit are selected.

TO = *TODAY
The upper limit is the current date. Files with a creation date ≤ the current date are selected.

TO = *YESTERDAY
The upper limit is yesterday’s date. Files with a creation date ≤ yesterday’s date are selected.

TO = <date>
The upper limit is the specified date. Files with a creation date ≤ the specified value are selected.

LAST-ACCESS-DATE = *ANY / *INTERVAL(...) / <date> / *TODAY / *YESTERDAY
Designates the date of the last file access as a selection criterion.

For the meaning of ANY, INTERVAL(...), <date>, TODAY and YESTERDAY see the CREATION-DATE operand.

SIZE = *ANY / <integer 0..16777215> / *INTERVAL(...)
Designates the file size as a selection criterion.

SIZE = *ANY
The file size is not used as a selection criterion.

SIZE = <integer 0..16777215>
Files with a size equal to the specified value are selected.

SIZE = *INTERVAL(...)
Files with a size within the specified range are selected. The range limits are defined by the FROM and TO operands.

FROM = 0 / <integer 0..16777215>
Files with a size ≥ the specified limit are selected.

FROM = 0
The lower limit is the absolute minimum.

FROM = <integer 0..16777215>
The lower limit is the specified size.

TO = 16777215 / <integer 0..16777215>
Files with a size ≤ the specified limit are selected.

TO = 16777215
The upper limit is the absolute maximum.

TO = <integer 0..16777215>
The upper limit is the specified size.

FILE-STRUCTURE = *ANY / list-poss(3): *SAM / *ISAM / *PAM
Designates the access method as a selection criterion.

FILE-STRUCTURE = *ANY
The access method is not used as a selection criterion.

FILE-STRUCTURE = *SAM
Files with the SAM access method are selected.

FILE-STRUCTURE = *ISAM
Files with the ISAM access method are selected.

FILE-STRUCTURE = *PAM
Files with the PAM access method are selected.

BLKSIZE = *ANY / <integer 1..16>
Designates the block size as a selection criterion.

BLKSIZE = *ANY
The block size is not used as a selection criterion.

BLKSIZE = <integer 1..16>
Files with a block size equal to the specified value are selected.

BLKCTRL = *ANY / *PAMKEY / *NO / *DATA / *DATA2K / *DATA4K
Designates the block control attribute as a selection criterion.

BLKCTRL = *ANY
The block control attribute is not used as a selection criterion.

BLKCTRL = *PAMKEY
Files with the block control attribute PAMKEY are selected.

BLKCTRL = *NO
Files with the block control attribute NO are selected.

BLKCTRL = *DATA
Files with the block control attribute DATA are selected.

BLKCTRL = *DATA2K
Files with the block control attribute DATA2K are selected.

BLKCTRL = *DATA4K
Files with the block control attribute DATA4K are selected.

The output destination is determined by the OUTPUT operand of the MODIFY-LOGGING-OPTIONS statement.

The results of the check are output to SYSLST in the following form (line length up to 132 characters):

%//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

 

The results of the check are output to SYSOUT in the following form (line length up to 80 characters):

% 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

Meanings of the output fields:

>from-file<

File names specified in the CLASSIFY-FILE statement.

>direction<

Conversion direction specified in the CLASSIFY-FILE statement

>filename<

Name of the file checked

>size<

Size of the file checked

>fcb<

FCB type of the file checked

>n<

Total number of files checked

>yesno<

File convertibility information. Possible values:

YES	File is convertible.
NO	File is not convertible.
NK2	File is only convertible on NK2 pubsets with standard blksize (PLAM libraries).
NK4 ...	File is only convertible on NK2 pubsets (e.g. SAM files with BLKSIZE=RECSIZE and standard blksize).

>reason<

Reason for incompatibility. Possible values:

NONE

No incompatibilities, file is convertible.

RECSIZE EXCEEDS MAXIMUM

The record length exceeds the maximum value determined by BLKSIZE. The file can be converted by increasing the blocking factor.

RECSIZE EXCEEDS MAX(NK2)

The record length would exceed the maximum value determined by BLKSIZE on NK2 pubsets. It is possible to convert to NK4 pubsets.

PLAM(NK4) NO CONVERT

PLAM libraries with BLKSIZE > 2 are not converted with PAMCONV.

FILE ALREADY IN KEY-FORMAT

The file is already in K format. The file in K format cannot be converted to K format.

FILESIZE INCREASES

The formation of overflow blocks increases the size of the target file, the file is convertible.

KEYPOS IN OVERFLOW-BLOCK

The ISAM key would have to be stored in an overflow block. The file can be converted by increasing the blocking factor.

LMR-LIBRARY

File is an LMR library, i.e. it is not convertible.

PAMKEY IS USED

The file makes use of the user part of the PAM key, file is not convertible

PAMKEY CONTAINS SPECIAL FLAG

The file contains X'01' or X'80' only in byte 1 of the user part of the PAM key. The file is convertible.