User's Guide

GETDRIVEINFO

Given the drive name, return the device name, device type, density, and tape drive system host name

Function:

Finds the device name, device type, density, and system host name for a specified drive name. These four values are returned to the calling procedure as character strings.

Parameters:

DRIVE
Drive name. The name of the tape drive.

DEVICE
Device specification. The system device file name of the tape drive specified in DRIVE will be returned in this TAE string variable. Examples include "/dev/rmt/tps0d5nrnsv" and "/dev/rmt/xmt0d0nr".

DTYPE
Device type. The type of tape drive specified in DRIVE will be returned in this TAE string variable. Examples include "3480", "9-track", and "8mm".

DENSITY
Density. The tape density of the device specified in DRIVE will be returned in this TAE string variable. Examples include "LO" and "6250".

THOST
Tape drive host. The system host name upon which the tape drive is located will be returned in this TAE string variable. Examples include "edcsgs20" and "dg5".

Example:

  1. LAS> getdriveinfo drive=1 device=dev dtype=dtyp density=dens thost=host

    The device name, device type, density, and tape drive system host name are returned to the local variables dev, dtyp, dens, and host. Examples of a return device name, device type, density, and system host name are "/dev/rmt/tps0d5nrnsv", "3480", "LO", and "edcsgs20", respectively.

Description/Algorithm:

GETDRIVEINFO reads the TAPE;CONFIG file in LASTABLES to determine the system device file name, device type, tape density and tape drive system host name for the specified drive. These four values are returned in TAE parameters.

Nonfatal Error messages:

    None.

Fatal Error messages:

  1. [getdriveinfo-fatal] Fatal error encountered

    A fatal error was encountered. The message displayed preceding this message is the error that was encountered. Processing terminates.

  2. [getdriveinfo-frd] Error reading tape configuration file

    An error was encountered while trying to read the file that contains tape drive values. Verify that the specified drive is valid.

User Notes:

  1. The device specification, device type, density, and tape drive system host name will be returned in local variables that must be declared prior to calling GETDRIVEINFO. For example, if DTYPE=dattype, the following declaration must have previously been made:

           local dattype type=string