tpreq

tpreq — request a tape volume for mounting and assign a file name to the drive

SYNOPSIS

<volmgr_dir_path>tpreq -m media_id [-a accessmode] [-d density] [-p poolname] [-priority number] [-f] filename

On Windows systems, <volmgr_dir_path> is <install_path>\Volmgr\bin\

DESCRIPTION

This command initiates a mount request for a tape volume on a removable media device. The information that you specify with this command identifies and registers the specified file as a logical identifier for the mount request with Media Manager. It also manages access to the volume.

Media Manager automatically mounts the media if it is in a robotic drive. Otherwise, an operator mount request appears in the Device Monitor window. tpreq does not complete normally in the case of a mount request for a robotic drive, if operator intervention is required. These requests also appear in the Device Monitor window.

When the operation is complete, use tpunmount to unmount the volume and remove the file name from the directory in which the file was created.

You must have administrator privileges to run this command.

OPTIONS

-m media_id

Specifies the media ID of the volume to be mounted. You can enter the ID in upper or lowercase; Media Manager converts it to uppercase.

-a accessmode

Specifies the access mode of the volume. Valid access modes are w and r. If the access mode is w (write), the media must be mounted with write enabled. The default is r (read), which means the media may be write protected.

-d density

Specifies the density of the drive. This option determines the type of drive on which the tape volume is mounted. The default density is dlt.

Valid densities for NetBackup Enterprise Server follow:

4mm for 4-mm cartridge, 8mm for 8-mm cartridge, 8mm2 for 8-mm cartridge 2, 8mm3 for 8-mm cartridge 3, dlt for DLT cartridge, dlt2 for DLT cartridge 2, dlt3 for DLT cartridge 3, dtf for DTF cartridge, hcart for 1/2-inch cartridge, hcart2 for 1/2 Inch cartridge 2, hcart3 for 1/2 Inch cartridge 3, qscsi for 1/4-inch cartridge.

The following applies only to NetBackup Enterprise Server:

The half-inch cartridge densities (hcart, hcart2, and hcart3) can be used to distinguish between any supported half-inch drive types. However, tape requests can only be assigned to drives of the associated media type. For example, it assigns a tape request with density hcart2 that specifies a media ID with media type HCART2 to an hcart2 drive. Likewise, it assigns a tape request with density hcart that specifies a media ID with media type HCART to an hcart drive. The same rules apply to the DLT densities (dlt, dlt2, and dlt3) and the 8MM densities (8mm, 8mm2, and 8mm3).

Valid densities for NetBackup server follow:

4mm for 4-mm cartridge, 8mm for 8-mm cartridge, dlt for DLT cartridge, hcart for 1/2 Inch cartridge, qscsi for 1/4-inch cartridge.

The mount request must be performed on a drive type that satisfies the density.

-p poolname

Specifies the volume pool where the volume resides. poolname is case sensitive. The default is None.

-priority number

Specifies a new priority for the job that overrides the default job priority.

-f filename

Specifies the file to be associated with the volume. The file name represents a symbolic link to the drive where the volume is mounted.

The file name can be a single name or a complete path. If you specify only a file name, the file is created in the current working directory. If you specify a path, the file is created in the directory that is named in the path. filename cannot be an existing file.

If the tpreq command is successful, Media Manager creates a file with the name that you specified. This file contains the name of the tape device where the media is mounted. Do not delete this file. Use the tpunmount command to remove it.

The specification of -f before filename is optional.

EXAMPLES

The following command creates a file named tape1 in the current working directory. It links the file to the drive that contains the volume that has media ID of JLR01. The access mode for the tape file is set to write, and a 1/4-inch cartridge drive is assigned.

# tpreq -f tape1 -m jlr01 -a w -d qscsi

This command creates a file named tape1 in the current working directory. It links the file to the drive that contains the volume that has media ID of JLR01. The access mode for the tape file is set to write, and a 1/4-inch cartridge drive is assigned.

SEE ALSO

tpunmount, vmadm