Content-type: text/html Man page of dia

dia

Section: (8)
Updated:
Index Return to Main Contents
 

NAME

dia - DECevent: event report formatter  

SYNOPSIS

/usr/sbin/dia [ options ... ]  

FLAGS

Performs bit-to-text translation on an event file. This switch is mutually exclusive with -b, -c, and -d with -a being the default. Reads input file(s) and creates a single binary output file. The name of the binary file is specified with the -b flag. This switch is mutually exclusive with -a, -c, and -d with -a being the default. Reads events directly from the error log deamon process. This switch is mutually exclusive with -a, -b, and -d. Produces output in Hex format. Switch is mutually exclusive with -b, -a, and -c. Selects event file entries by the position within the event file. Provides for alternate input event log file(s). This parameter can be a single OSF/1 file specification or a list of file specifications separated by spaces. Use of wild carding ("*") is also allowed. Selects event file entries by host name or sets the host name for set sys. Includes event entries to be processed from the selection criteria given. Allows the user to enter DECevent's interactive shell. Places all event entries failing selection criteria for a command into a specified file (binary format). The name of the binary output file is specified as an optional parameter to the -j flag. If no file name is provided the file name defaults to the first named input file with a .rej extention. Can only be used with -b. Output event in full, brief, terse, fsterr, or summary report format. The default is full. Summary output type is not valid when used in conjunction with -c flag. All possible information. Key information on each event entry. Labeled information with no translations. Key information on selected IO devices. Statistical summary of event entries in the event file. Causes the event file to be read in reverse order. Selects event file entries that have occurred in the time specified. Selects and formats all event reports that occurred before, after or in the time window specified. Time is specified as an absolute time in the following formats: (dd-mmm-yyyy[:hh:mm:ss] Provides informational message about the number of entries selected and rejected while the file is being processed. Excludes event entries from being processed based on the selection specification. Redirects the output from the default system output to the specified file (outfile). The following is a list of valid keywords that may be used with the -i or -x flags. Each keyword may be followed by a value. For example: -i OS=OSF.

bugcheckscacheconfigurations
control_entriescpusdates
device_errorsdevice_numberdisks
environmental_entrieshostsinformationals
iosio_subsystemsmchks
machine_checksmemorynodes
ososf_entryoperating_systems
pwrpowersequence_numbers
swisoftware_informationalssync_communications
tapesunknown_entries
 

COMMANDS

Provides information from the internal help facility. Returns a list of all the event, canonical or report rulesets known to DECevent. List all of the event rulesets that are stored in the Event to Canonical (ETC) knowledge library. List all the canonical rulesets that are stored in the canonical to report (CTR) knowledge library. Allows users to customize system settings. All set commands must be executed from the interactive command shell and should be followed by a sav command. The following are valid set commands: Allows users to select an event log file to use for retrieving event reports to be formatted. This command allows users to override the locale that has been defined for the current session. Save current local customization settings in a defaults file. Interactive mode only. Save current system customization settings in the system defaults file. Interactive mode only. Show version information about data contained in the knowledge libraries residing in the DIA_LIBRARY directory. It shows version, build date, and platform information for each knowledge file. Display the contents of the knowledge library pertaining to keyword selections. If no selection argument given, all selections are printed. Displays DECevent internal parameters. If no setting argument given, all settings are printed. Undo any customizations that have been set since the last time the customization file was saved. Interactive mode only. Restores the system customizations. Interactive mode only.  

ADDED VALUE COMMANDS

Adds an entry to one of the DECevent's external notification lists. Full pathname of an OSF script file that performs external notification. Can be one of the following case-sensitive values: customer or reserved. Adds a user name to one or all of the notification mailing list. User names can be added to any of the mailing lists except the SICL mailing list which is reserved for Digital use only. Name of user to be added to the mailing list. Must be one of the following case-sensitive names: customer, fse, monitor, or sicl. If not mailing list is provided, the username will be added to all mailing lists except for sicl. Provides analysis of event log files or real time analysis of the event logging utilities. The following flags are legal for use with the ana command: -f, -v, -e, -i, -x, -H, -t. Clears analysis information about the analysis state database. Causes DECevent to ignore a device or device type. Either the -n or -t flags must be present. Name of device to be ignored. Mutually exclusive with -t. Type of device to be ignored. Mutually exclusive with -n. Causes DECevent to resume monitoring a device or devices of a certain type. Name of device to monitor. Mutually exclusive with -t. Type of device to monitor. Mutually exclusive with -n. Reset analysis information for a repaired device. Name of device to be repaired. Mutually exclusive with -t. Type of device to be repaired. Mutually exclusive with -n. Purge repaired information from the analysis database. Purge system information from the analysis database . hostname is the name of the node to be purged. Removes an entry to one of the DECevent's external notification lists. Full pathname of an OSF script file that performs external notification. Can be one of the following case-sensitive values: customer or reserved. Remove a user from a specific notification mailing list. Name of user to be removed from the mailing list. Must be one of the following case-sensitive names: customer, fse, monitor, or sicl. If no list is specified, then will remove username from all mailing lists except for sicl. Starts up automatic analysis and notification. Shuts down automatic analysis and notification. Sets the phone number of the Digital Customer Support Center (CSC). Sets the SICL notification state. state must be one of the following case-sensitive values: on or off. Sets the Digital or customer threshold levels for a device or a device type. Sets the threshold for the named device. Mutually exclusive with -t. Sets the threshold for the device type. Mutually exclusive with -n. Sets the severity level which can be one of the following case-sensitive values: hard, soft, info, or media. Sets the Digital threshold. Sets the customer threshold. The value of the threshold. Shows entries made by Field Engineer for a particular repaired device or for all devices. Name of device to show. If the -n flag is omitted, all repaired devices are shown. Shows parameter information used for the notification process. Shows all devices for which notification has been performed. Shows DECevent's external notification entries. If no list is provided then all entries will be displayed. list can be one of the following case-sensitive values: customer or reserved. Show the current threshold settings for a particular device, device type, or all devices. The name of the device whose threshold is to be displayed. Mutually exclusive with -t. The device type whose threshold is to be displayed. Mutually exclusive with -n. Displays the device types that the fault manager is capable of monitoring. Subsystem can be one of the following case-sensitive values: cpu or ios. Displays the contents of the various notification distribution lists. If the -m flag is omitted then all of the mailing lists will be displayed. Mailing list can be one of the following case-sensitive values: customer, fse, monitor or sicl. Displays a list of all devices for which DECevent has performed automatic analysis and indicated faults. Shows the sicl notification state. Exercise external notification scripts. Send a test message to members on a notification distribution list. Mailing list can be one of the following case-sensitive values: customer, fse, monitor. Mutually exclusive with -s and -e. Send a test SICL message to the CSC. Mutually exclusive with -m and -e. Sends an external notification to destination. Mutually exclusive -m and -s.  

DESCRIPTION

The dia command (DECevent) provides the interface between a user and the operating system's event logger. DECevent provides the following two main functions: DECevent allows you to translate events into ASCII reports derived from system event entries (bit-to-text translations.) Translation and reporting information can be found in the DECevent Translation and Reporting Utility for OSF User and Reference Guide. DECevent constantly monitors system events in an effort to identify failing device components through analysis and notifies the proper individuals of a potential problem, if necessary.

The DECevent utility has the following features relating to the translation of events: Translating event log entries into readable reports. Selecting input and output sources Filering input events. Selecting alternate reports. Translating events as they occur. Maintaining and customizing the user environment with the interactive shell commands.

The added value functionality of DECevent provides constant monitoring of a system's event logger. When an event occurs, automatic analysis of the event is performed. Automatic analysis results in the generation of Digital specific theory codes, which enables Multivendor Customer Services to identify one or more failing field replaceable units (FRU). DECevent also allows manual analysis of a user-supplied event log.

The DECevent added value command options allow the following features: Event analysis. Event notification. Customizing the DECevent environment.

 

RESTRICTIONS

 

EXAMPLES

Translate events from event file "binary_errlog.old" dia -f /usr/adm/binary_errlog.old

Produce a brief event report starting with the fourth through the tenth event. dia -f /usr/adm/errlog.bin -o brief -e s:4 e:10

Select disk errors from errlog.old and put them into the binary file disk.bin dia -b disk.bin -f errlog.old -i disk

Dump events from event file "errlog.old" that include disk error and write them to an output file named "errlog.dmp" dia -d -f errlog.old -i disk > errlog.dmp

Include RA disks in the output. dia -i disk=RA

Incluse all disks in output except for RA. dia -i disk -x disk=RA

List out the various report types in the report knl. dia ls rpt

List of various report types from interactive prompt. dia> ls rpt

Select events since the start time. dia -t s:time

Select events before the end time. dia -t e:time

Select events in the time window indicated. dia -t s:time e:time

Exclude all tapes in the output. dia -x tape  

ADDED VALUE COMMAND EXAMPLES

Add a user (smith) to a specific notification mailing list (customer). dia ad usr -u smith -m customer

Remove an entry (/usr/users/test/external_not) to one of DECevent's external notification lists (customer). dia rm ext -f /usr/users/test/external_not -l customer

Perform manual analysis on events from an event file (/usr/adm/binary_errlog.old). dia ana -f /usr/adm/binary_errlog.old

Set system information for a node (cxaiag). dia set sys -s w7834E42 -H cxaiag "DEC 5000"

Set Digital threshold level at 4 for all RA90 disk drives. dia set thr -t RA90 -s hard -d 4

Show all the io devices that DECevent is capable of monitoring. dia shw typ -s ios

Reset analysis information for a device (rz02) that has been repaired. dia rep -n rz02 -t 12-dec-1993 "Replaced HDA assembly"  

FILES

/usr/adm/binary.errlog
default event log file
/etc/binlog.conf
binlogd configuration file
 

RELATED INFORMATION

binlogd(8)

syslogd(8)

logger(1)


 

Index

NAME
SYNOPSIS
FLAGS
COMMANDS
ADDED VALUE COMMANDS
DESCRIPTION
RESTRICTIONS
EXAMPLES
ADDED VALUE COMMAND EXAMPLES
FILES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:41 GMT, October 02, 2010