BACKUP-SYSTEM: Difference between revisions

From NDWiki
Jump to navigation Jump to search
(→‎Labels: add subsections)
Line 46: Line 46:


=== Labels ===
=== Labels ===
==== Volume header label ====
                     VOLUME HEADER LABEL
                     VOLUME HEADER LABEL
  POSITION FIELD NAME                LENGTH CONTENTS
  POSITION FIELD NAME                LENGTH CONTENTS
Line 62: Line 64:
- These fields may contain any alphanumeric characters. If the field is not fully filled with characters, the last character in the string is an apostrophe. This character is used to mark the end of the string and is not part of the name. The unused part of such a field is filled with spaces.
- These fields may contain any alphanumeric characters. If the field is not fully filled with characters, the last character in the string is an apostrophe. This character is used to mark the end of the string and is not part of the name. The unused part of such a field is filled with spaces.


==== First file header label ====
                 FIRST FILE HEADER LABEL
                 FIRST FILE HEADER LABEL
  POSITION FIELD  NAME                    LENGTH CONTENTS
  POSITION FIELD  NAME                    LENGTH CONTENTS
Line 99: Line 102:
- Creation and expiration dates are not used,  and the fields will contain spaces.
- Creation and expiration dates are not used,  and the fields will contain spaces.


==== Second file header label ====
       SECOND FILE HEADER LABEL
       SECOND FILE HEADER LABEL
  POSITION FIELD NAME              LENGTH CONTENTS
  POSITION FIELD NAME              LENGTH CONTENTS
Line 117: Line 121:
- 32-41 contains the MAX BYTE POINTER of the file.
- 32-41 contains the MAX BYTE POINTER of the file.


==== End of file label ====
                 END OF FILE LABEL
                 END OF FILE LABEL
  POSITION FIELD  NAME                LENGTH CONTENTS
  POSITION FIELD  NAME                LENGTH CONTENTS
Line 125: Line 130:
  61-80    13-14  (not used)            20    (spaces)
  61-80    13-14  (not used)            20    (spaces)


==== End of volume label ====
                 END OF VOLUME LABEL
                 END OF VOLUME LABEL
  POSITION FIELD  NAME                LENGTH CONTENTS
  POSITION FIELD  NAME                LENGTH CONTENTS
Line 130: Line 136:
  4-80    2-14  same as EOF1        77    (corresponds to EOF1)
  4-80    2-14  same as EOF1        77    (corresponds to EOF1)


==== User label ====
                       USER LABEL
                       USER LABEL
  POSITION FIELD  NAME                LENGTH CONTENTS                                   
  POSITION FIELD  NAME                LENGTH CONTENTS                                   
Line 149: Line 156:
  13-76        17-80              SINTRAN III file system object entry
  13-76        17-80              SINTRAN III file system object entry


==== Nonstandard 'Hole' label ====
         NONSTANDARD 'HOLE' LABEL
         NONSTANDARD 'HOLE' LABEL
  POSITION FIELD    NAME            LENGTH CONTENTS
  POSITION FIELD    NAME            LENGTH CONTENTS

Revision as of 14:58, 18 May 2020

The BACKUP-SYSTEM offers a variety of facilities for copying files to and from disks, floppy disks, and magnetic tapes. Files stored on remote computer systems may also be copied.

The files may be copied for archiving, backup, or other purposes. To enable communication with other computer installations, the ANSI standard label format is available for magnetic tapes.

Entering commands to the BACKUP-SYSTEM is easy, but slightly different from SINTRAN III. Some commands have subcommands, i.e., the parameter sequence is not solely determined by the first command entered. Online help information is available for every prompted command, subcommand or parameter at all levels of communication.

The old SINTRAN III commands @COPY-USERS-FILES, @CREATE-VOLUME and @LIST-VOLUME are now available under the BACKUP-SYSTEM. The commands have some extended and altered facilities.

The BACKUP-SYSTEM can handle files produced under older versions of SINTRAN III[1].

Label format on magnetic tape volumes

Implementation of magnetic tape volumes is based upon the American National Standard Magnetic Tape Labels for Information Interchange X3.27-1969.

However, some deviations from the standard have been made. Deviations are marked by a dollar sign ($) in the explanation.

General rules:

- The general tape layout is as follows:

                VOL1 HDR1 HDR2 UHL1*-file-*EOF1
                                *HDR1 HDR2 UHL1*-file2- * ( EOF1 OR EOV1 ) **

where VOL1,HDR1,HDR2,UHL1, EOF1, and EOV1 are tape labels, and asterisks are tape marks.

- All labels are 0 character blocks.

- All information in the labels is recorded as ASCII characters with the parity bit cleared. All unused character positions will contain spaces. $ The user option field (3) in the label UHL1 contains binary information.

- File data is recorded as 204 character blocks. These blocks may contain any character (0-255).

$$$$ Deviation From Standard

- Only the first file on a volume may be extended to other volumes.

A nonstandard label, HOLE, has been introduced. This label can be inserted between the file data blocks. The important information in this label is a 32-bit binary number contained in characters 77-80 of the label. The BACKUP-SYSTEM uses this number in the following way:

Each 2048 character block on the tape corresponds to a 1024 16-bit word block on the disk, referred to as a page. The pages are numbered O, 1, 2, 3, etc., to establish a logical sequence of pages. If the logical sequences are not continuous, then a HOLE label defines where the next block on the magnetic tape logically belongs in the disk file. In order to represent a logical HOLE on the magnetic tape, the HOLE label will be inserted in front of the next block, stating this block's logical number. Blocks of 2048 characters without a HOLE label are expected to belong to a continuous logical area, and will cause the logical block number to be incremented by one.

Example:

log. block no: O          5    6    7        100  101       120
              data HOLE data data data HOLE data data HOLE data
                   (5)                 (100)          (120)

where data represents file data blocks of 204 characters, and HOLEs are labels. The contents of the HOLE labels are shown in parentheses.

Labels

Volume header label

                    VOLUME HEADER LABEL
POSITION FIELD NAME                LENGTH CONTENTS
1-3      1     label identifier      3    VOL
4        2     label number          1    1
5-10     3     volume serial number  6    (volume name) $
11       4     accessibility         1    (space)
12-31    5     (not used)           20    (spaces)
32-37    6     (not used)            6    (spaces)
38-51    7     owner identification 14    (name of owner) $
52-79    8     (not used)           28    (spaces)
80       9     label standard level  1    (spaces)

$ field 3 and 7

- These fields may contain any alphanumeric characters. If the field is not fully filled with characters, the last character in the string is an apostrophe. This character is used to mark the end of the string and is not part of the name. The unused part of such a field is filled with spaces.

First file header label

               FIRST FILE HEADER LABEL
POSITION FIELD  NAME                    LENGTH CONTENTS
  1- 3   1      label identifier          3    HDR
  4      2      label number              1    1
5-21    3      file identifier          17    (file name) $
22-27    4      set identification        6    (file type) $
28-31    5      file section number       4    (0001-0002-nnnn)
32-35    6      file sequence number      4    (0001-0002-nnnn)
36-39    7      generation number         4    (file generation) $
40-41    8      generation version number 2    (version number) $
42-47    9      creation date             6    (ANSI standard date) $
48-53   10      expiration date           6    (spaces) $
54      11      accessibility             1    (space)
55-60   12      block count               6    000000
61-73   13      system code              13    (spaces)
74-80   14      (not used)                7    (spaces)

$ field 3:

- An apostrophe is used to mark the end of the string. This character is not a part of the name. The unused part of a field is filled with spaces.

$ field 4:

- Only the first four characters are used in this field. If it is shorter than four characters, an apostrophe is used to mark the end of the string.

$ field 7:

- Any alphanumeric characters. The field is left justified, and an apostrophe is used to mark the end of the string. The character code in this field identifies a backup generation of files.

$ field 8:

- This field contains numbers from 1 to 99. The characters are left justified, and one digit numbers will have an apostrophe in the right character position. This number identifies different versions of files with identical file names (fields 3 and 4), and each version must be treated as an individual file.

$ fields 9 and 10:

- Creation and expiration dates are not used, and the fields will contain spaces.

Second file header label

      SECOND FILE HEADER LABEL
POSITION FIELD NAME               LENGTH CONTENTS
1- 3      1    label identifier     3    HDR
4         2 label number            1    2
5         3 record format           1    U
6-10      4 block length            5    (no. of characters)
11-15     5 record length           5    (spaces)
16-50     6 reserved                     (name of owner) $
            for operating systems  35    & MAX BYTE POINTER)
51-52     7 (not used)              2    (spaces)
53-80     8 (not used)              2    (spaces)

$ field 6:

- Up to 16 alphanumeric characters, starting from position 16, identifying the owner of this file. If the name is shorter than 16 characters, an apostrophe is used to mark the end of name.

- 32-41 contains the MAX BYTE POINTER of the file.

End of file label

               END OF FILE LABEL
POSITION FIELD  NAME                 LENGTH CONTENTS
 1- 3     1     label identifier       3    EOF
 4        2     label number           1    1
 5-54     3-11  (same as HDR1)        50    (corresponds to HDR1)
55-60    12     block count            6    (number of blocks)
61-80    13-14  (not used)            20    (spaces)

End of volume label

               END OF VOLUME LABEL
POSITION FIELD  NAME                 LENGTH CONTENTS
1-3      1      label identifier      3     EOV
4-80     2-14   same as EOF1         77     (corresponds to EOF1)

User label

                      USER LABEL
POSITION FIELD  NAME                LENGTH CONTENTS                                  
1-3      1      label identifier      3    UHL
4        2      label number          1    1           
5-80     3      user option          76    (file information) $

Explanation of field 3

- $ This field differs from the ANSI label standard. The field contains binary information for the ND BACKUP-SYSTEM and SINTRAN III file system.

Field 3:

       POSITION                         CONTENTS
WITHIN FIELD WITHIN LABEL
 1-2          5-6                version number of this file (1-255)
 3-4          7-8                total number of versions (1-255)
 5-8          9-12               file system standard creation date
 9-12        13-16               not used
13-76        17-80               SINTRAN III file system object entry

Nonstandard 'Hole' label

        NONSTANDARD 'HOLE' LABEL
POSITION FIELD    NAME             LENGTH CONTENTS
1-3       1       label identifier   3    HOL
4         2       label number       1    E
5-80      3       user option       76    (information) $

Explanation of field 3:

Field 3:

            POSITION                     CONTENTS
WITHIN FIELD WITHIN LABEL
 1-72         5-76         THIS BLOCK IS NOT PART OF THE DATA!
                           CHARACTERS 77-80 CONTAIN A NUMBER.
73-76        77-80         (32-bit binary number stating the logical
                           block number of the following data block)

Product number

References

  1. Norsk Data Document ND–60.151.02A SINTRAN III UTILITIES MANUAL