1.2.225 opafmonext(ログファイル監視拡張コマンド)

Systemwalker Centric Manager リファレンスマニュアル - UNIX/Windows(R)共通 -

目次索引

第1章コマンドリファレンス

> 1.2 コマンド

1.2.225 opafmonext(ログファイル監視拡張コマンド)

■機能説明

本コマンドはログファイル監視の拡張機能を実現するために使用します。

例えば、運用中にファイル名が変更されるログファイルの監視を行う場合に使用します。

なお、共有ディスク上にあるファイルについて同様の機能を使用する場合は、共有ディスクファイル監視拡張コマンド(opashrfmonext)を使用してください。

必要に応じて以下の機能を実行します。

ファイル監視再開(-s)
一時的に監視を停止していたログファイル監視機能を再開します。

ファイル監視一時停止（-pオプション）を行った後に実行します。

本オプションはSystemwalker Centric Managerが動作しているときだけ有効です。
ファイル監視一時停止(-p)
監視対象ファイルを変更するために一時的にファイル監視機能を停止します。

ログファイルの状況を確認し前回の読み込み処理から差分がある場合は、その読み込みを行います。

本オプションはSystemwalker Centric Managerが動作しているときだけ有効です。
ファイル監視強制一時停止(-x)
監視対象ファイルを変更するために一時的にファイル監視機能を停止します。

前回の読み込み処理から差分がある場合でも、読み込み処理は行いません。

また、本オプションはSystemwalker Centric Managerが動作しているときだけ有効です。
監視スキップ(-e)
指定されたファイルに対して、前回の読み込みからログファイルに書き込まれた内容の監視を行わず、スキップすることができます。

本オプション実行後から監視処理を行います。

本オプションには[監視ログファイル設定]で定義したファイル名を指定してください。通常のファイル、監視ファイル名格納ファイルどちらも指定が可能です。
監視対象ファイル確認(-f)
現在の監視対象となっているファイル名を表示します。現在監視を行っているファイル名を確認するときに使用します。

-fを指定し、“監視ファイル名格納ファイル”名を省略した場合は、定義されている監視ファイル名格納ファイルと現在の監視対象ファイルをすべて表示します。

■記述形式

opafmonext

{ -s | -p | -x | -e conffile | -f [incfile] }

■オプション

-s:

一時的に監視を停止していたログファイル監視機能を再開します。

Systemwalker Centric Managerが一時停止中(-p,-x)の場合だけ有効です。

-p:

一時的にファイル監視機能を停止します。

Systemwalker Centric Managerが動作中の場合だけ有効です。

-x:

一時的にファイル監視機能を強制的に停止します。前回の読み込み処理から差分がある場合でも、読み込み処理は行いません。

Systemwalker Centric Managerが動作中の場合だけ有効です。

-e conffile:

前回監視を行ってからの差分について監視を行わず、読み飛ばします。

本オプション実行後以降のログファイルへ書き込みの監視を行います。

conffileには[監視ログファイル設定]で定義したファイル名を指定してください。通常のファイル、監視ファイル名格納ファイルどちらも指定が可能です。

-f incfile:

“監視ファイル名格納ファイル”に定義された監視対象ファイルで、現在実際に監視されているファイルを表示します。incfileには[監視ログファイル設定]で指定した“監視ファイル名格納ファイル”名を指定してください(".+@"で終わるファイル名)。

incfileにファイル名を指定しない場合は、現在定義されている“監視ファイル名格納ファイル”と実際に監視を行っているファイルの一覧を表示します。

■復帰値

0：: 正常終了。
1：: Systemwalker Centric Manager未起動か、ログファイル監視の定義が行われていない
2：: パラメタエラー
3：: コマンドの初期化に失敗
4：: コマンド実行中にSystemwalker Centric Managerが停止/起動
5：: サーバプロセスからデータ受信に失敗
6：: コマンドの実行権限が与えられていない
12：: 監視一時停止中である
13：: 内部ファイルの更新に失敗
14：: 対応するファイルが定義されていない
99：: 内部エラー

■参照

監視ファイル名格納ファイル

■コマンド格納場所

Windows	Systemwalkerインストールディレクトリ\mpwalker.dm\bin
UNIX	/opt/systemwalker/bin

■実行に必要な権限/実行環境

【Windows】

Administrator権限が必要です。
Windows Vista で本コマンドを実行する場合、[管理者として実行]を選択して起動したコマンドプロンプト上で実行してください。
以下にコマンドプロンプトの起動例を示します。
例：
[スタート]-[アクセサリ]-[コマンドプロンプト]を右クリックして表示されるメニューから、[管理者として実行]を選択して起動する。
運用管理サーバ/部門管理サーバ/業務サーバで実行可能です。
運用管理クライアント/クライアントでは[イベント監視]を選択インストールしたとき実行可能です。

【UNIX】

システム管理者(スーパーユーザ)権限が必要です。
運用管理サーバ/部門管理サーバ/業務サーバで実行可能です。
運用管理クライアント/クライアントでは[イベント監視]を選択インストールしたとき実行可能です。

■注意事項

本コマンドで異常終了となった場合は出力されたメッセージを参照してください。
監視の一時停止から60分経過すると自動的に監視を再開します。なお、一時停止中に再度一時停止コマンドを実行した場合は、そこから60分後に監視を再開します。
同一の監視対象のファイルを複数に監視ファイル名格納ファイル等に定義（重複定義）しないでください。

■使用例

監視対象ファイルが運用中に変更される場合、以下のような手順で監視対象ファイルの変更を行います。

監視機能の一時停止をします。
【Windows版】
```
　opafmonext -p
```
【UNIX版】
```
　/opt/systemwalker/bin/opafmonext -p
```
“監視ファイル名格納ファイル”を編集し新たに監視対象となるファイル名に変更します。

監視を再開します。

【Windows版】

　opafmonext -s

【UNIX版】

　/opt/systemwalker/bin/opafmonext -s

現在監視対象となっているファイル名を確認します。
【Windows版】
```
　opafmonext -f c:\usr\local\localfile.+@
```
※c:\usr\local\localfile.+@:　監視ファイル名格納ファイル

【UNIX版】
```
　/opt/systemwalker/bin/opafmonext -f /usr/local/logfile.+@
```
※/usr/local/logfile.+@:　監視ファイル名格納ファイル

`【Windows版】`

以下は上記1～3を行うWindows Server 2003 STD/Windows Server 2003 DTC/Windows Server 2003 EE/Windows Server 2008 STD/Windows Server 2008 DTC/Windows Server 2008 EE/Windows Server 2008 for Itanium-Based Systemsで動作するバッチファイルの例です。

本バッチファイルをスケジュールすることで自動的にファイル名の変更を行うことができます。

（c:\app\app_log1.+@、c:\app\app_log2.+@は毎日変更されるログ、c:\app\app_log3.+@は毎月1日に変更されるログを監視する場合）

@echo off

SET YY=%DATE:~2,2%
SET MM=%DATE:~5,2%
SET DD=%DATE:~8,2%

opafmonext -p

rem daily
echo app1_LOG%YY%%MM%%DD%.txt > c:\app\app_log1.+@
echo app2_LOG%YY%%MM%%DD%.txt > c:\app\app_log2.+@
rem monthly
if "%DD%" == "01" (
 echo app3_LOG%YY%%MM%.txt > c:\app\app_log3.+@
)

opafmonext -s

【UNIX版】

以下は上記1～3を行うシェルスクリプトの例です。

本シェルスクリプトをcrontabに登録することで自動的にファイル名の変更を行うことができます。

（/app/applog1.+@、/app/applog2.+@は毎日変更されるログ、/app/applog3.+@は毎月1日に変更されるログを監視する場合の例）

#!/bin/sh

/opt/systemwalker/bin/opafmonext -p
# daily
echo `date '+app1_LOG%y%m%d.txt'` > /app/applog1.+@
echo `date '+app2_LOG%y%m%d.txt'` > /app/applog2.+@
# monthly
day=`date '+%d'`
if [ $day = "01" ]
then
 echo `date '+app3_LOG%y%m.txt'` > /app/applog3.+@
fi
/opt/systemwalker/bin/opafmonext -s

■実行結果/出力形式

監視対象ファイルを出力した場合(-f)

【Windows版】

c:\> opafmonext -f c:\usr\local\logfile.+@
c:\usr\local\app\app20031010.log
c:\>

【UNIX版】

# /opt/systemwalker/bin/opafmonext -f /usr/local/logfile.+@
/usr/local/app/app20031010.log
#

目次索引