Lists execution information from the butc process
Description
The TL_device_name file is a log file containing execution 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 output to an ASCII file named TL_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. Output written to the file by the process provides information about all operations the process executes, from its startup to its shutdown. The level of detail to which each operation is described depends upon the operation; some operations are described in more detail than others.
Each time the butc process is started for a tape drive and Tape Coordinator pair, it automatically creates the log 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 TL_device_name.old file in the same directory (overwriting the current TL_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 any error messages it generates to the dcelocal/var/dfs/backup/TE_device_name file, which it maintains exactly as it does the TL_device_name file.)
Examples
The following example displays a log file generated by the butc process for a tape drive with the device name /dev/rmt1h. The file is named
dcelocal/var/dfs/backup/TL_rmt1h (the error file associated with this tape drive is named TE_rmt1h); it shows routine status messages generated during a typical execution
of the butc process. The process is executed with the -debuglevel set to 0 (zero) on a Tape Coordinator whose TCID is 1.
Thu Aug 22 10:45:02 1991
10:45:02 Starting tape coordinator: TCID 1, debug level: 0,
cell: /.../abc.com
10:45:15 Reading tape label .. 10:45:28 Done
10:46:02 Labelling tape size 153600 .. 10:46:31 Done
10:46:57 Labelling tape ftfamily1.month.1 size 153600 .. 10:47:25 Done
10:49:23 Database dump aborted
10:50:08 Labelling tape size 153600 .. 10:51:46 Done
10:52:25 Database successfully dumped on Thu Aug 22 10:52:25 1991
10:54:37 Reading tape label .. 10:54:48 Done
10:55:16 Labelling tape size 153600 .. 10:55:45 Done
Related Information
Commands: butc(8dfs)
Files: TE(4dfs)