IBM B-Series, Maintenance Information

Page: 501 / 648

|
TAPEUTIL in a HP-UX System Environment
|
Introduction
|
A SCSI Tape and Medium Changer Utility Program called tapeutil is provided with the IBM SCSI Tape and
|
Medium Changer Device Driver for HP-UX and installed in the /usr/bin directory. The tapeutil program
|
fulfills several purposes:
|
It provides the following service aids for IBM tape subsystems:
|
– Query Device Type/Verify Device Attachment
|
– Query Device Serial Number
|
– Query Device Microcode Level
|
– Force Device Diagnostic Dump
|
– Store Device Diagnostic Dump
|
– Download Device Microcode
|
It provides a menu-driven test tool for exercising or testing IBM tape and medium changer devices
|
with a full suite of supported operations:
|
– Reading/Writing Data
|
– Tape Motion Commands
|
– Setting/Displaying Device Information/Status
|
– Mounting/Demounting Cartridges
|
– Cartridge Inventory
|
In addition to the menu-driven front end, the tapeutil program provides a command-line interface which
|
is convenient for use in shell scripts.
|
The source code for the tapeutil program is provided for example purposes, and is installed in the
|
tapeutil directory during the tapeutil package installation. This source code is commented and
|
demonstrates calls to all of the supported device driver entry points and ioctl commands, thus giving
|
the application developer a starting point for interfacing to the HP-UX device driver.
|
The tapeutil program provides both an interactive menu-driven interface as well as a command-line
|
interface. If the tapeutil program is invoked with no command-line parameters, the menu-driven version will
|
be started. In the menu-driven version, the device to be operated on should first be opened using option 1.
|
Other options may then be selected. The user will be prompted for additional information if required for the
|
specific options selected. The results of a command are displayed after it is executed. If an error occurs
|
for the command, error information and device sense data are displayed. The device can be closed using
|
option 2, or it will automatically be closed when the Quit option is selected. The menu is automatically
|
displayed once when the program is first invoked. To prevent unnecessary scrolling of the screen, the
|
menu is not automatically displayed again after each command, but is instead refreshed only after the M
|
(menu refresh) command is entered.
|
Interactive Menu-Driven Interface
|
Figure 314 on page APPENDA-10 shows the menu that is displayed by the tapeutil program when the
|
program is invoked, and no command-line parameters are entered:
APPENDA
APPENDIX A
APPENDA-9