errclear Command

AIX Version 4.3 Commands Reference, Volume 2

errclear Command

Purpose

Deletes entries from the error log.

Syntax

errclear [ -d ErrorClassList ] [ -i File ] [ -J ErrorLabel [ ,Errorlabel ] ] | [ -K ErrorLabel [ ,Errorlabel ] ] [ -l SequenceNumber ] [ -m Machine ] [ -n Node ] [ -N ResourceNameList ] [ -R ResourceTypeList ] [ -S ResourceClassList ] [ -T ErrorTypeList ] [ -y FileName ] [ -j ErrorID [ ,ErrorID ] ] | [ -k ErrorID [ ,ErrorID ] ] Days

Description

The errclear command deletes error-log entries older than the number of days specified by the Days parameter. To delete all error-log entries, specify a value of 0 for the Days parameter.

If the -i flag is not used with the errclear command, the error log file cleared by errclear is the one specified in the error log configuration database. (To view the information in the error log configuration database, use the errdemon command.)

You can use the Web-based System Manager System application (wsm system fast path) to run this command. You could also use the System Management Interface Tool (SMIT) smit errclear fast path to run this command.

Flags

-d List	Deletes error-log entries in the error classes specified by the List variable. The List variable values can be separated by , (commas), or enclosed in " " (double quotation marks) and separated by , (commas) or space characters. The valid List variable values are H (hardware), S (software), O (errlogger messages), and U (undetermined).
-i File	Uses the error-log file specified by the File variable. If this flag is not specified, the errclear command uses the value from the error-log configuration database.
-j ErrorID[,ErrorID]	Deletes the error-log entries specified by the ErrorID (error identifier) variable. The ErrorID variable values can be separated by , (commas), or enclosed in " " (double quotation marks) and separated by , (commas) or space characters.
-J ErrorLabel	Deletes the error-log entries specified by the ErrorLabel variable. The ErrorLabel variable values can be separated by , (commas), or enclosed in " " (double quotation marks) and separated by , (commas) or space characters.
-k ErrorID[,ErrorID]	Deletes all error-log entries except those specified by the ErrorID (error identifier) variable. The ErrorID variable values can be separated by , (commas), or enclosed in " " (double quotation marks) and separated by , (commas) or space characters.
-K ErrorLabel	Deletes all error-log entries except those specified by the ErrorLabel variable. The ErrorLabel variable values can be separated by , (commas), or enclosed in " " (double quotation marks) and separated by , (commas) or space characters.
-l SequenceNumber	Deletes error-log entries with the specified sequence numbers. The SequenceNumber variable values can be separated by , (commas), or enclosed in " " (double quotation marks) and separated by , (commas) or space characters.
-m Machine	Deletes error-log entries for the machine specified by the Machine variable. The uname -m command returns the value of the Machine variable.
-n Node	Deletes error-log entries for the node specified by the Node variable. The uname -n command returns the value of the Node variable.
-N List	Deletes error-log entries for the resource names specified by the List variable. For hardware errors, the List variable is a device name. For software errors, the List variable is the name of the unsuccessful executable. The List variable values can be separated by , (commas), or enclosed in " " (double quotation marks) and separated by , (commas) or space characters.
-R List	Deletes error-log entries for the resource types specified by the List variable. For hardware errors, the List variable is a device type. For software errors, the value of the List variable is LPP. The List variable values can be separated by , (commas), or enclosed in " " (double quotation marks) and separated by , (commas) or space characters.
-S List	Deletes error-log entries for the resource classes specified by the List variable. For hardware errors, the List variable is a device class. The List variable values can be separated by , (commas), or enclosed in " " (double quotation marks) and separated by , (commas) or space characters.
-T List	Deletes error-log entries for error types specified by the List variable. Valid List variable values are: PERM, TEMP, PERF, PEND, INFO, and UNKN. The List variable values can be separated by , (commas), or enclosed in " " (double quotation marks) and separated by , (commas) or space characters.
-y FileName	Uses the error-record template file specified by the FileName variable.

Security

Access Control: Only the root user can run this command.

Examples

To delete all entries from the error log, enter:
```
errclear 0
```
To delete all entries in the error log classified as software errors, enter:
```
errclear -d S 0
```
To clear all entries from the alternate error-log file /var/adm/ras/errlog.alternate , enter:
```
errclear -i /var/adm/ras/errlog.alternate 0
```
To clear all hardware entries from the alternate error-log file /var/adm/ras/errlog.alternate , enter:
```
errclear -i /var/adm/ras/errlog.alternate -d H 0
```

Files

/etc/objrepos/SWservAt

Contains the Software Service Aids Attributes object class, which is the error-log configuration database.

Related Information

The errdead command, errinstall command, errlogger command, errmsg command, errpt command, errstop command, errupdate command, uname command.

The errdemon daemon.

The errsave kernel service.

The errlog subroutine.

Error Logging Overview in AIX Version 4.3 Problem Solving Guide and Reference.

Setting up and running Web-based System Management in AIX Version 4.3 System Management Guide: Operating System and Devices.