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

Systemwalker Centric Manager リファレンスマニュアル - UNIX共通 -

目次索引

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

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

■機能説明

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

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

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

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

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

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

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

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

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

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

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

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

本オプションには監視ログファイル設定で定義したファイル名を指定してください。通常のファイル、監視ファイル名格納ファイルどちらも指定が可能です。
監視対象ファイル確認(-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：: 内部エラー

■参照

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

■コマンド格納場所

Solaris OE
HP-UX
AIX
Linux

/opt/systemwalker/bin

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

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

■注意事項

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

■使用例

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

監視機能の一時停止をします。
```
　/opt/systemwalker/bin/opafmonext -p
```
“監視ファイル名格納ファイル”を編集し新たに監視対象となるファイル名に変更します。
監視を再開します。
```
　/opt/systemwalker/bin/opafmonext -s
```
現在監視対象となっているファイル名を確認します。
```
　/opt/systemwalker/bin/opafmonext -f /usr/local/logfile.+@
```
※/usr/local/logfile.+@:　監視ファイル名格納ファイル

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

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

（/app/applog1.+@、/app/applog2.+@は毎日変更されるログ、/app/applog3.+@は毎月１日に変更されるログを監視する場合の例）
```
#!/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)

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

目次索引