Tapeutil In Sun (Solaris) System Environment - IBM 3592 Maintenance Information

TAPEUTIL in Sun (Solaris) system environment

A SCSI Tape and Medium Changer utility program that is called tapeutil is provided with the IBM SCSI
tape and Medium Changer device driver for Solaris. It is installed in the /opt/IBMtape directory as part
of the IBMtape package. This 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 that
is convenient for use in shell scripts.
Note: When you use the command-line calls to the tapeutil program, the tape device opens and closes
for each invocation. Configuration parameters that are changed in one call to the tapeutil program are
returned to default values when the device is closed.
• The source code for the tapeutil program is provided for example purposes, and is installed in
the /opt/IBMtape directory during the IBMtape package installation. This source code is commented
and demonstrates calls to all of the supported device driver entry points and ioctl commands. Thus, the
application developer has a starting point for interfacing to the IBMtape device driver.
The tapeutil program provides both an interactive menu-driven interface and a command-line interface.
If the tapeutil program is started with no command-line parameters, the menu-driven version is started.
If you are using the menu-driven version, use option 1 to open the device to be operated on. You then can
select other options.
The user is prompted for more information if it is required for the specific options selected. The results of
a command are displayed after the command is run. If an error occurs for the command, error information
and device sense data are displayed. You can close the device by using option 2, or it closes automatically
after you select the Quit option. The menu is automatically displayed when the program is first started. To
prevent unnecessary scrolling of the screen, the menu is not automatically displayed again after each
command. It is instead refreshed only after the M (menu refresh) command is entered.
Figure 88 on page 264 shows the menu that is displayed by the tapeutil program.
©
Copyright IBM Corp. 2010, 2018 263