filename.restore-errors Definition/Access: General


Command filename.restore-errors Definition/Access: General
Applicable release versions: AP
Category Access: General (65)
Description contains errors which occurred during a restore.

If the "restore-errors" file does not exist, it is created when the first error occurs.

The "d-pointer" to this file is placed in the "mds" file, rather than in the "dm" account md, since a full restore may be in progress, and the "dm" account may not be available.

One of the following errors may be generated:

err "d" type segment level (1=account, 2=dict, 3=data)

This indicates that either an incorrect "d-pointer" was found on the tape or an item with no preceding "d-pointer" was found on the tape. This type of message usually occurs during unusual restore sessions, such as forcing tape to get past errored blocks, starting on wrong reel number's, overriding or continuing after bad labels, etc.

If an item is found with no preceding "d-pointer", the restore must be told where it should be placed. For example: If the restore was restoring the data level (level = 3) when a block was dropped or bad and at the beginning of the next block an item was found that didn't belong to this file, the restore will not know where it goes. If 2 is chosen (dict) in the above example, the restore stops restoring items to the data level and begins restoring items to the dict level of this file.

If a "d-pointer" is read off the tape and the level number is not in the range 0 to 3, where zero is the "mds" file, the restore processor must be told at which level it is to be placed. If a "d-pointer" update is read off an incremental or txlog tape and the file number exists in "file-of-files" but it's the wrong file control block, then this message will be displayed.

tape format err (segment skipped)

If an item is read from the tape and its associated file "d-pointer" has not previously been read, it will been skipped. Or, if the item read does not conform to AP tape format it will be skipped, especially if binary object code is not in AP format. If an index b-tree is not in the correct format on the tape this message may also appear.

not found in the "file-of-files"

This is more of a warning, the file number was not found in the "file-of-files". It creates one.

obj data err

If the object code is not in the proper format, then blocks of it will be skipped. If there is no header, which details how many blocks are to follow, than all blocks will be skipped.

'xxx' is not a file name

Could not find the file in the "file-of-files"

'xxx' error in rename, segment skipped

The restore was probably from incremental or txlog tape. File not found in "file-of-files" and could not be renamed because restore does not know the path name of the old file. This is one reason why incremental saves can't be restored from TCL. (Too much reliance on file number rather than path name) The "rename-file" or "move-file" was skipped.
Related tcl.list-restore-errors