CHECK-BLKCTRL-INDICATOR - Check file format consistency and BLKCTRL indicator

This statement checks the file format entered in the BLKCTRL indicator of the catalog against the actual file format (no longer necessary in the current BS2000 versions). It also informs the user as to whether the file is in K-PAM or NK-PAM format.

The default values set via the MODIFY-CONVERT-FILE-DEFAULTS statement are not taken into account here.

Format

CHECK-BLKCTRL-INDICATOR                                                                                                                      

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> / *TODAY / *YESTERDAY
		|	,LAST-ACCESS-DATE = *ANY / <date> / *TODAY / *YESTERDAY / *INTERVAL(...)
		|		*INTERVAL(...)
		|			|	FROM = 0000-01-01 / <date> / *YESTERDAY
		|			|	,TO = *TODAY / <date> / *TODAY / *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

FROM-FILE = <filename 1..54> / *LINK(...) / <partial-filename 2..53 with-wild(79)> / *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 checked are selected via specific selection criteria in addition to the partially qualified file name.

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

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

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 checked. 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 checked.

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 checked.

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

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

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

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

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

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 checked.

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

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

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 checked.

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 checked.

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

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

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 checked.

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 checked.

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

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

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

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

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

Output of the results to SYSLST

A maximum of 132 characters per line is output.

%//CHECK-BLKCTRL-INDICATOR FROM-FILE=>from-file<
% CHECK-BLKCTRL-INDICATOR >from-file<
%
% FILENAME                                           ! FOR-   !          BLKCTRL-INDICATOR        !
%                                                    ! MAT    ! IN CATALOG ! SHOULD BE ! COMPARE  !
% -------------------------------------------------------------------------------------------------
% :CATID:$USERID.>filename 1<....................... !>format<! >catalog<  ! >should<  ! >compare<!
% :CATID:$USERID.>filename 2<....................... !>format<! >catalog<  ! >should<  ! >compare<!
% :CATID:$USERID.>filename 3<....................... !>format<! >catalog<  ! >should<  ! >compare<!
%
%
% :CATID:$USERID.>filename n<....................... !>format<! >catalog<  ! >should<  ! >compare<!
% -------------------------------------------------------------------------------------------------
%            >n<         FILE(S) LISTED

 

Output of the results to SYSOUT

A maximum of 80 characters per line is output.

%//CHECK-BLKCTRL-INDICATOR FROM-FILE=>from-file<
% CHECK-BLKCTRL-INDICATOR >from-file<
% 
% FILENAME                                              ! FOR-   !  BLKCTRL !
%                                                       ! MAT    !  COMPARE !
% ---------------------------------------------------------------------------
% :CATID:$USERID.>filename 1<...........................!>format<! >compare<!
% :CATID:$USERID.>filename 2<...........................!>format<! >compare<!
% :CATID:$USERID.>filename 3<...........................!>format<! >compare<!
%
%
% :CATID:$USERID.>filename n<...........................!>format<! >compare<!
% ---------------------------------------------------------------------------
%           >n<         FILE(S) LISTED

Meanings of the output fields:

>from-file<

File names specified in the CHECK-BLKCTRL-INDICATOR statement

>filename<         

Name of the file checked

>n<

Total number of files checked

>format<

K ... File has format with PAM key.
NK ... File has format without PAM key

>catalog<

Value of BLKCTRL indicator in catalog entry. Possible values:

*NONE	No BLKCTRL indicator in the catalog entry (file still empty).
PAMKEY	The BLKCTRL indicator in the catalog entry has the value PAMKEY.
DATA	The BLKCTRL indicator from the catalog entry has the value DATA.
DATA2K	The BLKCTRL indicator in the catalog entry has the value DATA2K.
DATA4K	The BLKCTRL indicator in the catalog entry has the value DATA4K.
NO	The BLKCTRL indicator in the catalog entry has the value NO.

>should<

BLKCTRL indicator value the file ought to have in accordance with the file structure.
Possible values:

PAMKEY	The BLKCTRL indicator in the catalog entry should have the valuePAMKEY.
DATA	The BLKCTRL indicator from the catalog entry should have the value DATA.
DATA2K	The BLKCTRL indicator in the catalog entry should have the value DATA2K.
DATA4K	The BLKCTRL indicator in the catalog entry should have the value DATA4K.
NO	The BLKCTRL indicator in the catalog entry should have the value NO.

>compare<

Value comparison, possible values:

SAME	The BLKCTRL indicator in the catalog entry corresponds to that of the actual file structure.
DIFFERENT	The BLKCTRL indicator in the catalog entry does not correspond to that of the actual file structure.