sefreport - Displays the content of the System Error Facility (SEF) log
∕opt∕SUNWsamfs∕sbin∕sefreport
[-v|-t
]
-d
file
SUNWsamfs
The sefreport
command
reads the content of an Oracle HSM 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 Oracle HSM 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:
The first header line states the record number, which is its ordinal position in the file.
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.
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.
This command accepts the following operand, which must be specified:
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.
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.>>
∕var∕opt∕SUNWsamfs∕sef∕sefdata
The default system error facility log file for Oracle HSM file systems.