as_qmgr(1)


as_qmgr -- maintain the SCO ARCserve/Open Job Queue

Synopsis

as_qmgr [-option] [arguments]

Description

as_qmgr is a command-line interface to the SCO ARCserve/Open Job Queue. Jobs in the queue can be manipulated, and new jobs can be loaded. Some configuration capabilities are also provided.

Usage

as_qmgr accepts the following options:

-list
Display the current status of the SCO ARCserve/Open Job Queue, including active and pending jobs.

-load script
Load the SCO ARCserve/Open job script script. The full path to the script file must be provided. See the SCO ARCserve/Open User Guide for information on creating job scripts.

-changestatus jobID status
Change the status of the job with id jobID to status status. The jobID can be obtained from the output of the -list option. status can be either ready or hold.

-changedate jobID date
Change the execution date of the job with id jobID to date. The jobID can be obtained from the output of the -list option. date must be specified in the format appropriate for the current locale. See the output of the -list or the -usage option for the proper format.

-changetime jobID time
Change the execution time of the job with id jobID to time. time must be specified in the hh:mm format. The jobID can be obtained from the output of the -list option.

-stop jobID
Stop the active job with id jobID. This option is meaningful only when applied to active jobs. The jobID can be obtained from the output of the -list option.

-view jobID
View information about the job with id jobID. This option is not meaningful if the job is active. The jobID can be obtained from the output of the -list option.

-delete jobID
Delete the job with id jobID. The jobID can be obtained from the output of the -list option. For the differences between this and the -stop option, refer to the SCO ARCserve/Open User Guide.

-holdq setting
If setting is on, the Job Queue is placed on hold. If setting is off, the Job Queue becomes active. Only the root user can utilize this option.

-setuid setting
If setting is on, all backup jobs submitted by ARCserve Queue Operators will run with superuser privileges. If setting is off, backup jobs run with the usual privileges. The initial setting of this feature is off. Only the root user can utilize this option.

-listusers
List the current SCO ARCserve/Open Queue Users. SCO ARCserve/Open Queue Operator privileges are needed for this option, as well as the following options that manipulate the User configuration. See the SCO ARCserve/Open User Guide for a complete discussion of User versus Operator privileges.

-adduser username [status]
Specify username as a new SCO ARCserve/Open Queue User. Optionally the keyword operator can be supplied as status, so that the new user will also have Operator privileges.

-deluser username
Revoke SCO ARCserve/Open User privileges for username.

-chuser username status
Modify username's privileges by specifying the keywords user or operator for status.

-addgroup groupname [status]
Specify groupname as a new SCO ARCserve/Open Queue User. Optionally the keyword operator can be supplied as status, so that users belonging to the new group will also have Operator privileges.

-delgroup groupname
Revoke SCO ARCserve/Open User privileges for groupname.

-chgroup groupname status
Modify groupname's privileges by specifying the keywords user or operator for status.

-usage
Display the syntax of as_qmgr.

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_devmgr(1), as_dbmgr(1), as_scan(1), as_merge(1), SCO ARCserve/Open User Guide

Notices

The output from the -view option can be extensive, so you will often need to redirect it to a file.
SCO ARCserve/Open 2.2.0 -- December 1997
© 1997 The Santa Cruz Operation, Inc. All rights reserved.