Extended Inquiry Record Layout and Reporting

Previous  Top  Next

This file lets you report vendor-specific information from any or all inquiry pages. Results will appear in the Additional Drive Information box for SCSI devices. Reporting is done through the additional drive information box on the right side of the main inquiry screen. All reported data will be appended to the bottom of the list box.

INQUIRYDB.TXT Record Layout
General Information:
·All records starting with a # are comments, and the data is ignored. Comments may appear anywhere in the file, with the exception of the first record which identifies the version. Do NOT make changes to this record.  
·Put all disk drives in alphanumeric order, sorted by manufacturer.  
·The first record for a particular drive consists of the single word BEGIN, and the last record must consist of the word END.  
·All command records, BEGIN, END, MAKE, MODEL, etc... must be in upper case.  
·A single wild-card character, "*", may appear at the end of the MAKE or MODEL string identifier. Examples might be IBM*, or DDRS*.  

Make and Model Fields
After the
BEGIN statement, and any subsequent comment records, the next record must contain the word MAKE followed by the manufacturer, i.e., MAKE IBM. You must enter only one manufacturer. The software doesn't compare against it, and the make is only used to group disk drives for reporting purposes.

The
MODEL record supports up to 1024 characters, and you may add multiple models corresponding to the sense codes, separated by commas. Example MODEL ST142*,ST141442WX,ST3248*.

Data
All records must have the following format:
pp v ss ll %f Description, where:
·pp:   Inquiry page number. Must be 2 hexadecimal digits  
·v:   Corresponds to the enable vital product data bit. 0 = standard inquiry page, 1 = vital product data page  
·ss:   Starting offset in bytes of field (2 hexadecimal digits)  
·ll:   Length in bytes of field (2 hexadecimal digits)  
·%f:   Format, choose from:  
   %d = 1-8 byte unsigned number,
   
%L = 1-8 byte unsigned number, little endian,
   
%a = ASCII string. [Non-printable characters will be replaced by a single '.' for readability]
   
%b = Binary string. A trailing "b" will be added between each byte
   
%x = hexadecimal field, lower case, trailing "h" will be added (8 byte maximum)

   
%X = hexadecimal field, upper case, trailing "H" will be added (8 byte maximum)

   
%W = hexadecimal IEEE Unique ID. Displays bytes in XX-XX-XX format, where each byte is displayed in upper
    case, and is separated by a dash. This field is typically used to display the WWN of a Fibre channel disk
    drive.

Here is an example:
BEGIN
MAKE IBM
MODEL DGHC*
# Here is some interesting stuff from an IBM DGHC drive
# there are many more fields, but this is what I really need to see
01 1 12 0b %a ASCII Assembly EC:
03 1 08 04 %x Load ID:
03 1 0b 04 %x Release level/modification number:
03 1 10 04 %d PTF Number:
03 1 14 04 %d Patch Number:
03 1 18 04 %a ASCII microcode identifier:
03 1 24 04 %X Servo P/N:
80 1 04 10 %a Unit Serial Number:
82 1 05 08 %a Product identifier (page 80, 8 bytes):
c7 1 0d 01 %b Page C7, offset 0dh Flags:
c7 1 10 03 %X Microcode download size (bytes):
c7 1 4a 02 %X Minutes between spin up/down:
c7 1 4c 04 %a Microcode dataset name for device:
d1 1 04 10 %a Media disk definition:
d1 1 14 10 %a Motor serial number:
d1 1 24 10 %a Flex assembly serial number:
d1 1 34 10 %a Actuator serial number:
d1 1 44 10 %a Device enclosure serial number:
END

Finally, try to group all records together from a particular page and EVPD bit. This will minimize some I/O's, because SMARTMon will check to see if the next parameter is already in the inquiry buffer that was just read.