tjb_exercise(8) CLIX tjb_exercise(8)
NAME
tjb_exercise - Performs a series of tests on the tape jukebox
SYNOPSIS
/usr/ip32/tjb/tjb_exercise jb_name | -r robotic_path -d drive_path
FLAGS
-r robotic_path
Defines device path of the robotics control port for the tape
jukebox.
-d drive_path
Defines device path of the tape drive for the tape jukebox.
DESCRIPTION
The tjb_exercise command performs a series of tests on the tape jukebox.
The jukebox can be specified either by using the logical jukebox name or
by specifying the SCSI robotics and drive paths.
EXAMPLES
To perform a series of tests on the tape jukebox, TJB01, key in one the
following commands:
tjb_exercise TJB01
tjb_exercise -r /dev/gs/s3u0 -d /dev/gs/s5u0
The following is the output produced by the tjb_exercise command:
JB Info
jb name : "TJB01"
jb path : "/dev/gs/s3u0"
jb drives : 1
Drive Info
drive path : "/dev/gs/s5u0"
drive address : 0 EMPTY
Slot Info
slot address : 1 OCCUPIED
slot address : 2 OCCUPIED
slot address : 3 EMPTY
slot address : 4 EMPTY
slot address : 5 OCCUPIED
slot address : 6 OCCUPIED
slot address : 7 OCCUPIED
2/94 - Intergraph Corporation 1
tjb_exercise(8) CLIX tjb_exercise(8)
slot address : 8 OCCUPIED
slot address : 9 OCCUPIED
slot address : 10 OCCUPIED
Checking the drive.......
Moving from slot: 1 to drive: 0....
Checking slot->drive->slot .....
Moving from slot: 1 to drive: 0
Moving from drive: 0 to Slot: 1
Moving from slot: 2 to drive: 0
Moving from drive: 0 to Slot: 2
Moving from slot: 3 to drive: 0
Moving from drive: 0 to Slot: 3
Moving from slot: 6 to drive: 0
Moving from drive: 0 to Slot: 6
Moving from slot: 7 to drive: 0
Moving from drive: 0 to Slot: 7
Moving from slot: 8 to drive: 0
Moving from drive: 0 to Slot: 8
Moving from slot: 9 to drive: 0
Moving from drive: 0 to Slot: 9
Moving from slot: 10 to drive: 0
Moving from drive: 0 to Slot: 10
Exercise completed successfully
FILES
/dev/gs/s?u? Robotics and tape device files.
/etc/TJBCFG Tape jukebox configuration file.
NOTES
The tjb_exercise command requires superuser privileges. See tjb_config(8)
for a description of the configuration data.
CAUTIONS
The tjb commands check if the drive (/dev/rmt/mt?) is in use only at the
beginning of the command. If any tape operation is started after a tjb
command is initiated, the tjb command may eject the tape from the drive
and cause a no media in drive error for the tape operation.
DIAGNOSTICS
The following is a list of common error messages and their meanings:
No information for jukebox "MY_TJB" in configuration file
The logical name MY_TJB cannot be found in /etc/TJBCFG. The
configuration file may be missing the =, {, or } characters.
2 Intergraph Corporation - 2/94
tjb_exercise(8) CLIX tjb_exercise(8)
get_status: Device busy
Failed to get drive status information
If the tape drive door is closed, the file /dev/rmt/mt* is checked
to see if the drive is in use.
ERROR: Door open
Failed to move media from 0 to 1
The jukebox door was opened while a move operation was in progress.
Unit attention detected, performing reset
A reset is performed before the next command (unless the command is
tjb_reset or tjb_exercise) if the jukebox door has been opened, or
a SCSI bus reset has occurred.
Cartridge in changer, attempting to place in empty slot
Cartridge placed in slot 3
The jukebox door was opened, or a SCSI bus reset has occurred while
the cartridge handler mechanism had a cartridge retrieved. The
cartridge is placed in the first empty slot found.
EXIT VALUES
The tjb_exercise command exits with a value of 0 if successful. If
unsuccessful, it exists with a nonzero value.
RELATED INFORMATION
Commands: tjb_eject(8), tjb_config(8), tjb_move(8), tjb_reset(8)
2/94 - Intergraph Corporation 3