errmsg コマンド

目的

エラー・ログ・メッセージ・カタログにメッセージを追加します。

構文

errmsg [ -c ] [ -z FileName ] [ -w Set_List | ファイル ]

説明

errmsg コマンドは、エラーの説明、推定原因、ユーザー原因、インストール原因、障害原因、推奨処置、詳細データ ID のメッセージ・セットなどを含むエラー・ログ・メッセージ・カタログの更新と表示に使用されます。

メッセージが追加または削除されるメッセージ・セットは、入力 File パラメーター内に次のように指定されます。

項目	説明
* または $	コメント行には、``(アスタリスク) または`$`(ドル記号) コメント演算子が最初の桁にあります。この``推奨される選択です。
+	追加するメッセージの前には、`+`(正符号)。
-	削除するメッセージの前には、`-`(負符号)。
SET	メッセージ・セット ID。
"メッセージ・テキスト"	メッセージ・テキストは、二重引用符で囲まれなければなりません。
メッセージID	削除されるメッセージのメッセージ ID。

エラーの説明、推定原因、詳細データ ID のメッセージ・セットに追加されるメッセージは、40 字以内の長さに納めなければなりません。ユーザー原因、インストール原因、障害原因、および推奨処置メッセージ・セットに追加されるメッセージは、 128 字以内の長さに納めなければなりません。最大で 2047 のユーザー定義メッセージが、各メッセージ・セットに追加できます。

errmsg コマンドは、エラー・レコード・テンプレート・リポジトリー内で使用される新しいメッセージを作成するために、アプリケーション開発者が使用します。既存メッセージは、可能な限り使用してください。

コマンド・ラインで何のフラグも指定しないと、デフォルトの操作は更新です。更新は、入力 File パラメーターで指定します。入力 ファイル パラメーターが指定されていない場合、または ファイル パラメーターの代わりに - (負符号 (-)) が指定されている場合、 エラー・メッセージ コマンドは標準入力から読み取ります。追加するメッセージごとに、errmsg コマンドは ID を割り当てます。メッセージをメッセージ・カタログに追加する他に、errmsg コマンドは ID とメッセージ・テキストを File.out ファイルに書き込みます。また、メッセージ・カタログを削除するときにも、File.out ファイルが作成されます。 errmsg コマンドが標準入力から読み込む場合、ID とメッセージ・テキストは標準出力に書き出されます。

フラグ

項目	説明
-c	構文エラーがないか入力ファイルを調べます。
-w (W) リストの設定	Set_List 変数で指定したエラー・ログ・メッセージ・セットを表示します。このオプションは、エラー・ログ・メッセージ・セットに含まれたメッセージと ID を表示します。出力は標準出力に書き出されます。 Set_List 変数は、コンマで区切るか、または二重引用符で囲んでコンマまたはブランクで区切ることができます。 Set_List 変数はメッセージ・セット ID です。Set_List 変数の値に all を指定すると、すべてのエラー・ログ・メッセージ・セットの内容が表示されます。 Set_List 変数の有効な値は次のとおりです。 all すべてのメッセージ・セットが表示されます。 D 詳細データ ID メッセージ・セットが表示されます。 E エラーの説明メッセージ・セットが表示されます。 F 障害原因メッセージ・セットが表示されます。 I インストール原因メッセージ・セットが表示されます。 P 推定原因メッセージ・セットが表示されます。 R 推奨処置メッセージ・セットが表示されます。 U ユーザー原因メッセージ・セットが表示されます。
-z ファイル名	Filename 変数で指定したエラー・ログ・メッセージ・カタログを使用します。

セキュリティー

アクセス制御: root ユーザーのみがこのコマンドを実行できます。

RBAC ユーザーおよび Trusted AIX ユーザーへの注意: このコマンドは特権操作を実行できます。特権命令を実行できるのは特権ユーザーのみです。権限および特権について詳しくは、「 セキュリティ」の「特権コマンド・データベース」を参照してください。このコマンドに関連した特権および権限のリストについては、lssecattr コマンドまたは getcmdattr サブコマンドの項を参照してください。

例

推定原因メッセージ・セットからメッセージを削除するには、次のように入力します。
```
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	エラー・ログ・メッセージ・カタログが入っています。米国では、$LANG の値は En_US です。