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 an Oracle HSM 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 Oracle HSM environments