Diagnostic Test Descriptions

Each diagnostic runs through a different set of tests. Only perform disruptive tests if the library is offline.

allCaps (DISRUPTIVE TEST)

Opens and closes all eligible CAPs. A CAP must be empty and closed to be eligible. This test skips any CAPs that are open, opening or closing or that contain cartridges. This test terminates when it reaches iterationCount or the timeLimit, whichever comes first. This test does not physically open the Access Module door. This test overwrites any existing CAP ownership for the duration of the diagnostic. When this diagnostic completes, the library returns ownership to the previous owner.

stopOnError (check box) - If selected, this diagnostic test stops if it encounters an error. If not selected, and the test encounters an error, the test continues until it reaches the iterationCount or timeLimit.
iterationCount - Number of iterations to perform. One iteration opens, and then closes each eligible CAP.
timeLimit - Total time limit for the test. Allow approximately 100 seconds per rotational CAP per iteration.

allDrives (DISRUPTIVE TEST)

Mounts and then dismounts a diagnostic tape to each eligible drive in the library. Drives must be empty to be eligible. This test skips any drives containing tapes or any drives that are empty but for which the library has no compatible diagnostic cartridges. This test terminates when it reaches iterationCount or timeLimit, whichever comes first.

stopOnError (check box) - If selected, this diagnostic test stops if it encounters an error. If not selected, and the test encounters an error, the test continues until it reaches the iterationCount or timeLimit.
iterationCount - Number of iterations to perform. Each iteration mounts and dismounts a diagnostic tape in each drive.
timeLimit - Total time limit for the test. Allow approximately 25 seconds per drive per iteration.

allLeds

Sets all supported LEDs on all devices to the desiredLedState for the holdTime. Some LEDs do not change state instantaneously, therefore choose a holdTime that is long enough to allow all device LEDs to change state (for example 300 seconds).

desiredLedState - The desired LED test state — LIT, UNLIT, SLOWBLINK, FASTBLINK
holdTime - Duration in seconds that the LEDs remain in the desiredLedState before reverting to their original state.

cellCalibration

Calibrates the robot to a cartridge array or drive. For a cartridge array, specify a cell ID for any cell in the array.

deviceId - ID of robot to calibrate — see Determine a Robot ID.
cellId - A cell ID from the cartridge array to use for the calibration, or the cell ID of the drive — see Determine a Cell ID.
isHandFull (check box) - If selected, the robot picks up a tape before performing the calibration (this may interfere with normal operations if a client application needs the tape while this diagnostic runs). When the diagnostic completes, the robot returns the tape to its original cell. If not selected, the robot hand remains empty for the test.
fetchOrPutCellId - If isHandFull was selected, this parameter is the cell ID that contains the tape to use. If isHandFull was not selected, the library ignores this parameter — see Determine a Cell ID.

customerAcceptance (DISRUPTIVE TEST)

Note:

The library must contain at least 8 tapes in storage cells to perform a complete customer acceptance test.

Runs a series of diagnostic tests to qualify the system after installation, but before customer hand-off. The customer acceptance test does the following in order:

Obtains all system versions
Obtains all device states
Obtains all feature information
Sets all supported LEDs on all devices to the desiredLedState for the holdTime. Then returns the LEDs to their original state.
Opens and closes all closed and empty CAPs
Moves a tape into or out of each corner of the library (8 total).
Mounts and dismounts a diagnostic tape on all drives if the library contains a compatible diagnostic tape for that drive type
Moves a tape from a system cell into each of the first and last cell of every CAP magazine
Moves a tape based on the cellMoveType parameter

Input parameters:

stopOnError (check box) - If selected, this diagnostic test stops if it encounters an error. If not selected, and the test encounters an error, the test continues until it reaches the iterationCount or timeLimit.
iterationCount - Number of iterations to perform. Each iteration repeats tests 6, 7, 8, and 9 above.
timeLimit - Total time limit for the test in minutes.
holdTime - Duration in that the LEDs blink before reverting to their original state. Allow approximately 4 minutes.
cellMoveType - The library does a move based on the move type parameter:
MAGAZINES — moves a tape into or out of the highest and lowest cell of each storage array within the library

ALL — moves a tape into or out of every cell in the library

NONE — does not perform a move

devices

Provides information about all installed devices and the locations where a device could be installed.

To see the information, go to Diagnostic Results tab. Select the "devices" test, and then from the Actions drop-down (or right-click menu), select Request Details. Click the Output Messages tab.

diagnosticMove

Performs repeated cell to cell moves between a pair of cells. This test terminates when it reaches the number of iterations or the time limit, whichever comes first.

stopOnError (check box) - If selected, the test stops if it encounters an error. If not selected, and the test encounters an error, the test continues until it reaches the iterationCount or timeLimit.
iterationCount - Number of iterations to perform. One iteration is a move from sourceCellId to destinationCellId and then back to sourceCellId.
timeLimit - Total time limit for the diagnostic test. Allow approximately 20 to 60 seconds per iteration.
suppressNotification (check box) - If selected, the library will ignore any errors detected during the diagnostic. The errors will not generate faults.
partitionId - The ID of the partition to use for the moves — see Determine a Partition ID.
sourceCellId - Enter 'random' to have the library select a cell. Or, enter a cell ID that contains a tape within the specified partition — see Determine a Cell ID.
destinationCellId - Enter or 'random' to have the library select a cell. Or, enter the cell ID of an empty cell within the specified partition — see Determine a Cell ID.

features

Lists all possible features that could be enabled using activation files. Lists the all features that are currently active.

To see the information, go to Diagnostic Results tab. Select the "features" test, and then from the Actions drop-down (or right-click menu), select Request Details. Click the Output Messages tab.

libraryCalibration

Performs robot calibration for the entire library.

deviceId - ID of robot to be calibrated — see Determine a Robot ID.
isHandFull (check box) - If selected, the robot picks up a tape before performing the calibration (note that this may interfere with normal operations if that tape is needed while this diagnostic is running). If not selected, the robot hand remains empty for the calibration.
fetchOrPutCellId - If isHandFull is selected, enter the ID of a cell containing a tape (the robot will return the tape to its original cell when the diagnostic completes). If isHandFull is not selected, the library ignores this parameter — see Determine a Cell ID.

mountDismountDrives (DISRUPTIVE TEST)

Mounts all drives or dismounts all drives. This test is intended for use when all drives need to have a tape for some other testing.

Note:

Disable library auto cleaning before using this test. This test does not properly handle cleaning tapes that are mounted when the test starts.

isOperationMount (check box) - If selected, the test mounts a tape in every drive. For empty drives, the library mounts a tape of the highest media generation supported by the drive. If there are insufficient tapes of the highest media generation for the drives, the library may leave some drives empty. For already occupied drives (those in Mounted or Tape Present state), the library dismounts the tape, and then remounts it back into the drive.

If not selected, the test dismounts all drives. The library force unloads any occupied drives (those in Mounted or Tape Present state). The library moves the tapes to cells in the same module as the drive, if possible.

moveInRange (DISRUPTIVE TEST)

Moves a tape into and out of each cell in the specified range. The test starts at startCellId, then increments the row. At the bottom of the column of cells, the test increments the side and begins at the first row in the new column of cells. Once the test completes a column (back-side first, then front-side), the test moves to the next column. The test ends when it reaches the endCellId.

If Testing Storage and System Cells — For empty test cells, the library chooses a tape from another cell, moves the tape into the empty test cell, then back to its starting cell. For occupied test cells, the library removes the tape, places it in an empty cell then back to the test cell.

If Testing Drive Cells — To be eligible for this test, the drive must empty and the library must contain a compatible diagnostic tape. The library mounts a diagnostic tape from a system cell, then dismounts and returns it to the system cell.

startCellId - ID of the first cell in the range — see Determine a Cell ID
endCellId - ID of the last cell in the range (must be greater than the starting cell, based on ordering by column then side then row) — see Determine a Cell ID
stopOnError (check box) - If selected, the test stops if it encounters an error. If not selected, and the test encounters an error, the test continues until it reaches the iterationCount or timeLimit.
timeLimit - Total time limit for the test.

moveToAllCells (DISRUPTIVE TEST)

Moves a tape into and out of all system, storage, and drive cells in the library. This creates a child moveInRange diagnostic test (see moveInRange (DISRUPTIVE TEST) for details).

stopOnError (check box) - If selected, this diagnostic test will stop if any error is encountered. If not selected, the test will continue until the timeLimit is reached or all cells in the range have been tested.
timeLimit - Total time limit for the diagnostic test.

moveToCapMagazines (DISRUPTIVE TEST)

Moves a tape between the top and bottom cell of each CAP magazine. If the CAP cell is empty, the library chooses a tape from another cell, moves the tape into the CAP cell, then back to its starting cell. If the CAP cell is occupied, the library moves the tape to an empty cell, and then back to the CAP cell. The library always returns tapes to their original cells, if possible, even if the test reaches the time limit or an error occurs.

inputCapId - ID of CAP to test — see Determine a CAP ID
stopOnError (check box) - If selected, the test stops if it encounters an error. If not selected, and the test encounters an error, the test continues until it reaches the iterationCount or timeLimit.
iterationCount - Number of iterations to perform. One iteration tests the top and bottom cell in each of the CAP's magazines.
timeLimit - Total time limit for the test.

moveToCorners (DISRUPTIVE TEST)

Moves a tape into and out of each corner cell in the library. Corner cells are the top and bottom storage cells in the first and last columns on each wall of the library (8 cells total). If a corner cell is empty, the library chooses a tape from a nearby cell, moves the tape into the corner cell, then back to its starting cell. If a corner cell is occupied, the library moves the tape out of and then back into the cell. The library always returns tapes to their original cells, if possible, even if the test reaches the time limit or an error occurs.

stopOnError (check box) - If selected, the test stops if it encounters an error. If not selected, and the test encounters an error, the test continues until it reaches the iterationCount or timeLimit.
iterationCount - Number of iterations to perform. One iteration is a move into and out of each corner cell.
timeLimit - Total time limit for the test.

robotToStorageMagazines (DISRUPTIVE TEST)

Moves a tape between the top and bottom cell in each cartridge array in the library. If a cell is empty, the library chooses a tape from a nearby cell, moves the tape into the cell, then back to its starting cell. If a cell is occupied, the library moves the tape out of and then back into the cell. The library always returns tapes to their original cells, if possible, even if the test reaches the time limit or an error occurs.

stopOnError (check box) - If selected, the test stops if it encounters an error. If not selected, and the test encounters an error, the test continues until it reaches the iterationCount or timeLimit.
iterationCount - Number of iterations to perform. One iteration tests all cartridge arrays in the library.
timeLimit - Total time limit for the diagnostic test.

robotCellToCellMove (DISRUPTIVE TEST)

Moves a robot between two cells (does not move any tapes). While this test is running, the specified robot moves between the two cells. If the library has a second robot, it moves out of the way, unable to perform other actions while this diagnostic runs.

robotId - ID of robot to move — see Determine a Robot ID.
sourceCellId and destinationCellId - The cell IDs of the two cells that robot will move between (does not affect tapes in those cells) — see Determine a Cell ID.
numberOfMoves - Number of cycles to perform. Each cycle is a round trip from the source cell to the destination cell and back.

robotMove

Moves a robot to a specified cell (does not move any tapes). If the library has a second robot, it moves out of the way, but will resume operation as soon as this diagnostic completes.

deviceId - ID of robot to move — see Determine a Robot ID
cellId - Destination cell ID — see Determine a Cell ID

robotMoveToLocation (DISRUPTIVE TEST)

Moves a robot mechanism using "mils" to specify the desired position. This test is primarily intended manufacturing.

Caution:

Incorrectly running this test can cause the robot to collide with another robot or the interior of the library. Before running this test, you must move the other robot and other mechanisms to allow for free movement.

deviceId - ID of robot to move — see Determine a Robot ID
mechName - Name of the mechanism to move: TRACK, ZMECH, WRIST, REACH, GRIP — see Robot Mechanisms
expectedFinalMilsPosition - The final mils position of the selected mechanism. Only use values between the operational limits — see Determine the Robot Range.

robotMoveToTachCount (DISRUPTIVE TEST)

Moves a robot mechanism using "tach counts" to specify the desired position. This test is primarily intended manufacturing.

Caution:

deviceId - ID of robot to move — see Determine a Robot ID
mechName - Name of the mechanism to move: TRACK, ZMECH, WRIST, REACH, GRIP— see Robot Mechanisms
expectedFinalTachPosition - The final tach position of the selected mechanism. Only use values between the operational limits — see Determine the Robot Range and Mils to Tach Conversion Factors

robotSweep (DISRUPTIVE TEST)

Moves a robot mechanism through its full range of motion.

Caution:

deviceId - ID of robot to move — see Determine a Robot ID
mechName - Name of the mechanism to move: TRACK, ZMECH, WRIST, REACH, GRIP— see Robot Mechanisms

singleCap (DISRUPTIVE for the specified CAP)

Opens and closes a specified CAP. The CAP must be closed and empty at the start of the test. When you use this test on an Access Module, the door does not physically open.

inputCapId - ID of CAP to test — see Determine a CAP ID
iterationCount - Number of iterations to perform. One iteration opens and then closes the CAP.
timeLimit - Total time limit for the diagnostic test. Allow approximately 100 seconds per iteration.

singleDrive (DISRUPTIVE for the specified drive)

Mounts and then dismounts a diagnostic tape for a specified drive. The library uses a compatible diagnostic tape from a system cell, mounts the drive, dismounts it, and returns the tape to its original cell.

inputDriveId - ID of the drive to test — see Determine a Drive ID.
stopOnError (check box) - If selected, the test stops if it encounters an error. If not selected, and the test encounters an error, the test continues until it reaches the iterationCount or timeLimit.
iterationCount - Number of iterations to perform. One iteration is a mount and dismount of a diagnostic tape.
timeLimit - Total time limit for the diagnostic test. Allow approximately 25 seconds per iteration.

singleLed

Sets all LEDs on a device to a specified state for a specified time. After the specified time period passes, the LEDs return to their previous state.

deviceId - ID of device — see Determine a Device ID.

The valid devices are: Access Module Controller, Access Module Service Panel, Base Module Service Panel, CAP, Library Controller, DC Converter, Drive Controller, Drive Switch, Fan Assembly, Power Supply, Rail Controller, Robot Controller, Root Switch, Safety Controller, Safety Door, Storage Card, and Video Card.

Note:
To select a drive, use the deviceId of the Drive Controller.
desiredLedState - The desired LED test state — LIT, UNLIT, SLOWBLINK, FASTBLINK
holdTime - Duration in seconds the LED remains in the desiredLedState before reverting to the original state.

versions

Collects software and firmware version information for the library controller, web logic, ADF, database, operating system, java, and all devices except tape drives.

To see the information, go to Diagnostic Results tab. Select the "versions" test, and then from the Actions drop-down (or right-click menu), select Request Details. Click the Output Messages tab.