IBM TS2340 User Guide - Page 403

Linux - Tape Utility Program (IBMtapeutil) Linux System - Tape Utility Program (IBMtapeutil) Installed with the device driver is a tape utility program (IBMtapeutil) that exercises or tests the functions of the tape device and the device driver. It also performs basic tape and medium changer operations. The tape utility program can be used in either the interactive or the command-line mode. The C source code for the IBMtapeutil program contains a sample of the interface to the device driver and the ioctl commands supported by the device driver. IBMtapeutil.c may be found in the tar file IBMtapeutil.x.x.x.tar on the device driver down load ftp site: ftp://ftp.software.ibm.com/storage/devdrvr/Linux/. Interactive Mode The interactive mode for the tape utility program can be invoked from the command line using the IBMtapeutil command. A list of general subcommands, medium changer subcommands, tape subcommands, and service aid subcommands is displayed. You must open a device before using these commands and operations. To open a device: 1. Select Open a Device from General Commands. 2. Enter the name of the device special file. Use any special file that exists for the device, for example, /dev/IBMtape0, /dev/IBMtape0n, or /dev/IBMchanger0. 3. Enter the Read/Write, Read Only, Write Only, or Append mode to open a device. These modes apply only to the tape devices. Append mode uses Write Only for file access permission. After you open a device, select a command using the appropriate number for the command from the window. Some commands require additional information after they are selected from the window. If an error occurs running the command, the error number, the error text, and the device sense data (if applicable) are displayed. Command-Line Mode The command-line mode for the tape utility program (IBMtapeutil) provides the same basic tape and changer commands as the interactive mode. Invoke the IBMtapeutil command from the Linux command line or within a shell script. If you enter the IBMtapeutil command without any arguments, the interactive mode is invoked. The syntax for the command-line mode of the tape utility program is: IBMtapeutil -f Device Subcommand [Subcommand ...] Note: 1. Device is the name of the device special file (for example, /dev/IBMtape0). 2. Subcommand is any valid command for the device. Multiple subcommands can be combined in a single command to perform more than one operation. The subcommands are processed one at a time in the order specified on the command line. For help information about the subcommands and their syntax, enter the IBMtapeutil ? command on the Linux command line. Figure 105 on page 386 is an example of the help information that is displayed. Appendix D. Tape Utility Programs 385