Trailer information entry

The trailer information entry is output in the format described in this topic. The Entry type value in the entry header determines if the entry associated with the header is a trailer information entry. The trailer information entry is the last entry in the output created by save (SAV) or restore (RST) commands.

For each field, an offset is specified. This offset is relative to the base address of the entry, or the beginning of the first field in the entry header.

Table 1. Trailer Information entry–Output from SAV and RST Commands
Offset (bytes) Type (in bytes) Set by1 Field
Decimal Hex
0 0 BINARY(8) S/R See the table in Entry header information for more format details.
8 8 BINARY(4) S/R Volume identifier offset2
12 C BINARY(4) S/R Complete data
16 10 BINARY(4) S/R Number of object links processed successfully
20 14 BINARY(4) S/R Number of object links processed unsuccessfully
24 18 BINARY(8) S/R Total size (in K) of object links processed successfully
32 20 BINARY(4) S/R Number of media files
36 24 BINARY(4) S/R Media file offset2
Notes:
  1. Set by column. The following column values indicate which operations write the content of the field into the output:
    Value
    Condition
    S
    Save operation set this field.
    R
    Restore operation set this field.
    S/R
    Either operation set this field.
    (blank)
    Not set by either operation. The associated field is set to zero for numeric fields, blank for character fields, or empty for variable-length character fields.
  2. Format of volume identifier. You can find the first entry by using the Volume name offset field to get to the Number of volume identifiers field. The Number of volume identifiers field is not repeated.
    Type (in bytes) Content Field
    BINARY(4) S/R Number of volume identifiers

    Then, moving to the first volume identifier. A volume identifier consists of a length followed by the volume name. The Volume identifier length and the Volume identifier fields are repeated for each volume identifier.

    Type (in bytes) Content Field
    BINARY(4) S/R Volume identifier length
    CHAR(*) S/R Volume identifier
  3. Format of media file. The media file fields are repeated for each media file.
    Type (in bytes) Content Field
    BINARY(4) S/R Media file length
    BINARY(4) S/R Media file sequence number
    BINARY(4) S/R Number of media file device names
    BINARY(4) S/R Media file device name offset
    BINARY(4) S/R Number of media file volume identifiers
    BINARY(4) S/R Media file volume identifier offset
  4. Format of media device name. The media file device name fields are repeated for each media file device name.
    Type (in bytes) Content Field
    BINARY(4) S/R Media file device name length
    CHAR(*) S/R Media file device name
  5. Format of media file volume identifier. The media volume identifier fields are repeated for each media file volume identifier.
    Type (in bytes) Content Field
    BINARY(4) S/R Media file volume identifier length
    CHAR(*) S/R Media file volume identifier
Parent topic: Interpreting output from save (SAV) and restore (RST)