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
-
Must have ARCserve Operator privileges to perform this task:
ARCserve Operator privileges are needed in order to use
as_scan and as_merge.
-
Could not get the status of user user:
The SCO ARCserve/Open scheduler is not running. You must start SCO ARCserve/Open first.
-
Failed to get job handle from tapesvr:
The SCO ARCserve/Open tape server refused a request regarding
current group or tape information.
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.