Lists error messages from the butc process
Description
The TE_device_name file lists error messages generated by the butc (Backup Tape Coordinator) process. The butc process
initializes a Tape Coordinator on a Tape Coordinator machine (a machine having a tape drive and an associated Tape Coordinator). The butc program prompts for new tapes (and displays some
additional output) and, if the value set with the butc command's -debuglevel option is 1, displays information about restore operations on the screen.
The butc process also writes error messages to an ASCII file named TE_device_name, where device_name is the device name of the tape drive with which the process is associated. The file is located in the directory named dcelocal/var/dfs/backup on the local disk of the Tape Coordinator machine. Messages written to the file by the process describe any problems the process encountered while executing an operation; for instance, it can include the names of any filesets the process was unable to include in a dump operation.
Each time the butc process is started for a tape drive and Tape Coordinator pair, it automatically creates the error file. It then appends any messages to the file once it exists. If the file already exists when the butc process is started, the process moves the current version of the file to the TE_device_name.old file in the same directory (overwriting the current TE_device_name.old file if one exists) before creating a new version to which to append messages. In either case, the issuer of the butc command must have write and execute permissions on the dcelocal/var/dfs/backup directory. (The process also writes execution information it generates to the dcelocal/var/dfs/backup/TL_device_name file, which it maintains exactly as it does the TE_device_name file.)
Examples
The following example displays an error file generated by the butc process for a tape drive whose device name is /dev/rmt1h. The file, named
dcelocal/var/dfs/backup/TE_rmt1h (the log file associated with this tape drive is named TL_rmt1h), shows routine error messages generated during a typical execution of the
butc process. The messages that follow indicate that three dump sets were not added to the Backup Database; messages also indicate why each dump set was not added to the database (in all
three cases, dump sets having the specified dump IDs already existed). The bak scantape command was used to attempt to add the dump sets to the database.
Thu Aug 22 10:52:49 1991
Dump id 681664660 not added to database
Thu Aug 22 10:52:49 1991
DFS:bakserver : dump with specified id already exists
Thu Aug 22 10:52:49 1991
Dump id 681749283 not added to database
Thu Aug 22 10:52:49 1991
DFS:bakserver : dump with specified id already exists
Thu Aug 22 10:52:49 1991
Dump id 681657088 not added to database
Thu Aug 22 10:52:49 1991
DFS:bakserver : dump with specified id already exists
Related Information
Commands: butc(8dfs)
Files: TL(4dfs)