機能説明
本コマンドは、メッセージログを、日時、ホスト名、文字列によって検索し、出力します。
記述形式
opamsgrev | [-o filename] [-n hostname] [-s starttime] [-e endtime] [-a] [-f file1,…] [-j] [-c] [--] [condition1 condition2 …] |
オプション
検索結果を出力するファイル名を指定します。省略した場合、標準出力に出力します。
検索対象とするホスト名を指定します。省略した場合、すべてのシステムを対象に検索します。
検索を開始する日時を指定します。省略した場合、メッセージログファイル中の最古の日時から検索します。starttimeは、以下形式の12桁の数字で指定します。
YYMMDDhhmmss:
西暦の下2桁。1970年から2037年までが有効です。すなわち、70～99を指定した場合は、1970年から1999年とみなされます。00～37を指定した場合は、2000年から2037年とみなされます。
MM月DD日
hh時 mm分 ss秒
検索を終了する日時を指定します。省略した場合は、メッセージログファイル中の最新の日時まで検索します。endtimeは、-sオプションで指定するstarttimeと同じ形式で指定します。
condition1 condition2 ……で指定した検索文字列がすべて含まれるメッセージを検索します(AND条件)。
以下のいずれかのファイルを指定します。
検索対象となる(Mpmsgpsvコマンドにより)バックアップされたメッセージログファイル(本コマンドの実行環境が運用管理サーバの場合のみ指定可)
[通信環境定義詳細]-[ログファイル定義]タブの[メッセージログ]-[格納ディレクトリ]に指定されているディレクトリ内のメッセージログファイルをファイル複写によりバックアップしたファイル
同時に20個までのファイルを指定できます。複数のファイルを指定する場合は、ファイル名とファイル名の間をコンマ(,)で区切ります。また、UNIX版でかつ、業務サーバおよび部門管理サーバの場合は、全体を引用符(「'」または「"」)で囲んで空白で区切って複数ファイルを指定することもできます。
省略した場合は、メッセージログテーブル全体を検索します。
ジョブ番号を出力します。
コマンドの出力は以下のようになります。（△：半角空白1個）
日時△ホスト名△ジョブ番号△メッセージテキスト
ジョブ番号が空白文字である場合もあり、その場合ジョブ番号のところには空白文字がそのまま入ります。
ジョブ番号が入っていない場合は以下のようになります。
日時△ホスト名△△メッセージテキスト
「-j」オプションを指定しないときは以下の出力となります。
日時△ホスト名△メッセージテキスト
運用管理サーバだけで有効なオプションです。運用管理サーバでは、このオプションを指定しない場合はメッセージテキスト中の復帰コード(\r)、改行コード(\n)は空白で置き換えられて出力されます。このオプションを指定すると空白で置き換えられずそのまま出力されます。
運用管理サーバ以外では、メッセージテキスト中の復帰コード,改行コードは常にそのまま出力されます。
オプション指定終了記号です。これによって、condition1 condition2 …指定する文字列に、「-」を含めることができます。
検索条件の文字列を指定します。検索文字列は、最大5つまで指定することができます。また、1つの検索文字列は、64バイト分以内が有効となります。日本語も入力できます。省略した場合、時間内のすべてのメッセージが出力されます。
検索文字列に空白を含む場合は、文字列を「"」(ダブルクォーテーション)で括ってください。
復帰値
正常終了
異常終了
検索条件に一致しなかった場合は、以下の復帰値となります。
0
2
参照
コマンド格納場所
Windows | Systemwalkerインストールディレクトリ\MpWalker.dm\bin |
UNIX | /opt/systemwalker/bin |
実行に必要な権限/実行環境
【Windows】
運用管理サーバ/部門管理サーバ/業務サーバでは、Administrator権限/DmAdmin権限/DmOperation権限/DmReference権限が必要です。
運用管理クライアント/クライアントでは、一般ユーザの権限が必要です。
本コマンドは、[管理者として実行]を選択して起動したコマンドプロンプト上で実行してください。
運用管理サーバ/部門管理サーバ/業務サーバで実行可能です。
運用管理クライアント/クライアントでは、[イベント監視]を選択インストールしたとき実行可能です。
【UNIX】
運用管理サーバ/部門管理サーバ/業務サーバでは、システム管理者(スーパーユーザ)権限が必要です。
運用管理クライアント/クライアントでは、一般ユーザの権限が必要です。
運用管理サーバ/部門管理サーバ/業務サーバで実行可能です。
運用管理クライアント/クライアントでは、[イベント監視]を選択インストールしたとき実行可能です。
注意事項
検索結果として表示される日時は、メッセージが発生した時点でのメッセージ発生システムでの日時です。また、検索条件として指定された日時は、ロギングされた日時をもとに検索されます。そのため、以下の状態になる場合がありますので注意してください。
条件で指定した日時の範囲からはずれているメッセージまで検索されます。
複数システムのメッセージを同時に検索した場合、検索結果の表示でメッセージが時間順に並びません。
コマンドを実行する環境のLANGとシステムのコード系を同一のものにしてください。
使用例
コマンドの入力例を以下に示します。以下の条件で検索しています。
ホスト名「tokyo」で発生したメッセージ
2001年2月15日から2月16日までの間に発生したメッセージ
メッセージに「OS」または「性能」という文字を含んだメッセージ
opamsgrev -n tokyo -s 010215000000 -e 010216235959 -- OS 性能
実行結果/出力形式
検索結果の情報を以下に示します。
表示形式について、1行目のメッセージを例に以下に説明します。
