errmsg 命令

在线编辑

用途

在出错日志消息目录里添加一条消息。

语法

errmsg [ -c ] [ -z FileName ] [ -w Set_List | File ]

描述

errmsg 命令更新并显示出错日志消息目录，包括错误描述、可能的原因、用户原因、安装原因、失败原因、推荐的操作和详细的数据 ID 消息集。

那些对其要添加或删除消息的消息集在输入 File 参数里按如下方式列示：

项 描述
* 或 $ 注释行必须具有*(星号) 或$(美元符号) 第一列中的注释运算符。 该*是首选选项。
+ 要添加的消息前面必须有一个+(加号)。
- 要删除的消息前必须有-(减号)。
SET 消息集 ID。
"消息文本" 消息文本必须用双引号括起来。
消息标识 要删除的消息的消息 ID。

添加到出错描述、可能原因和详细数据 ID 消息集的消息在长度上不能超过 40 个字符。 添加到用户原因、安装原因、失败原因和推荐操作消息集里的消息在长度上不能超过 128 个字符。 最多可以向每个消息集里添加 2047 个用户自定义消息。

errmsg 命令被应用程序开发者用来创建在错误记录模板库中用到的新消息。 如果可能的话，已存在的消息应该一直可用。

如果在命令行中没有指定标志，缺省的操作是更新。 在输入的参数 File 里指定更新。 如果输入的参数 File 没有指定或指定 -（减号）代替 File 参数，那么 errmsg 命令从标准输入读取。 对于添加的每条消息，errmsg 命令会指定一个标识。 而且，在向消息目录添加消息外 errmsg 命令将此标识和消息文本写入 File.out 文件。 File.out 在从消息目录删除消息时此文件也被创建。 如果 errmsg 命令正在从标准输入中读取时，标识和消息文本就被写到标准输出。

标志

项 描述
-c 检测输入文件有无语法错误。
-w 设置列表 显示由变量 Set_List 指定的错误日志消息集。 此选项显示包含在出错日志消息集中的消息及其标识。 输出到标准输出。 Set_List 变量可以用逗号分隔或者在双引号里用逗号或空格分隔。 Set_List 变量是消息集 ID 或者如果 Set_List 变量的值 all 被指定的话，所有的错误日志消息集的内容都会显示出来。 变量 Set_List 的有效值有：
all
显示所有消息集
深
显示详细的数据 ID 消息集
:NONE.
显示错误描述消息集
F
显示失败原因消息集
i
显示安装原因消息集
步
显示可能原因消息集
R
显示推荐操作消息集
u
显示用户原因消息集
-z 文件名 使用由变量 Filename 指定的出错日志消息目录。

安全性

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

RBAC 用户和可信 AIX 用户注意: 此命令可以执行特权操作。 只有特权用户才能执行特权限定的操作。 有关权限和特权的更多信息，请参阅 安全中的 Privileged Command Database。 要获取与此命令相关联的特权和权限的列表，请参阅 lssecattr 命令或 getcmdattr 子命令。

示例

  1. 要从 "可能原因" 消息集中删除消息，请输入:
    errmsg
* Delete messages FF1A, FF1B, and FF1C from the Probable Cause
* message set
SET P 
- FF1A
- FF1B
- FF1C
  2. 要将消息添加到 "窗口小部件失败" 错误的 "可能原因" 消息集，请输入:
    errmsg
* Add a Probable Cause for Widget Failure
SET P 
+ "WIDGET ADAPTER"

文件

项 描述
/usr/lib/nls/msg/$LANG/codepoint.cat 包含出错日志消息目录。 在美国，变量 $LANG 的值为 En_US。