[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

General Programming Concepts: Writing and Debugging Programs


Error Logging Controls

You can control the error logging facility by using the following:

Error Logging Commands


errclear
                           Deletes entries from the error log. This command can erase the entire error log. Removes entries with specified error ID numbers, classes, or types.
errdead
                           Extracts errors contained in the /dev/error buffer captured in the system dump. The system dump will contain error records if the errdemon daemon was not active prior to the dump.
errdemon
                           Reads error records from the /dev/error file and writes error log entries to the system error log. The errdemon also performs error notification as specified in the error notification objects in the Object Data Manager (ODM). This daemon is started automatically during system initialization.
errinstall
                           Can be used to add or replace messages in the error message catalog. Provided for use by software installation procedures. The system creates a backup file named File.undo. The undo file allows you to cancel the changes you made by issuing the errinstall command.
errlogger
                           Writes an operator message entry to the error log.
errmsg
                           Implements error logging in in-house applications. The errmsg command lists, adds, or deletes messages stored in the error message catalog. Using this command, text can be added to the Error Description, Probable Cause, User Cause, Install Cause, Failure Cause, Recommended Action, and Detailed Data message sets.
errpt
                           Generates an error report from entries in the system error log. The report can be formatted as a single line of data for each entry, or the report can be a detailed listing of data associated with each entry in the error log. Entries of varying classes and types can be omitted from or included in the report.
errstop
                           Stops the errdemon daemon, which is initiated during system initialization. Running the errstop command also disables some diagnostic and recovery functions of the system.
errupdate
                           Adds or deletes templates in the Error Record Template Repository. Modifies the Alert, Log, and Report attributes of an error template. Provided for use by software installation procedures.

Error Logging Subroutines and Kernel Services


errlog
                           Writes an error to the error log device driver.
errsave and errlast
                           Alllows the kernel and kernel extensions to write to the error log.

Error Logging Files


/dev/error
                           Provides standard device driver interfaces required by the error log component.
/dev/errorctl
                           Provides nonstandard device driver interfaces for controlling the error logging system.
/usr/include/sys/err_rec.h Contains structures defined as arguments to the errsave kernel service and the errlog subroutine.
/var/adm/ras/errlog Stores instances of errors and failures encountered by the system.
/var/adm/ras/errtmplt Contains the Error Record Template Repository.

Related Information

The "Error Notification Object Class" in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs allows applications to be notified when particular errors are recorded.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]