Systemwalker Centric Manager API・スクリプトガイド - UNIX/Windows(R)共通 -

3.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では、アプリケーションはシステムのデフォルトロケールで作成してください。
• コンパイルに必要な権限は以下のとおりです。

  【Windows版】

  • Administrator権限/DmAdmin権限/DmOperation権限/DmReference権限が必要です。
  • 運用管理サーバでコンパイルできます。

  【UNIX版】

  • システム管理者(スーパーユーザ)権限が必要です。
  • 運用管理サーバでコンパイルできます。

■必要ファイル

上記監視イベントのAPIを使用するには、以下のファイルが必要となります。

【Windowsの場合】

監視イベントのAPIは、以下のライブラリ(LIBファイル,DLLファイル）に格納され、各APIで使用する定数および構造体は、INCLUDEファイルに宣言されています。

• 【Windows for Itanium版の場合で64ビットのアプリケーションを作成する場合】
  • INCLUDEファイル

    Systemwalkerインストールディレクトリ\MPWALKER.DM\Include\mp_opmgr_api.h、mp_operr_api.h

  • リンクするライブラリ

    Systemwalkerインストールディレクトリ\MPWALKER.DM\Lib\mpopmgr_64.lib

  • 使用するDLL

    Systemwalkerインストールディレクトリ\MPWALKER.DM\Bin\mpopmgr_64.dll

  上記ライブラリは64bit版製品で利用できます。

  32bit版製品には、64bit版モジュールのコンパイル用にヘッダとライブラリ(libファイル)のみ同梱されています。

• 【Windows for Itanium以外の場合】
  • INCLUDEファイル

    Systemwalkerインストールディレクトリ\MPWALKER.DM\Include\mp_opmgr_api.h、mp_operr_api.h

  • リンクするライブラリ

    Systemwalkerインストールディレクトリ\MPWALKER.DM\Lib\mpopmgr_32.lib

  • 使用するDLL

    Systemwalkerインストールディレクトリ\MPWALKER.DM\Bin\mpopmgr_32.dll

  上記ライブラリは32bit版製品で利用できます。

• 【Windows for Itanium以外（V13.1.0以前との互換ライブラリ）】：
  • INCLUDEファイル

    Systemwalkerインストールディレクトリ\MPWALKER.DM\Include\mp_opmgr_api.h、mp_operr_api.h

  • リンクするライブラリ

    Systemwalkerインストールディレクトリ\MPWALKER.DM\Lib\mpopmgr.lib

  • 使用するDLL

    Systemwalkerインストールディレクトリ\MPWALKER.DM\Bin\mpopmgr.dll

  上記ライブラリは32bit版製品で利用できます。32bit版ライブラリはV13.1.0以前の製品との互換用ライブラリで、time_t型のサイズが32bitでコンパイルされています。V13.3.0より新規導入される場合での利用は推奨しません。

【UNIXの場合】

以下のINCLUDEファイルとライブラリが必要です。

• INCLUDEファイル
  • /opt/systemwalker/include/f1egopag.h
  • /opt/systemwalker/include/mp_operr_api.h
  • /opt/systemwalker/include/mp_opmgr_api.h

  mp_opmgr_api.hをインクルードすれば、ほかの2つもその中からインクルードされます。

• ライブラリ

  OS	リンクするライブラリ
  Solaris	/usr/lib/libthread.so /usr/lib/libopmgr.so
  Linux	/usr/lib/libopmgr.so

◆コンパイル環境

コンパイル環境は以下のとおりです。

【Windowsの場合】

• コンパイラ : Microsoft Visual C++ 2005
• ランタイムライブラリ : “マルチスレッド（DLL）”を使用してください。
• プリプロセッサ : V13.1.0以前との互換ライブラリを利用する場合は、“_USE_32BIT_TIME_T”を指定してください。また、Windows for Itanium版で64ビットのアプリケーションを作成する場合は、“_WIN64”を指定してください。

【UNIXの場合】

• Solaris : Sun WorkShop 5.0以降
• Linux for Itanium : 動作プラットフォームにバンドルされているコンパイラ (gcc)
• Linux for Itanium以外のLinux : 動作プラットフォームにバンドルされているコンパイラ (gcc)

■使用例

API関数の使用例を以下に示します。

• 監視イベントログを読み出す
• イベントを監視する
• 監視イベントを対処する

---

3.1.1.1 監視イベントログを読み出す

3.1.1.2 イベントを監視する

3.1.1.3 監視イベントを対処する