7.4 mjsview ログファイル出力コマンド

記述形式

mjsview [-sys サブシステム番号] [-c | -csv] [ログファイル名]
(注)

注): “ [-sys サブシステム番号]”はSystemwalker Operation Manager EEのオプションです。

機能説明

ジョブ実行制御が出力するログファイルは、バイナリ属性を含んでおり、直接参照することができません。よって、このコマンドを使ってログファイルの内容を編集し、標準出力に形式化して出力します。

ログファイルを出力するための設定方法は、“Systemwalker Operation Manager 導入手引書”を参照してください。

なお、[運用情報の定義]ウィンドウの“ジョブ実行履歴情報を保存する”(logパラメタ)を指定していない場合、ログファイルは以下に出力されます。

【Windows版】

ジョブ実行制御スプールパス￥hist￥日付.log

日付：yyyymmdd形式

【UNIX版】

/var/spool/mjes/hist/日付.log

日付：yyyymmdd形式

オプション

-sys サブシステム番号

複数サブシステム運用をしているシステムで、操作対象のサブシステムを指定するためのオプションです。操作対象とするサブシステム番号を、0から9の範囲で指定します。このオプションを省略した場合、サブシステム番号0が操作対象となります。

-c

“-c”を指定すると、コマンド発行時点までのログファイルの内容を形式化して出力した後、ログファイルを継続して監視し、ログを動的に形式化して出力し続けます。ログファイルが存在しない場合は、コマンドは終了します。

“-c”を省略すると、コマンド発行時点までのログファイルの内容を形式化して出力した後、コマンドは終了します。

-csv

“-csv”を指定すると、コマンド発行時点までのログファイルの内容をcsv形式で形式化して出力した後、コマンドは終了します。

ログファイル名

ログファイル名を指定します。

ログファイル名を省略すると、現在有効なログファイルが処理の対象となります。前日のログファイルの内容などを処理したい場合は、ログファイル名をフルパスで指定してください。

復帰値

復帰値	意味
0	コマンド処理が正常に終了しました。
0以外	コマンド処理が正常に終了しませんでした。エラーメッセージが出力されます。

コマンド格納場所

Windows	Systemwalker Operation Managerインストールディレクトリ¥MpWalker.JM¥bin
Solaris HP-UX AIX Linux Linux for Itanium	/usr/lib/mjes

実行に必要な権限

システム管理者(Administratorsグループに属するユーザ/スーパーユーザ)権限が必要です。

注意事項

ジョブをキューイング中にSystemwalker Operation Managerを再起動したり、サーバがダウンした場合には、ログファイルに情報が格納されない場合があります。
Systemwalker Operation Managerを再起動した場合、リカバリ対象のジョブについては、再度ジョブを開始するため、同一のログが出力される場合があります。
以下の条件をすべて満たしている場合、ジョブのpurgeログが一度にログファイルへ出力されます。
- ネットワークジョブが実行される実行先サーバである。
- 実行先サーバにおいて、ジョブが終了した時点で投入元サーバとの回線接続に失敗した(投入元サーバのシステムダウンや回線が切断された時)。
- 回線接続に失敗した後、接続に成功した(投入元サーバが再起動された時や回線接続が復旧した時)。

表示例

mjsview ログファイル出力コマンドの表示例を以下に示します。

2005/11/11 09:24:24 MJS901I MpMjes service start.
2005/11/11 14:33:00 MJS007I job sleep(13.general) accept
2005/11/11 14:33:00 MJS001I job sleep(13.general) start at queue1
2005/11/11 14:35:00 MJS002I job sleep(13.general) stop RC(0000)
2005/11/11 14:35:00 MJS006I job sleep(13.general) purge
2005/11/11 19:44:11 MJS007I job sleep(14.general) accept
2005/11/11 19:44:11 MJS001I job sleep(14.general) start at queue1
2005/11/11 19:44:21 MJS005I job sleep(14.general) cancel
2005/11/11 19:44:21 MJS002I job sleep(14.general) stop EC(40000222)
2005/11/11 19:44:21 MJS006I job sleep(14.general) purge

備考. ジョブ実行制御サービスの起動
正常終了ジョブ(ジョブ番号=13)
強制終了ジョブ(ジョブ番号=14)

EC：ECの文字列で表示される内部コードは16進数表示となります。
RC：RCの文字列で表示される内部コードは10進数表示となります。

“-csv”オプション指定時の表示例を以下に示します。

2005/11/11,09:24:24,MJS901I,MpMjes service start.
2005/11/11,14:33:00,MJS007I,job sleep(13.general) accept
2005/11/11,14:33:00,MJS001I,job sleep(13.general) start on queue1
2005/11/11,14:35:00,MJS002I,job sleep(13.general) stop,RC(0000)
2005/11/11,14:35:00,MJS006I,job sleep(13.general) purge
2005/11/11,19:44:11,MJS007I,job sleep(14.general) accept
2005/11/11,19:44:11,MJS001I,job sleep(14.general) start on queue1
2005/11/11,19:44:21,MJS005I,job sleep(14.general) cancel
2005/11/11,19:44:21,MJS002I,job sleep(14.general) stop,EC(40000222)
2005/11/11,19:44:21,MJS006I,job sleep(14.general) purge

備考. ジョブ実行制御サービスの起動
正常終了ジョブ(ジョブ番号=13)
強制終了ジョブ(ジョブ番号=14)

EC：ECの文字列で表示される内部コードは16進数表示となります。
RC：RCの文字列で表示される内部コードは10進数表示となります。

実行結果/出力形式

以下に出力形式を示します。

1) yyyy/mm/dd hh:mm:ss MJS001I job jobname(jobno.hostname) start at queuename
2) yyyy/mm/dd hh:mm:ss MJS002I job jobname(jobno.hostname) stop RC(rc)|EC(ec)
3) yyyy/mm/dd hh:mm:ss MJS003I job jobname(jobno.hostname) step stepname start
4) yyyy/mm/dd hh:mm:ss MJS004I job jobname(jobno.hostname) step stepname stop RC(rc)|EC(ec)
5) yyyy/mm/dd hh:mm:ss MJS005I job jobname(jobno.hostname) cancel
6) yyyy/mm/dd hh:mm:ss MJS006I job jobname(jobno.hostname) purge
7) yyyy/mm/dd hh:mm:ss MJS007I job jobname(jobno.hostname) accept from host-name
8) yyyy/mm/dd hh:mm:ss MJS901I MpMjes service start.
9) yyyy/mm/dd hh:mm:ss MJS902I MpMjes service stop.

以下に各ログの意味を説明します。
1) ジョブが開始したことを示します。
2) ジョブが終了したことを示します。
3) ジョブステップが開始したことを示します。
4) ジョブステップが終了したことを示します。
5) 強制終了要求を受け付けたことを示します。
6) ジョブをスプールから削除したことを示します。
7) ジョブを受け付けたことを示します。
8) ジョブ実行制御サービス/デーモンが開始したことを示します。
9) ジョブ実行制御サービス/デーモンが終了したことを示します。

以下に可変部分について出力される内容を説明します。

jobname:: ジョブ名が出力されます。

jobno:: ジョブ実行制御が割り当てたジョブ番号が出力されます。

hostname:: ジョブを投入したホスト名が出力されます。

queuename:: ジョブが開始したキュー名が出力されます。

stepname:: ジョブステップ名が出力されます。
RC(rc)|EC(ec): RC(rc)またはEC(ec)のどちらかが出力されます。
強制終了した場合やネットワーク異常などにより、ジョブ処理が中断した場合は、EC(ec)が出力され、それ以外は、RC(rc)が出力されます。
rc : ジョブの終了コードが10進数で出力されます。
ec : 異常を示す終了コードが16進数で出力されます。ジョブを強制終了した場合、ecは40000222と出力されます。

host-name:: ネットワークジョブ/分散実行ジョブの依頼元サーバのホスト名が出力されます。
実行サーバにおいて、ネットワークジョブ/分散実行ジョブを他のリモートサーバから受け付けた場合、「from host-name」が追加されて出力されます。