ras_logger コマンド

目的

エラー・テンプレートを使用してエラーをログに記録します。

構文

/usr/lib/ras/ras_logger [ -y テンプレート・ファイル ]

説明

ras_logger コマンドは、データをログに記録する方法を決めるエラーのテンプレートを使用して、標準入力に提供された 1 つのエラーをログに記録します。入力のフォーマットを以下に示します。

error_label 
resource_name 
64_bit_flag 
detail_data_item1 
detail_data_item2 
...

error_label フィールドは、テンプレートで定義されたエラーのラベルです。 resource_name フィールドの長さは 16 文字までです。 64_bit_flag フィールドの値は、 32 ビット・エラーの場合は 0、64 ビット・エラーの場合は 1 です。 detail_data フィールドは、テンプレート内の Detail_Data 項目に対応します。

フラグ

項目	説明
-y template-file	/var/adm/ras/errtmplt デフォルト・ファイル以外のテンプレート・ファイルを指定します。

例

エラーをログに記録します。テンプレートは以下のとおりです。
```
 + FOO: 
		Catname = "foo.cat"
		Err_Type = TEMP
		Class = O
		Report = TRUE
		Log    = TRUE
		Alert  = FALSE
		Err_Desc = {1, 1, "Error FOO"}
		Prob_Causes = {1, 2, "Just a test"}
		User_Causes = {1, 2, "Just a test"}
		User_Actions = {1, 3, "Do nothing"}
		Detail_Data = 4, {2, 1, "decimal"} ,DEC
		Detail_Data = W, {2, 1, "hex data"} ,HEX
		Detail_Data = 100, {2, 1, "long string"} ,ALPHA 
```
tfile ファイル内の ras_logger 入力は以下のとおりです。
```
FOO
resource
0
15
A0
hello world
```
/usr/lib/ras/ras_logger < tfile コマンドを実行します。これは、リソース名が resource である FOO エラーをログに記録します。詳細データは、decimal 15 にセットされた 4 バイト、 0xa0 にセットされた 16 進データの 4 バイト、および文字列 "hello world" からなります。 64 ビット・フラグの値が 1 の場合、16 進データは 8 バイトが 0xa0 にセットされます。
複数項目の 10 進数値です。テンプレートは以下のとおりです。
```
+ FOO:
		Catname = "foo.cat"
		Err_Type = TEMP
		Class = O
		Report = TRUE
		Log    = TRUE
		Alert  = FALSE
		Err_Desc = {1, 1, "Error FOO"}
		Prob_Causes = {1, 2, "Just a test"}
		User_Causes = {1, 2, "Just a test"}
		User_Actions = {1, 3, "Do nothing"}
		Detail_Data = 8, {2, 1, "decimal"} ,DEC
		Detail_Data = W, {2, 1, "hex data"} ,HEX
		Detail_Data = 100, {2, 1, "long string"} ,ALPHA
```
ras_logger コマンドは、tfile ファイルに以下を入力します。
```
FOO
resource 
0 
15 -15 
A0 
hello world
```
注: 通常、10 進数データは、 errpt コマンドによって、それぞれ 4 バイトを使用する 2 つの別個の値として表示されます。したがって、入力は 15 および -15 を含みます。これが errpt コマンドの表示方法です。