Trailer information entry

The trailer information entry is output in the format described in the table below. 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 in1 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) UNSIGNED S/R Number of media files
36 24 BINARY(4) UNSIGNED S/R Media file offset2
1.

Set by column. The following column values indicate which operations write the content of the field into the output:

    Bold Condition
    S Save operations write this field.
    R Restore operations write this field.
    S/R Either operations write this field.
    (blank) Not written 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.

    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.

    BINARY(4) S/ Volume identifier length
    CHAR(*) S/R Volume identifier
3. Format of media file. The media file fields are repeated for each media file.
    BINARY(4), UNSIGNED S/R Media file length
    BINARY(4), UNSIGNED S/R Media file sequence number
    BINARY(4), UNSIGNED S/R Number of media file device names
    BINARY(4), UNSIGNED S/R Media file device name offset
    BINARY(4), UNSIGNED S/R Number of media file volume identifiers
    BINARY(4), UNSIGNED 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.
    BINARY(4), UNSIGNED 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.
    BINARY(4), UNSIGNED S/R Media file volume identifier length
    CHAR(*) S/R Media file volume identifier