1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
10 .de Sp \" Vertical space (when we can't use .PP)
16 .ie \\n(.$>=3 .ne \\$3
20 .TH "AMTAPE" 8 "" "" ""
22 amtape - user interface to Amanda tape changer controls
25 \fBamtape\fR \fIconfig\fR \fIcommand\fR [\fIcommand\fRĀ \fIoptions\fR]
29 performs tape changer control operations. It uses the underlying tape changer script defined by the
31 option for a particular
33 configuration as specified by the
37 Tape changers maintain a notion of the
41 slot for each configuration. These may or may not correspond to an actual physical state of the device, but do tend to minimize searching through the tape storage slots. If the desired tape is in the current slot, it is likely the next tape needed is in the next slot rather than at some random position in the storage slots.
45 man page for more details about
50 Reset the tape changer to a known state. The
54 slot. Other device-specific side effects may occur. Some gravity stackers need to be reset to the top position by hand. This command notifies
56 the stacker is back in that position.
59 If a tape is loaded in the drive, it is ejected and returned to the slot from which it was loaded.
62 If a cleaning tape is defined for the changer, it is used to clean the drive.
65 Show the contents of all slots. This can be slow.
67 \fBlabel\fR \fBlabel\fR
68 Search for and load the
76 scan algorithm. Load the next tape in the configuration's tape sequence, or a fresh tape with a suitable label.
79 Display the name of the current tape device on
83 Display the current slot.
86 Update the changer label database, if it has one, to match the tapes now available.
89 Eject any tape in the drive and put it away, then load the tape from slot
95 Eject any tape in the drive and put it away, then load the tape from the current slot.
98 Eject any tape in the drive and put it away, then load the tape from the previous slot and reset
102 Eject any tape in the drive and put it away, then load the tape from the next slot and reset
106 Eject any tape in the drive and put it away, then load the tape from the first slot and reset
110 Eject any tape in the drive and put it away, then load the tape from the last slot and reset
114 Eject any tape in the drive and put it away. Advance
116 to the next tape, but do not load it.
118 This is useful with non-gravity stackers to unload the last tape used and set up
120 for the next run. If you just use
121 \fBeject\fR, the current tape will be mounted again in the next run, where it will be rejected as being still in use, ejected and the next tape requested. Using
125 does an unnecessary mount.
127 Note: most changers optimize the
129 commands to not eject the loaded tape if it is the one being requested.
136 Stefan G. Weichinger,
137 <sgw@amanda.org>, maintainer of the
138 \fBAmanda\fR-documentation: XML-conversion