Adds a message to the error log message catalog.
errmsg [ -c ] [ -z FileName ] [ -w Set_List | File ]
The errmsg command updates and displays the error-log message catalog containing the Error Description, Probable Cause, User Cause, Install Cause, Failure Cause, Recommended Action, and Detailed Data ID message sets.
The message sets to which messages are to be added or deleted are listed in the input File parameter as follows:
Messages added to the Error Description, Probable Cause, and Detailed Data ID message sets must not exceed 40 characters in length. Messages added to the User Cause, Install Cause, Failure Cause, and Recommended Action message sets must not exceed 128 characters in length. A maximum of 2047 user-defined messages can be added to each message set.
The errmsg command is used by application developers to create new messages used in the Error Record Templates Repository. An existing message should always be used, if possible.
If no flags are specified on the command line, the default operation is an update. Updates are specified in the input File parameter. If the input File parameter is not specified or if a - (minus sign) is specified instead of the File parameter, the errmsg command reads from standard input. For each message that is added, the errmsg command assigns an identifier. In addition to adding the message to the message catalog, the errmsg command writes the identifier and message text to the File.out file. The File.out file is also created when deletions are made from the message catalog. If the errmsg command is reading from standard input, the identifier and message text are written to standard output.
Access Control: Only the root user can run this command.
errmsg * Delete messages FF1A, FF1B, and FF1C from the Probable Cause * message set SET P - FF1A - FF1B - FF1C
errmsg * Add a Probable Cause for Widget Failure SET P + "WIDGET ADAPTER"
/usr/lib/nls/msg/$LANG/codepoint.cat | Contains the error log message catalog. In the United States, the value of $LANG is En_US. |
The errclear command, errdead command, errinstall command, errlogger command, errpt command, errstop command, errupdate command.
The errdemon daemon.
The errsave kernel service.
The errlog subroutine.
The error logging special files.
Error Logging Overview in AIX Version 4.3 Problem Solving Guide and Reference.