NAME

butc - initialize Tape Coordinator process on backup machine in AFS Backup System. 

SYNOPSIS

butc [-port <port offset>]  [-debuglevel <debug level>]  [-aixsci]  [-help]

The butc command initializes the Tape Coordinator, a separate instance of which must run for each tape drive used on the backup machine.  The Tape Coordinator controls the behavior of its associated tape drive. 

OPTIONS

-port <port offset>

Specifies the port offset number to be associated with the Tape Coordinator.  The issuer of backup commands uses this number when indicating that the Tape Coordinator should execute a command. 

Legal values are the integers 0 through 6, as the Backup System can track up to seven Tape Coordinators per backup machine.  This argument defaults to 0 if not provided.  The value should match the value assigned in /usr/afs/backup/tapeconfig to this Tape Coordinator’s associated tape drive.  It is not necessary to assign port offset numbers in sequence, and it is legal to skip over numbers. 

-debuglevel <debug level>

Specifies what kind of messages the Tape Coordinator should produce in its monitoring window.  There are two legal values:

1 indicates that the Coordinator should report on its activities (which volumes it is accessing and dumping, etc).  It will also prompt for the issuer to place new tapes in the drive as necessary. 

0 indicates that the Tape Coordinator should only prompt for new tapes; it will not report on its activities.  This is the default value. 

-aixsci

Should be used when two conditions are met: the backup machine is running the AIX 2.2.1 operating system and is using a tape drive that provides extended SCSI support.  As is appropriate for this type of driver, this flag prevents the Tape Coordinator from doing a reset before rewinding the tape. 

-help

Prints the online help for this command.  Do not provide the other arguments with this one. 

  —  Last change: 30 April 1990