clean

Purpose

Use the clean command to clean a tape drive.

See Also:

"Library Commands" for related commands

Prerequisites

You must have the right to manage devices and change device state to use the clean command.

Syntax

clean::=

clean [ --drive/-D drivename ] [ --force/-f ] [ --use/-u element-spec ]

Semantics

--drive/-D drivename

Specifies the name of the drive that you want to clean. If you do not specify a tape drive name, then the drive variable must be set.

--force/-f

Forces Oracle Secure Backup to clean the drive. If there is a tape loaded in the drive, then this option unloads the tape, loads the cleaning tape, cleans the drive, and then reloads the tape that was originally in the drive.

--use/-u element-spec

Specifies the number of a storage element containing a cleaning tape. If omitted, Oracle Secure Backup chooses a cleaning tape based on the setting of the --cleanemptiest option that you specified on the mkdev command. Refer to "se-spec" for a description of the se-spec placeholder.

Example

Example 2-28 informs Oracle Secure Backup that you are inserting an unused cleaning tape into element 4 of library lib1. The example uses the cleaning tape in element 4 to clean drive tape1.

Example 2-28 Cleaning a Tape Drive

ob> insertvol --library lib1 clean --uses 0 --maxuses 3 4
ob> clean --drive tape1 --force --use 4