tapeop(1M)
NAME
tapeop − operator control for magnetic tape drive allocation
SYNOPSIS
tapeop [-qQKS] [-DUrdriveno] [-dtapename[/seqno]] [-ptapename/driveno] [-tdevice]
CX/SX ONLY (B1 SECURITY OPTIONS)
tapeop -m tapeid -edriveno
tapeop -a tapeid [-l libr_id]
tapeop -x tapeid [-edriveno]
tapeop -n tapename -b label [-l libr_id]
DESCRIPTION
Tapeop controls requests for tape resources made by users. The operator may query the list of requests, indicate a desired tape has already been mounted, deny specific requests, mark tape drives up or down, or “premount” a tape on a specific drive. tapeop may also be used by root to stop all tape drive assignment by killing the tape daemon (taped).
CONTROLLING TAPE DRIVES
The -D and -U options may be used to mark a specific tape drive down or up, respectively. If a tape drive is marked down, any pending requests for that drive will be cancelled, and no future requests will allocate the drive. When the drive is marked back up, it will be available to all users.
Normally, taped waits for a requested tape drive to go offline and back online when the user’s tape has been mounted. The operator may indicate that the desired tape is already mounted (and avoid the necessity of taking the drive offline) by using the -r option.
The affected tape drive number is a required parameter for the -D, -U, and -r options.
DENYING REQUESTS
If a user has requested a tape which is unavailable (or inappropriate for that user), the operator may deny the request with the -d option. The name of the tape to be denied is a required parameter. If a specific request sequence number (see taped(1M)) is not indicated by the operator with the format tapename/seqno all requests for the tape will be cancelled.
PREMOUNTING TAPES
The operator may indicate that a specific tape has been “premounted” on a drive with the -p option. Both the tape name and the drive that it is mounted on are required parameters.
When a tape has been premounted on a drive, that drive will only be available to the next request for the specified tape, and will not require the “offline/online” sequence to satisfy the request. Once the tape has been requested successfully and released, the drive reverts to normal availablity.
RESOURCE QUERIES
The tapeop -q command may be used to print a list of all allocated, pending, and queued requests. The -Q command will print the same information in a format suitable for programs to utilize.
The tapeop -S command may be used to print a list of all tape drives and their status.
OPERATOR MESSAGES
By default, operator messages from taped(1M) are displayed at the system console. This device may be changed with the -t option. All new operator messages will be directed to the specified device.
TERMINATING THE TAPE SYSTEM
The root user may terminate all tape resourcing activity by shutting down the tape daemon (taped) with the -K option. It is normally expected that this option will only be used for debugging purposes. All requests that have not been successfully satisfied will be denied, and the daemon will exit. The daemon may be restarted at a later time (see taped(1M) for options), although no tape drives should be in use during at that time.
EXAMPLES:
tapeop -d payroll
will deny all pending requests for the tape named “payroll”.
tapeop -p freds/3
indicates that tape “freds” has been premounted on drive number 3. When the next request for “freds” is made, it will be immediately satisifed.
tapeop -D 2
marks tape drive 2 (/dev/rmt/2xxx) as being unavailable.
SECURITY FEATURES
The following security features are in effect on systems running CX/SX configured to B1 security.
All user accessible tapes are listed in the system tape library (/mls/tapelib). When implementing a user request to mount a tape, the operator must use the -m command. The drive number, and a tape identification string (tapeid) which is physically marked on the tape, are required parameters.
The operator can respond to a user request to create a tape library entry for a new (clean) tape by using the -a option with the system generated tapeid that is printed to the operator’s console by the request. A site library identification string may be included and will be printed to the console during subsequent resource requests. The operator is expected to allocate an unused tape and physically mark it with the new tapeid and other identifying information.
The -n option may be used by the operator to create a tape entry without a corresponding user request. The parameters for this option include: a tapename, it’s operating label, and an optional library identification string. The operator can specify a label for the tape in either canonical form or with a privilege name that utilizes it. The system will generate a tapeid and print it on the console for the operator to physically mark on the tape. The tape operator may delete a tape entry with tapeop -x, after (optionally) erasing the tape in a specified tape drive.
BUGS
Only one option may be specified per invocation.
SEE ALSO
CX/UX Administrator’s Reference Manual