| Skip Navigation Links | |
| Exit Print View | |
|
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
| Skip Navigation Links | |
| Exit Print View | |
|
|
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
NAME
sefreport - Displays the content of the System Error
Facility (SEF) log
SYNOPSIS
/opt/SUNWsamfs/sbin/sefreport [-v|-t] -d file
AVAILABILITY
SUNWsamfs
DESCRIPTION
The sefreport command reads the content of a SAM-QFS SEF log
file and writes its output to stdout in a human-readable
format. By default, the log file is
/var/opt/SUNWsamfs/sef/sefdata. The SEF log file contains
the data gathered from the log sense pages of peripheral
tape devices used by SAM-QFS file systems. For more
information on the SEF log file, including its content and
format, see the sefdata(4) man page.
The sefreport command reads the input file specified by the
file argument. If no other options are specified, the
sefreport command examines the SEF log file and generates
the following information for each record contained in file:
o The first header line states the record number, which is
its ordinal position in the file.
o The second header line contains the timestamp of the
record, the vendor name of the device from which the log
sense data was received, the product name of the device,
the revision level of the device's firmware, the string
VSN, and the Volume Serial Name (VSN) of the volume
mounted in the device when the log sense data was
generated.
Following the header lines, the log sense data for each page
in the record is printed. For each log sense page, a line
identifying the page code is printed, followed by a line of
column headings. The data is then printed in three columns
per line with the following headings: parameter code,
control, and parameter value. All data is generated in
hexadecimal notation. For the meanings of the parameter
codes, control bits, and parameter values, see your vendor
documentation for the specific device.
OPTIONS
This command accepts the following options:
-d Includes additional device information. For each
record, the command generates a third header line that
identifies the equipment number of the device as
configured in the mcf file and the path name of the
device.
-t Generates log sense output with text descriptions. On
each line of log sense data output, an additional
string containing the equipment number, page code, VSN,
and parameter code description is printed. The -t
option is not used when the -v option is specified.
-v Generates verbose output. On each line of log sense
data output, an additional string containing the
equipment number, page code, and VSN is printed. This
string is enclosed in parentheses and the items are
colon-separated.
OPERANDS
This command accepts the following operand, which must be
specified:
file Specifies the SEF log file. The SEF log file can
be read from its default location
(/var/opt/SUNWsamfs/sef/sefdata) or it can be
redirected to another file for SEF processing.
EXAMPLES
Example 1. Assume that your system is set up to write SEF
values to file /var/opt/SUNWsamfs/sef/sefdata.mid. You have
entered the following command to write the SEF data using
the report formatter:
srvr# sefreport /var/opt/SUNWsamfs/sef/sefdata.mid > ~mydir/sef.short
The file ~mydir/sef.short is as follows:
Record no. 1
Mon Mar 26 11:17:48 2001 STK 9840 1.25 VSN 002981
PAGE CODE 2
param code control param value
00h 74h 0x0
01h 74h 0x0
02h 74h 0x0
03h 74h 0x0
04h 74h 0x0
05h 74h 0x40050
06h 74h 0x0
PAGE CODE 3
param code control param value
00h 74h 0x0
01h 74h 0x0
02h 74h 0x0
03h 74h 0x0
04h 74h 0x0
05h 74h 0x140
06h 74h 0x0
PAGE CODE 6
param code control param value
00h 74h 0x0
Record no. 2
Mon Mar 26 11:30:06 2001 STK 9840 1.25 VSN 002999
PAGE CODE 2
param code control param value
00h 74h 0x0
01h 74h 0x0
02h 74h 0x0
03h 74h 0x0
04h 74h 0x0
05h 74h 0x1400a0
06h 74h 0x0
PAGE CODE 3
param code control param value
00h 74h 0x0
01h 74h 0x0
02h 74h 0x0
03h 74h 0x0
04h 74h 0x0
05h 74h 0x190
06h 74h 0x0
PAGE CODE 6
param code control param value
00h 74h 0x0
<<<NOTE: This output has been truncated for inclusion on this
man page.>>>
Example 2: Assume that you also need to produce a report
with additional data. You can use the same log file as in
Example 1, but you want this report to contain more
information than sef.short, so you invoke sefreport with the
-d and -v options. The following command is entered:
srvr# sefreport -d -v /var/opt/SUNWsamfs/sef/sefdata.mid > ~mydir/sef.long
The file ~mydir/sef.long is as follows:
Record no. 1
Mon Mar 26 11:17:48 2001 STK 9840 1.25 VSN 002981
Eq no. 32 Dev name /dev/rmt/1cbn
rec pg cd param code control param value
1 2 00h 74h 0x0 (32:2:002981)
1 2 01h 74h 0x0 (32:2:002981)
1 2 02h 74h 0x0 (32:2:002981)
1 2 03h 74h 0x0 (32:2:002981)
1 2 04h 74h 0x0 (32:2:002981)
1 2 05h 74h 0x40050 (32:2:002981)
1 2 06h 74h 0x0 (32:2:002981)
rec pg cd param code control param value
1 3 00h 74h 0x0 (32:3:002981)
1 3 01h 74h 0x0 (32:3:002981)
1 3 02h 74h 0x0 (32:3:002981)
1 3 03h 74h 0x0 (32:3:002981)
1 3 04h 74h 0x0 (32:3:002981)
1 3 05h 74h 0x140 (32:3:002981)
1 3 06h 74h 0x0 (32:3:002981)
rec pg cd param code control param value
1 6 00h 74h 0x0 (32:6:002981)
Record no. 2
Mon Mar 26 11:30:06 2001 STK 9840 1.25 VSN 002999
Eq no. 31 Dev name /dev/rmt/0cbn
rec pg cd param code control param value
2 2 00h 74h 0x0 (31:2:002999)
2 2 01h 74h 0x0 (31:2:002999)
2 2 02h 74h 0x0 (31:2:002999)
2 2 03h 74h 0x0 (31:2:002999)
2 2 04h 74h 0x0 (31:2:002999)
2 2 05h 74h 0x1400a0 (31:2:002999)
2 2 06h 74h 0x0 (31:2:002999)
rec pg cd param code control param value
2 3 00h 74h 0x0 (31:3:002999)
2 3 01h 74h 0x0 (31:3:002999)
2 3 02h 74h 0x0 (31:3:002999)
2 3 03h 74h 0x0 (31:3:002999)
2 3 04h 74h 0x0 (31:3:002999)
2 3 05h 74h 0x190 (31:3:002999)
2 3 06h 74h 0x0 (31:3:002999)
rec pg cd param code control param value
2 6 00h 74h 0x0 (31:6:002999)
<<<NOTE: This output has been truncated for inclusion on this
man page.>>>
FILES
/var/opt/SUNWsamfs/sef/sefdata
The default system error facility log
file for SAM-QFS file systems.
SEE ALSO
mcf(4), sefdata(4), sefsysevent(4).
|