scsi_trace_decode(1M)

NAME
     scsi_trace_decode - Decodes files produced by enabling the
     trace_scsi option

SYNOPSIS
     /opt/SUNWsamfs/tools/scsi_trace_decode -f trace_file [eq_id]

AVAILABILITY
     SUNWsamtp

DESCRIPTION
     The scsi_trace_decode command decodes the raw SCSI trace
     file produced when the debug trace_scsi option in the
     defaults.conf file is enabled.

OPTIONS
     This command accepts the following options:

     -f trace_file
               Specifies the trace file.  Enter a full path name
               for the trace file.  Typically, the trace file is
               /tmp/sam_scsi_trace_ml_eq_id, where ml_eq_id is
               the Equipment Number of the library that contains
               the devices being traced.

               For example, assume that you have two libraries.
               Their Equipment Numbers are 20 and 50.  Each
               library has two tape drives, and their Equipment
               Numbers are 21, 22, 51, and 52.  You could specify
               that trace information for devices 20, 21, and 22
               go to file /tmp/sam_scsi_trace_20 and that trace
               information for devices 50, 51, and 52 go to file
               /tmp/sam_scsi_trace_50.

     eq_id     Shows entries in trace_file for the device
               identified by Equipment Number eq_id only.  The
               default is to show entries for all Equipment
               Numbers in this trace file.

EXAMPLE OUTPUT
       eq41 Issue 09:22:45 8   cdb: 1b 00 00 00  00 00 00 00  00 00 0000
            Load unload

       eq41 Reply 09:22:45 8   cdb: 1b 00 00 00  00 00 00 00  00 00 00 00
            Load unload
            sense: 71 00 04 00  00 00 00 48  00 00 00 00  44 00 f4 03  0e 16 00 41
                    Sense key 04, ASC 44, ASCQ 00
                    Internal target failure

     The various components of the preceding output are as
     follows:

     Output    Meaning

     eq41      The equipment number involved in the command or
               completion.

     Issue     The scsi command has been issued.

     Reply     The command completed.  Completion status is
               shown.

     09:22:45  The time of day when the command was sent or
               received.

     8         The file descriptor upon which the command was
               issued.  Not useful for non-Oracle Corporation
               analysts.

     cdb       The cdb (command descriptor block): the scsi
               command issued.

     sense     The sense data.  If the command erred, then sense
               data is obtained and displayed.  If the command
               did not err, then this field is all zero.

     Sense key ...
               Decoded sense data, showing the sense key,
               additional sense code, and additional sense code
               qualifier.  These values define the error that
               occurred.

     Internal target failure
               The ASCII representation of the ASC, ASCQ
               information.

SEE ALSO
     defaults.conf(4)