AIX命令参考大全，卷 2，d - h

errinstall 命令

用途

在错误日志消息集中安装消息。

语法

errinstall [ -c ] [ -f ] [ -q ] [ -z FileName ] File

描述

errinstall 命令是一个安装帮助，可以帮助您在错误日志消息编目的错误描述、可能原因、用户原因、安装原因、失败原因、推荐操作和详细数据 ID 消息集中添加或替换消息。

File 参数指定了含有要被添加或替换消息的输入文件。如果不指定 File 参数或把其指定为 -（减号）, errinstall 命令从标准输入读取。

注意：程序产品和内部应用程序应该使用错误日志消息集中的预定义消息。要列出预定义消息，用 errmsg -w 命令。要添加新消息，第三方软件供应商应该和 IBM 解决方案开发者联系来注册新消息。在内部应用程序的开发中，可以用 errmsg 命令来添加新消息，但是一定不能和为其他内部应用程序添加的消息冲突。

撤销功能

errinstall 命令在当前目录下创建一个撤销文件，名为 File.undo 文件。(如果 errinstall 命令从标准输入读入消息，则撤销文件的信息被写到标准输出。)File.undo 文件可以作为 errinstall 命令的输入来使用，用来撤销 errinstall 命令刚刚产生的改变。要撤销改变，运行 errinstall 命令，带有 -f 标志并指定 File.undo 文件为 File 参数。

输入文件（或标准输入）文件格式

要求有两行单独的信息来添加或替换错误日志消息编目中的单一的消息。您可以在单一文件中包含多条附加消息或替代消息。第一行是用来指定要被添加或替换到哪一个消息集的，用下面的格式：

SET MessageSetID

这里 MessageSetID 参数是下列单字符之一：

第二行列出要被添加或替换的消息和消息 ID。至少要求一行，也可以包含多行，跟在标志消息集的单行后面。如前面所说，用户应该和他们的服务代表联系来获得消息 ID，除非此消息只在内部应用程序中使用（在此情况下，用 errmsg 命令来安装不带预定义错误消息 ID 的错误消息）。

必须在消息 ID 和消息文本之间加一个空格，并且把消息文本用双引号括起来，如下：

消息 ID "消息文本"

除了必须的两行信息行以外，还可以包含注释行。一个注释行必须在第一列以 $ (美元符号)或*（星号）开头。优先选择星号开头。

注意： 添加到错误描述、可能原因和详细数据 ID 消息集中的消息不能超过 40 个字符长度。添加到用户原因、安装原因、失败原因和推荐操作消息集里的消息在长度上不能超过128个字符。如果超长，errinstall 命令会显示一个警告消息，但把消息添加到代码点目录里。这些消息会在用 summary errpt 命令显示时被截断。

标志

安全性

访问控制：只有 root 用户才能运行这个命令。

示例

1. 要为已经注册的产品 lpp 安装错误日志消息,输入：

   errinstall -f /tmp/lpp.desc

2. 要撤销由上面的例子 errinstall 命令对错误日志消息编目所作的改变，请输入：

   errinstall -f /tmp/lpp.desc.undo

3. 要在可能原因消息集中安装一错误消息，请输入：

   errinstall
    
   * 为 widget 故障增加一条可能的原因：SET P 
   E100 "widget adapter"

4. 要在可能原因消息集中用重复 ID 替换一条消息，请输入：

   errinstall -f
    
   * 在推荐操作消息集中
   * 替换和 ID E100 有关的消息
   SET R
   E100 "Replace disk drive"

5. 如果命名输入文件为 in_file 然后想用它来安装新的错误消息，请输入：

   errinstall in_file

6. 要覆盖消息集中存在的错误消息，使用在 in_file 文件中以前定义的 ID 号码,并且指定带有的 -f 标志 errinstall 命令如下：

   errinstall -f in_file

7. 下面的例子说明要安装的输入文件的样本内容。

   *
   * Add these error messages to the Detailed Data message set:
   *
   SET D
   8105 "Logical channel number"
   8106 "Timer reference stamp"
   *
   * Add these error messages to the Probable Cause message set:
   *
   SET P 
   E861 "Bad memory card"
   E865 "Unexpected System Halt"
   E876 "Fiber Optic Cable"
   *
   * Add this message to the Recommended Action message set:
   *
   SET R
   E850 "Install updated driver code"

文件

相关信息

errclear 命令，errdead 命令，errlogger 命令，errmsg 命令，errpt 命令，errstop 命令，errupdate 命令。

errdemon守护进程。

errsave内核服务。

errlog子例程。

error logging 特殊文件。

AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs 中的 Error Logging Overview