mc(1M)mc(1M)NAMEmc - media changer manipulation utility
SYNOPSIS
device] num] src_element_type dest_element_type]
device] element_type]
device] drive_number] element_type]
device]
DESCRIPTION
The utility provides users with a command-line interface to send media
manipulation commands to an autoloader or media changer device. It
takes "element types" as arguments to most of the options. The valid
element types (element_types) are:
Specifies a Data Transfer (DT) element.
Specifies an Import/Export (IE) element.
Specifies a Medium Transport (MT) element.
Specifies a Storage (ST) element.
An example of a Data Transfer element is the embedded tape drive(s) of
the autoloader. An example of an Import/Export element is the slot(s)
by which an item of the media may be inserted or removed from the
autoloader. An example of a Medium Transport element is the robotic
picker assembly of the autoloader. An example of a Storage element is
the media slot(s) of the autoloader.
Please see examples below for usage.
Options
recognizes the following options and arguments:
Prints the SCSI bus address of the drive slot specified by num.
Issue a Reserve (1) or Release (0) SCSI command to the device.
Determines whether a move from source to destination is valid.
Uses device capabilities mode page and will return TRUE or
FALSE. There should be no spaces in the source and destination
element type values. For example, specifies a Data Transfer
element as the source and a Storage element as the destination.
Prints out the number of elements of element type.
See element types above. Multiple types can be specified. For
example, specifies all the valid element types.
Prints out usage description.
Allow or prevent media removal.
Prints the serial number of the drive in the slot specified by
num (if information is available).
Specifies the pass-through device file to the
library device. If the environment variable is set then the
option may be omitted.
Prints out Vendor ID, Product ID and Product Rev
standard inquiry information.
Prints out the status (FULL/EMPTY/NONE) of element
slots of element type(s). See element types above. If barcode
information is supported by the device, this will be appended to
the status. Multiple types can be specified. For example,
specifies all the valid element types.
Specifies the element type and slot number
(num) for the move medium source. There should be no space
between the element type and the slot number. For example,
specifies a Storage element in slot number 1. This option can‐
not be specified more than twice per invocation.
Specifies the element type and slot number for the
move medium destination. There should be no space between the
element type and the slot number. For example, specifies a Data
Transfer element in slot number 3. This option cannot be speci‐
fied more than twice per invocation.
RETURN VALUE
returns 0 upon successful completion and -1 otherwise.
DIAGNOSTICS
The above error message could be a result of the command that
was used to move media to an embedded drive that is already
full.
If the LIBRARY environment variable is not set and no other
device file is specified, then the above error message will be
printed.
EXAMPLES
Using a DDS-2 autoloader with a six-cartridge magazine as an example:
To see the status of the autoloader's Data Transfer and Storage element
types:
The following shows an example of output from the above command. The
output indicates that there is an item of media in slot 2 (ST_slot_2),
an item of media in the embedded drive (DT_slot_1), and all the other
slots are empty.
To move media from an embedded drive to slot 5 and then move media from
slot 2 to an embedded drive:
To check if a move from a Data Transfer element to a Storage element is
possible:
The following shows an example of output from the above command. The
output indicates that moves from Data Transfer element types to Storage
element types are valid.
WARNINGS
Note for all HP DDS autoloaders: After the command has been used for
the first time, the autoloader will enter into random mode. Once in
random mode, all front panel button features are disabled except for
the Eject Button. To go back to stacker mode, the magazine must be
ejected and then reinserted.
Note for some autoloaders or libraries: The media must be unloaded
using the command prior to using the command.
DEPENDENCIES
The command supports all HP-supported devices that comply with the
SCSI-2 Medium Changer command specification.
Either the or passthrough driver must be configured. See scsi_tape(7)
and scsi_ctl(7).
AUTHOR
was developed by Hewlett-Packard.
SEE ALSOmt(1), scsi(7), scsi_tape(7), scsi_ctl(7).
mc(1M)