9.2　メッセージログ

メッセージログの目的

システムテスト支援の稼働状況管理および障害発生時の切り分けなどを目的としてメッセージログを出力します。メッセージログ出力の契機は、稼働状況の変化、障害発生、コマンド入力などです。システムテスト支援の管理者は、システムテスト支援が出力するメッセージログを監視し、出力されたメッセージログに従って適切な対応をとる必要があります。

メッセージログの出力先

メッセージログはその種別や出力契機によって出力先が異なります。出力先を以下に示します。

メッセージログファイル

メッセージログファイルはシステムテスト支援のメッセージログを出力するUNIXファイルです。

メッセージログファイルの内容は、テキストエディタ等で参照できます。ファイルの作成はシステムテスト支援が行い、システムテスト支援プロセスのテスト識別子毎に専用のファイルを作成します。

システムテスト支援の稼働状況を把握するために、運用方針にあわせてログファイルを管理する必要があります。

作成するファイルのサイズはシステムテスト支援の管理者がシステム定義にて設定します。

メッセージログファイルへは、複数ファイルのラウンドロビン方式でメッセージログを出力します。ファイルサイズがシステム定義の設定を超える場合に新しいファイルへ出力を切り替えます。

使用するログファイルのファイル数は最大10ファイル固定です。

システムテスト支援起動時、既にメッセージログファイルが全て使用済みの場合、更新日付が古い方のファイルから上書きで再利用し（ファイル内容を初期化（ファイルサイズを0）して使用する）ファイルに出力します。

メッセージログの付加情報

メッセージログファイルに出力するメッセージログの場合、TASKTM情報との突き合わせを目的として付加情報を出力します。出力する付加情報を以下に示します。

syslogの付加情報

syslogに出力する付加情報は、「メッセージログの項目一覧」の情報に加えてテスト識別子（1〜31バイト）を出力します。

メッセージログに関する設定

メッセージログは、出力先によってはシステム定義で出力するレベルなどを変更できます。システム定義で変更できる内容を以下に示します。

（凡例）

○：可、×：不可

環境変数LANGまたは環境変数HSIC_LANGに設定する言語種別（ロケール）

Linuxでは環境変数LANGによりメッセージの言語種別を設定します。Windowsでは環境変数HSIC_LANGによりメッセージの言語種別を設定します。

サポートする言語種別と、これらの環境変数に設定する文字列を以下に示します。

なお、環境変数LANGまたは環境変数HSIC_LANGが設定されていない場合、及びサポートしていない文字列が設定された場合の動作はCが指定されたものとして動作します。

UOCからのメッセージログ出力

システムテスト支援プロセスで動作するUOCからprintf等の標準出力関数を使用してメッセージ出力すると、メッセージログファイルに出力します。

syslog遅延出力

syslogでメモリ不足またはバッファ不足が発生してsyslogに出力できないメッセージを極力少なくするため、用意したsyslog失敗リストにメッセージを保管して他タイミングで出力する機能です。

本機能は、システム定義のメッセージログ関連定義message_log -sオプションのsyslog_out（syslogへのメッセージ出力レベル）定義値が1以上の場合に動作します。

メッセージをsyslog失敗リストに保管する場合は、メッセージログ出力要求処理で次のいずれかの条件をみたしたときです。

条件1：syslog失敗リスト内のメッセージ数が0、かつ、syslog出力がメモリ不足またはバッファ不足で失敗

条件2：syslog失敗リスト内のメッセージ数が1以上

システムテスト支援コンポーネントの出力メッセージ長が、syslog失敗リストのエレメントのメッセージ格納領域長より長い場合、メッセージ終端から超過文字列＋4バイト分の文字列を切り捨てます。切捨て後メッセージの最後に半角英字記号4バイト文字列”(EL)”を付加します。

また、本機能は拡張SYSLOGがインストールされている場合のみ有効となります。

syslog出力不可状態からの回復

syslogへの出力が不可能状態になったとき、定期的に回復処理を行います。

syslogへの出力が可能になったときは、KFSE81902-I（SYSLOGへのメッセージ出力開始）メッセージを出力します。

出力先ディレクトリ

メッセージログファイルを作成するディレクトリとファイル名を以下に示します。

格納ディレクトリ：

/opt/HSIC/job/テスト識別子/spool/dceeinf/log/*

メッセージログファイルの名称：

XX……XXlognnn

XX……XX：テスト識別子の名称（識別子最大31バイト）

log：メッセージログファイルを示す固定文字列（半角英字3バイト）

nnn：メッセージログファイルのID（半角数字3バイト、001〜010）

イベントビューア

システムテスト支援のシステムメッセージはイベントビューアに出力されます。イベントビューアの出力形式を以下に示します。