Copyright Digital Equipment Corp. All rights reserved.

Description

   The SCSI-2 specification for medium-changer devices allows an
   element to remember the source element of the current piece
   of media. For example, if a mrd_load(3mrd) is performed from
   slot 17 to drive 2, the element information for drive 2 will
   remember that the media came from slot 17. Where this feature
   is implemented, it allows an application to query an element to
   learn the original source of the media in it and return it.

   The mrd_home(3mrd) function does this. Given a robot name and
   element address it will see if the source address is valid
   and when it is return that media to its original location.
   If the source address is invalid or the element unavailable
   an error will be returned. The routine will also check to see
   if the media was inverted when placed in the current element
   and restore it to its original orientation. When the move is
   complete, the resulting address and element type will be copied
   into destination_name and destination_type.

   If the volume_tag argument is used, the routine will verify that
   a cartridge with the volume tag is present in the element before
   performing the move.