File header labels (HDR1 through HDR9)

Each file or file section contains at least two file header labels (HDR1 and HDR2) and at most nine. File header labels HDR3 through HDR9 are optional.

First file header label (HDR1)

The first file header label identifies a file section, describes its location within the file set and defines certain attributes of the file section.

Format

Position	Field name	Length	Contents
1 – 3	Label identifier	3	HDR
4	Label number	1	1
5 – 21	File name	17	“a” characters; identifies the file.
22 – 27	File set identifier	6	“a” characters; identifies the file set to which this file belongs.
28 – 31	File section number	4	“n” characters; identifies the file section. The number of the first file section in a file is 0001. This number is incremented by one for every subsequent file section in this file.
32 – 35	File sequence number	4	“n” characters; identifies the file in the file set. The file sequence number of the first file in a file set is 0001. This number is incremented by one for each subsequent file in this file set. This field must contain the same number in all the labels of a specific file, regardless of whether the file is contained on one or more volumes.
36 – 39	Generation number	4	“n” characters; distinguishes the successive extensions/updates of the file from 0001 through 9999.
40 – 41	Version number	2	“n” characters; distinguishes the successive repetitions of a generation.
42 – 47	Creation date	6	Spaces or “n” characters; specifies the creation date of the file section. A space indicates the 20th century; the digit 0 indicates the 21st century, followed by two “n” characters (00 – 99) indicating the year within the century, followed by three “n” characters (001 – 366) indicating the day of the year. The value 00000 in the last five places indicates that the creation date is irrelevant.
48 – 53	Expiration date	6	Spaces or “n” characters; specifies the earliest date on which the file section may be deleted. The format is the same as for the “creation date” field (positions 42 – 47). The value 00000 in the last five places indicates that the expiration date is irrelevant and that the file section is obsolete.
54	File access indicator	1	“a” characters; indicates restrictions with regard to access to data in this file. A space indicates that there are no restrictions with regard to accessing the file. Any other “a” character indicates that there are special restrictions governing access to the file. BS2000: “1” or “3”: tape or file owner has access authorization.
55 – 60	Block count	6	000000
61 – 73 61 – 65 66 – 73	System code	13 5 - 8	“a” characters; identifies the implementation responsible for creating the labels. BS2000: BS2000 Spaces
74 – 80	Reserved for later standardization	7	Spaces

Second file header label (HDR2)

The second file header label describes certain attributes of the file and of the implementation.

Format

Position	Field name	Length	Contents
1 – 3	Label identifier	3	HDR
4	Label number	1	2
5	Record format	1	F, D or S, and V and U (not supported according to DIN); specifies the format of the records in the file. F: all the records in the file have a fixed record length. D: all the records in the file have a variable record length and the number of characters (as a decimal) is specified in the record itself. S: all the records are segmented. V: all the records have an undefined length (not supported according to DIN). U: all the records are variable in length and the number of characters (in binary form) is specified in the record itself (not supported according to DIN).
		1
6 – 10	Block length	5	n” characters; specifies the maximum number of characters per block in the file. BS2000: With standard identifier 1 the following contents are possible:
6 – 7	Standard blocks		'80': standard block identifier.
8 – 10			n” characters: specifies the number of standard blocks.
11 – 15	Record length	5	“n” characters; identifies the record length in conjunction with the record format (position 5). With record format F this field contains the actual record length. With record formats D and V this field contains the maximum length, including the record length word (RLW). With record format S this field contains the maximum record length, excluding the segment control words (SCW). If this field contains 00000 with record format S, it means that the record length may be greater than 99999. With record format U, this field contains the maximum number of characters that may be contained in one record.
16 – 50	Reserved for the implementation	35	There are no conventions or restrictions with regard to the recording and contents of this field. BS2000 assignments up to support of DIN level 4:
16	Recording density	1	0 200 Bpi 1 556 Bpi 2 800 Bpi 3 1600 Bpi 4 6250 Bpi
17	Data position	1	Indicator in the case of track swapping: 0 no 1 yes
18 – 34	Job step identifier	17	ID assigned by task management.
35 – 36	Recording density for tape cartridges	2	' 'BLANK''BLANK'' not compressed ' P'BLANK'' compressed
47 – 50	File name code	4	Used only up to DIN 66029-1 if positions 6 and 7 contain standard blocks.
51 – 52	Buffer displacement	2	“n” characters; specifies the length (in characters) of an additional field that is placed at the beginning of each block.
53 – 80	Reserved for future standardization	28	Spaces

The file header label (HDR3)

The HDR3 label contains the complete file name, the passwords and the access mode relevant for the file owner.

Format

Position	Field name	Length	Contents
1 – 3	Label identifier	3	HDR
4	Label number	1	3
5 – 12	Owner identifier	8	Identifies the owner of the file (user ID).
13 – 56	File name	44	The first 44 characters of the name of the file or file generation to which the file belongs.
57 – 60	Read password	4	Specifies a password governing read access to the file.
61 – 64	Write password	4	Specifies a password governing read and write access to the file.
65 – 68	Execute password	4	Specifies a password that must be entered in order to execute a load module contained in the file.
69	Access mode	1	Specifies the valid access mode: 0 : read and write access permitted. 1 : only read access permitted.
70 – 80	Reserved	11	Spaces.

Optional file header labels (HDR4 through HDR9)

The other file header labels are optional and contain implementation-specific information.

Format

Position	Field name	Length	Contents
1 – 3	Label identifier	3	HDR
4	Label number	1	Digits 4 through 9.
5 – 80	Reserved for the implementation	76	There are no conventions or restrictions with regard to the recording or contents of this field.