Systemwalker Centric Manager APIガイド - UNIX共通 - - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 -
|
目次
索引

|
2.1.1 監視イベントのAPI
監視イベントのAPI一覧を以下に示します。
[監視イベントのAPI一覧]
関数名 |
機能 |
Mp_OpenEventLog |
監視イベントログの読み出し開始要求 |
Mp_ReadEventLog |
監視イベントログの読み出し要求 |
Mp_CloseEventLog |
監視イベントログの読み出し終了要求 |
Mp_OpenEvent |
イベントの監視開始要求 |
Mp_ReadEvent |
イベントのリード要求 |
Mp_GetEventMap【Windows】 |
イベントの取出し要求 |
Mp_CloseEvent |
イベントの監視終了要求 |
Mp_OpenEventStat |
イベントの状態変更開始要求 |
Mp_ChangeEventStat |
イベントの対処要求 |
Mp_CloseEventStat |
イベントの状態変更終了要求 |
監視イベントのAPI共通の動作環境、注意事項、および必要ファイルについての説明を以下に示します。
■動作環境
本APIは、以下のインストール種別で動作します。
■注意事項
- LIBファイルおよびINCLUDEファイルは、同じバージョン/レベルで提供されたものを使用してください。
- 監視イベントのAPIは、マルチスレッドプログラミングをサポートしていません。
- “Mp_OpenEvent()”関数を呼び出したプロセスは、“Mp_CloseEvent()”関数を呼び出すまで終了しないでください。
- 監視イベントのAPIを使用するアプリケーションは、signal を使用しないでください。
- 監視イベントのAPIの最大同時実行数は4つまでです。
- Mp_OpenEvent()/Mp_ReadEvent()/Mp_GetEventMap()【Windows】/Mp_CloseEvent()関数を利用するには、“システム監視のAPIを利用する”を実施する必要があります。
- “Mp_ReadEvent()”関数を呼び出した後の“WaitForSingleObject()”関数でタイムアウトを設定し、タイムアウトした場合は、再度“WaitForSingleObject()”関数で待機するか“Mp_CloseEvent”を呼び出し、再度“Mp_OpenEvent()”関数から処理を行ってください。【Windows版】
- “Mp_ReadEvent()”関数を呼び出した後は、“Mp_GetEventMap()”を呼び出してください。【Windows版】
- Systemwalker Centric Managerのバージョンが異なる環境で作成されたシステム監視のAPIを使用するアプリケーションは動作しません。
動作させるには、動作環境と同じSystemwalker Centric Managerのバージョンの環境下で、アプリケーションのリコンパイルを行ってください。
- SolarisおよびLinuxで監視イベントAPIを使用するアプリケーションをコンパイルおよび実行するときには、環境変数LD_LIBRARY_PATHに“/opt/systemwalker/lib”を設定してください。
- Linux for Itaniumでは、コンパイルするときにプリプロセッサオプションとして“-D__LP64__”をつけてください。
- Linux for Itaniumでは、アプリケーションはシステムのデフォルトロケールで作成してください。
■必要ファイル
上記監視イベントのAPIを使用するには、以下のファイルが必要となります。
【Windowsの場合】
監視イベントのAPIは、以下のライブラリ(LIBファイル,DLLファイル)に格納され、各APIで使用する定数および構造体は、INCLUDEファイルに宣言されています。
- Systemwalkerインストールディレクトリ\MPWALKER.DM\Lib\mpopmgr.lib
- Systemwalkerインストールディレクトリ\MPWALKER.DM\Include\mp_opmgr_api.h、mp_operr_api.h
- Systemwalkerインストールディレクトリ\MPWALKER.DM\Bin\mpopmgr.dll
【UNIXの場合】
以下のINCLUDEファイルとライブラリが必要です。
◆コンパイル環境
コンパイル環境は以下のとおりです。
【Windowsの場合】
- コンパイラ : Microsoft Visual C++ 6.0
- ランタイムライブラリ : “マルチスレッド(DLL)”を使用してください。
【UNIXの場合】
- Solaris : Solaris上で動作するSPARCコンパイラ
- Linux for Itanium : 動作プラットフォームにバンドルされているコンパイラ (gcc)
- Linux for Itanium以外のLinux : 動作プラットフォームにバンドルされているコンパイラ (gcc)
■使用例
API関数の使用例を以下に示します。
- 監視イベントログを読み出す
- イベントを監視する
- 監視イベントを対処する
2.1.1.1 監視イベントログを読み出す
2.1.1.2 イベントを監視する
2.1.1.3 監視イベントを対処する
All Rights Reserved, Copyright(C) 富士通株式会社 1995-2006