errinstall 命令

用途

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

语法

errinstall [ -c ] [ -f ] [ -q ] [ -z FileName ] 文件

描述

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

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

撤销功能

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

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

要求有两行单独的信息来添加或替换错误日志消息目录中的单一的消息。 您可以在单一文件中包含多条附加消息或替代消息。 需要第一行来标识要将消息添加到或替换到的消息集。 使用以下格式:

SET MessageSetID

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

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

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

message ID "message text"

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

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

标志

安全性

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

示例

1. 要安装许可产品的错误日志消息，请执行以下操作:lpp，请输入:

   errinstall -f /tmp/lpp.desc

2. 要通过以上 errinstall 命令的示例撤销对错误日志消息目录所作的更改，请输入:

   errinstall -f /tmp/lpp.desc.undo

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

   errinstall
    
   * Add a probable cause for widget failure:
   SET P
   E100 "widget adapter"

4. 要将消息替换为 "可能原因" 消息集中的重复标识，请输入:

   errinstall -f
    
   * Replace the message associated with ID E100 in the
   * Recommended Action message set
   SET R
   E100 "Replace disk drive"

5. 如果您将输入文件命名为 in_file ，然后要使用它来安装新的错误消息，请输入:

   errinstall in_file

6. 要覆盖消息集中的现有错误消息，请在 in_file中使用先前定义的标识号，并使用 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"

文件