as_scan(1)


as_scan, as_merge -- scan sessions on a tape, or merge sessions from a tape into the SCO ARCserve/Open database

Synopsis

as_scan [-options] [arguments]

as_merge [-options] [arguments]

Description

as_scan allows the user to scan SCO ARCserve/Open tapes from the command-line.

as_merge allows the user to merge SCO ARCserve/Open tapes into the SCO ARCserve/Open database.

The functionality provided by these two commands is equivalent to that of the SCO ARCserve/Open frontend.

Usage

as_scan and as_merge accept the following options:

-list
Display list of potential source tapes. These are the tapes that are currently in the tape or changer devices available to SCO ARCserve/Open.

-at time
Run job at time, specified in the format hh:mm.

-on date
Run job on date. date must be specified in the format appropriate for the current locale. See the output of the -usage option for the proper format.

-hold
Submit the job on hold.

-description string
Attach string as a brief description to the job, so that it can be easily referenced later.

-reportfile filename [mode]
Save a report of the job's activity in the ASCII file filename. filename can be a fully qualified path, or just a name (which will be created in the current directory.) The mode allactivity will generate a detailed report, whereas the mode errorsonly will generate brief output. The default is errorsonly.

-group groupname
Choose the group that will process the job. Only tapes in this group can be used as source tapes. See the SCO ARCserve/Open User Guide for details on the concept of device group.

-tape tapename
Select the tape to be scanned/merged.

-allsessions
Scan/merge all sessions in the source tape.

-session num
Scan/merge only session number num on the tape.

-tapetimeout timeout
Specify a period of timeout minutes that SCO ARCserve/Open will wait for the correct tape to be loaded before it cancels the job automatically. The default value is 5 minutes.

-savescript scriptfile
Instead of submitting the job, save it into the file scriptfile. The job can be later submitted for execution through as_qmgr(1). scriptfile must be a fully qualified path.

-usage
Display the syntax of as_scan/as_merge.

Any of the above options can be used at any time, with the exception of -allsessions and -session, which are mutually exclusive.

If no source group is specified, the first device group will be chosen. If no source tape is selected, the first tape in the specified group will be chosen.

If no options are present, -usage is assumed. This is to maintain consistency with the other commands.

Diagnostics

References

as_backup(1), as_restore(1), as_qmgr(1), as_devmgr(1), as_dbmgr(1), SCO ARCserve/Open User Guide
SCO ARCserve/Open 2.2.0 -- December 1997
© 1997 The Santa Cruz Operation, Inc. All rights reserved.