IBM TS2340 User Guide - Page 62
Log File, Tape Log Utility, Reservation Conflict Logging, Refer to Tape Drive, Media
UPC - 883436006873
View all IBM TS2340 manuals
Add to My Manuals
Save this manual to your list of manuals |
Page 62 highlights
AIX Device Driver (Atape) Refer to "Tape Drive, Media, and Device Driver Parameters" on page 28 for a description of these parameters. Each time the rewind and unload sequence occurs or the STIOC_LOG_SENSE ioctl command is issued, an entry is added to the log. Each time a new cartridge is loaded, the values in the device log buffers are reset with the Log Sense command. The log data is gathered on a per-volume basis. Log File The data is logged in the /usr/adm/ras directory. The file name is dependent on each device; therefore, each device has a separate log. An example of the rmt1 device file is: /usr/adm/ras/Atape.rmt1.log The files are in binary format. Each entry has a header followed by the raw Log Sense pages as defined for a particular device. The first log page is always page 0x00. This page, as defined in the SCSI-2 ANSI specification, contains all pages the device supports. Page 0x00 is followed by all pages specified in page 0x00. The format of each following page is defined in the SCSI specification and the device manual. Tape Log Utility A tape log utility is installed with the tapelog device driver that displays the contents of the log file in ASCII text. The log pages are displayed as hexadecimal values in dump format. The C source code (tapelog.c) for the program is in the /usr/lpp/Atape/samples directory. The program contains a sample of the interface to the log file and the structure used to read the file. The syntax for the tape log utility is: tapelog -l Name [-d] or tapelog -f File [-d] Notes: 1. Name is the logical name of the device (such as rmt0). 2. File is the name of a log file (such as Atape.rmt0.log). 3. The -d parameter, if used, deletes the log file for the specified device. The contents of the log file are displayed as standard output. To save the log in a file, use the AIX redirection function. For example: tapelog -l rmt0 > rmt0.log Reservation Conflict Logging When the device driver receives a reservation conflict during open or after the device has been opened it will log a reservation conflict in the AIX error log. Prior to logging the error the device driver will issue a Persistent Reserve In command to determine if a SCSI Persistent Reservation is active on the reserving host to get the reserving host initiator WWPN (World Wide Port Name) and reserve key. If successful, the device driver will log this information as follows: Reserving host key xxxxxxxx WWPN xxxxxxxx Where the first xxxxxxxx is the actual reserve key and the second xxxxxxxx is the reserving host initiator WWPN. 44 IBM Tape Device Drivers Installation and User's Guide