as_devmgr(1)


as_devmgr -- manage backup devices

Synopsis

as_devmgr [-option] [arguments]

Description

as_devmgr allows the user to perform some of the device management operations that the SCO ARCserve/Open frontend provides. It can also be used to access information about the tape and changer devices currently available to SCO ARCserve/Open.

Usage

as_devmgr accepts the following options:

-info
Display brief information about the devices currently accessible to SCO ARCserve/Open.

-deviceinfo scsiID
Show information about the device installed at SCSI id scsiID. If more than one device occupy scsiID, information about all such devices will be provided.

-tapeinfo scsiID
Display information about the tape presently in the device at SCSI id scsiID. If the device at scsiID is a changer, brief information about all the tapes available will be provided.

-copy source dest
Copy the tape in the device at SCSI id source to the tape in the device at SCSI id dest. An exact duplicate of the source tape will be produced.

-format scsiID name [date]
Format the tape in the device at SCSI id scsiID. name is the tape's new name. An optional expiration date can be given as an argument. date must be specified in the format appropriate for the current locale. See the output of the -usage option for the proper format. The default expiration date is 1 year after the format date.

-erase scsiID [mode]
Erase the tape in the device at SCSI id scsiID. If mode is quick, the tape label will be destroyed, whereas if mode is regular, all the contents of the tape will be wiped out. The default erase mode is quick. The tape will appear to SCO ARCserve/Open as "blank" after the erase operation, independently of the mode chosen. Note, however, that a regular erase will take a lot longer to complete.

-retension scsiID
Perform a retension on the tape in the device at SCSI id scsiID.

-compression scsiID setting
Change the compression mode of the tape device at SCSI id scsiID. If setting is on, compression will be enabled, and if it is off, compression will be disabled.

-eject scsiID
Eject the tape in the tape device at SCSI id scsiID. Note that certain tape drives will not physically eject the tape. SCO ARCserve/Open will still consider the tape ejected, and will not operate on it, unless the tape is manually ejected and reinserted.

-load scsiID slot
Load the tape residing at slot slot into the corresponding tape drive. scsiID is the SCSI id of the changer device.

-unload scsiID slot
Unload the tape residing at slot slot from the corresponding tape drive. scsiID is the SCSI id of the changer device.

-chformat scsiID slot name date...
Format multiple changer tapes. scsiID is the SCSI id of the changer device. For each tape, the following mandatory arguments must be provided:

the changer slot where the tape resides, the new tape name name, and the expiration date date.

date must be specified in the format appropriate for the current locale. See the output of the -usage option for the proper format. Alternately, date can be the keyword def, in which case the expiration date is set one year in the future.

Note that all the tapes to be formatted must belong to the same device group.

-cherase scsiID slot mode...
Erase multiple changer tapes. scsiID is the SCSI id of the changer device. For each tape, the following mandatory arguments must be provided:

the changer slot where the tape resides, and the type of erase operation to take place. If mode is the letter q, a "quick" erase is performed, whereas if mode is the letter r, a "regular" erase is performed. See also the discussion on the -erase option.

Note that all the tapes to be erased must belong to the same device group.

-import scsiID slot
Import a tape in the changer device at SCSI id scsiID. The tape will be assigned to slot number slot.

-export scsiID slot
Export a tape from the changer device at SCSI id scsiID. slot is where the tape currently resides.

-clean changerID tapeID
Perform a cleaning operation to the tape device at SCSI id tapeID. The tape device must belong to the changer device at SCSI id changerID.

-usage
Display the syntax of as_devmgr.

Only one of the above options can be used at a time. If no options are present, -usage is assumed.

Diagnostics

References

as_backup(1), as_restore(1), as_qmgr(1), as_dbmgr(1), as_scan(1), as_merge(1), SCO ARCserve/Open User Guide

Notices

Due to the nature of most device management operations, as_devmgr ignores signals SIGHUP, SIGTERM, SIGQUIT, and SIGTERM. If you choose to run as_devmgr in the foreground, be aware that SIGSTOP (ctrl-Z in most terminals) will stop as_devmgr with potentially adverse effects.

This version of as_devmgr does not perform device configuration. You will need to use the SCO ARCserve/Open frontend for this task.

In order to perform a copy operation, it is preferable that the source and destination devices are identical. If not, the user is given the option of aborting the operation.


SCO ARCserve/Open 2.2.0 -- December 1997
© 1997 The Santa Cruz Operation, Inc. All rights reserved.