NAME

sefdata - Collects System Error Facility (SEF) data for Oracle HSM file systems

SYNOPSIS

∕var∕opt∕SUNWsamfs∕sef∕sefdata
#include "∕opt∕SUNWsamfs∕include∕sefvals.h"
#include "∕opt∕SUNWsamfs∕include∕sefstructs.h"

AVAILABILITY

SUNWsamfs

DESCRIPTION

The sefdata file contains the data gathered from the log sense pages of peripheral tape devices used by Oracle HSM file systems. Each time the Oracle HSM software unloads a cartridge from a drive, pertinent log sense pages are obtained from the device, and a record is written to the sefdata file. Each record consists of a header followed by some number of log sense pages.

The record header has the format of a sef_hdr structure. This structure is defined in ∕opt∕SUNWsamfs∕include∕sefstructs.h, and it has the following components:

struct sef_hdr {
    uint_t      sef_magic;          ∕* magic # for app to sync file posn *∕
    uint_t      sef_version;        ∕* version number *∕
    uint_t      sef_size;           ∕* size of this record, excl. header *∕
    uint16_t    sef_eq;             ∕* equipment number of this device *∕
    char        sef_devname[128];   ∕* pathname of device *∕
    uchar_t     sef_vendor_id[9];   ∕* vendor id from inquiry *∕
    uchar_t     sef_product_id[17]; ∕* product id from inquiry *∕
    uchar_t     sef_revision[5];    ∕* revision level from inquiry *∕
    uchar_t     sef_scsi_type;      ∕* device type from inquiry *∕
    vsn_t       sef_vsn;            ∕* vsn of media that was mounted *∕
    time_t      sef_timestamp;      ∕* timestamp of this record *∕
}

The fields of the sef_hdr structure have the following meanings:

sef_magic: Has the value SEFMAGIC, as defined in ∕opt∕SUNWsamfs∕include∕sefvals.h.
sef_version: Has the value SEFVERSION, as defined in ∕opt∕SUNWsamfs∕include∕sefvals.h.
sef_size: The size of this record, excluding the header.
sef_eq: The equipment number of the device, as configured in the mcf file. For more information, see the mcf (4) man page.
sef_devname: A character string containing the path name of the device.
sef_vendor_id: The vendor identification of the device, as obtained from inquiry.
sef_product_id: The product identification of the device, as obtained from inquiry.
sef_revision: The revision level of the device, as obtained from inquiry.
sef_scsi_type: The device type, as obtained from inquiry.
sef_vsn: Volume Serial Name (VSN) of the volume mounted in the device when the data was generated.
sef_timestamp: Time that this record as written to the data file.

Following the header in each record is some number of log sense pages. Each log sense page consists of a SCSI-standard header followed by triplets of parameter codes, control values, and parameter values. For the exact format of the log sense pages returned by the devices in use at your site, consult the documentation provided with those devices.

FILES

File: Purpose
∕var∕opt∕SUNWsamfs∕sef∕sefdata: Contains SEF information.
∕opt∕SUNWsamfs∕include∕sefvals.h: Contains values, such as those for SEFMAGIC and SEFVERSION.
∕opt∕SUNWsamfs∕include∕sefstructs.h: Contains include files for the SEF header, the SCSI-standard header, and other structures.