errupdate

PURPOSE

     Updates an error report template.

SYNOPSIS
     errupdate [ file [ -o ] ]

DESCRIPTION

     The errupdate  command adds,  replaces, or  deletes error
     report   format  templates   in  the   file  /etc/errfmt.
     errupdate creates  an undo file in  the current directory
     that it names file.undo.err.  You  can use this undo file
     as input to errupdate with the -o (override) flag to undo
     the changes errupdate has just made.

     The errupdate command adds the extension .err to the file
     name you specify and reads  update commands from the file
     with that  name and extension.   The first field  of each
     template contains an operator:

     +  To add or replace a template
     -  To delete a template.

     If the operation is +,  then the following fields contain
     the template  to be replaced.   If the operation is  a -,
     then  the second  field contains  the class/subclass/mask
     identifier of  the template to delete.   errupdate checks
     for valid  combinations of  identifiers and  writes error
     messages  if it  encounters  invalid combinations.   When
     adding or  replacing, it compares the  version numbers of
     each  input  template  with  the version  number  of  the
     existing template of the same class/subclass/mask and, if
     the  version  number  of  the input  template  is  later,
     replaces the  old template  with the input  template.  If
     the template does not already  exist, then it is added to
     the file.  The input  template must contain an identifier
     line on the first line:

       * /etc/errfmt

     or errupdate  rejects the  input file.  All  delete oper-
     ations are performed before the add/replace operations.

FLAG

     -o Does no version number checking.

EXAMPLE

     The following is an example input file:

       * /etc/errfmt
       + H87 2.0 Native Serial: IODN D2: IOCN D2: Base_Addr D4:\
                Dev_Name A4: \n: Dev_Type X4: DDI_Length D4: Error _Type X1:\
                Last_I/O X1: Line_Status X1: Printer_Status X1:
       - H92

FILES

     /etc/errfmt
     file.err
     file.undo.err

RELATED INFORMATION

     The following command:  "errpt, errpd."

     AIX Operating System Programming Tools and Interfaces.