unload(1M)

NAME
     unload - Unload media from a device

SYNOPSIS
     /opt/SUNWsamfs/sbin/unload [ -w ] eq

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     Unload the media mounted on device eq.  The device specified
     by eq must be a removable media device or a media changer.

     If eq is a removable media  device  controlled  by  a  media
     changer, the medium will be moved into storage. This command
     is used when a shutdown of a SAM-QFS file system is required
     and a tape is still in a drive. This command is also used in
     situations where the system administrator wishes to remove a
     tape from a drive that is currently in the unavail state.

     If eq is a media changer, unload moves catalog entries  from
     the  media changer's catalog to the historian's catalog. The
     device state for device eq is set to off.  When  the  device
     state  for  the  media  changer  is  set to on and the media
     changer has bar codes, then the catalog information for that
     media  changer is retrieved from the historian. If the media
     changer does not have bar codes, an  audit  invoked  by  the
     administrator  will  recover the historian information. This
     command is useful for moving tapes in to and  out  of  media
     changers  which  do  not have import/export capabilities, or
     sense capability for open door. By first issuing the  unload
     command,  the  system administrator can safely open the door
     to the media changer, add or remove tapes, close  the  door,
     and re-audit the media changer.

     If -w is specified, the command will wait for the  operation
     to complete before terminating.

FILES
     mcf                 The  configuration  file   for   SAM-QFS
                         environments

SEE ALSO
     auditslot(1M),   historian(7),   load(1M),    set_state(1M),
     mcf(4), sam-robotsd(1M)