mc(1M)																	    mc(1M)

NAME

       mc - 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 ro-
       botic 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 cannot 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 specified 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 Stor-
       age 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 ALSO

       mt(1), scsi(7), scsi_tape(7), scsi_ctl(7).

																	    mc(1M)