Systemwalker Centric Manager APIガイド - UNIX共通 -

2.1.2 監視メッセージのAPI

監視メッセージのAPI一覧を以下に示します。

[監視メッセージのAPI一覧]

関数名	機能
Mp_OpenMsg	メッセージの通知開始要求
Mp_ReadMsg	メッセージのリード要求
Mp_CloseMsg	メッセージの通知終了要求
Mp_OpenMsgLog	メッセージログの読み出し開始要求
Mp_ReadMsgLog	メッセージログの読み出し要求
Mp_CloseMsgLog	メッセージログの読み出し終了要求

監視メッセージのAPI共通の動作環境、注意事項、および必要ファイルについての説明を以下に示します。

◆動作環境

本APIは、以下のインストール種別で動作します。

• 運用管理サーバ
• 部門管理サーバ
• 業務サーバ

◆注意事項

• LIBファイル、およびINCLUDEファイルは、同じバージョン/レベルで提供されたものを使用してください。
• 監視メッセージのAPIは、マルチスレッドプログラミングをサポートしていません。

• “Mp_OpenMsg（）”関数を呼び出したプロセスは、“Mp_CloseMsg（）”関数を呼び出すまで終了しないでください。

• システム監視のAPIを使用するアプリケーションは、signal を使用しないでください。
• 監視メッセージのAPIの最大同時実行数は4つまでです。

• Mp_OpenMsg（）/Mp_ReadMsg（）/Mp_CloseMsg（）関数を利用するには、“システム監視のAPIを利用する”を実施する必要があります。

• Systemwalker Centric Managerのバージョンが異なる環境で作成されたシステム監視のAPIを使用するアプリケーションは動作しません。
  動作させるには、動作環境と同じSystemwalker Centric Managerのバージョンの環境下で、アプリケーションのリコンパイルを行ってください。

• Solaris OE版およびLinux版の運用管理サーバでシステム監視のAPIを使用するアプリケーションを実行するときは、環境変数“LD_LIBRARY_PATH”に“/opt/systemwalker/lib”と“/opt/FJSVfwbs/lib”を指定してください。

◆必要ファイル

上記監視メッセージのAPIを使用するには、以下のファイルが必要となります。

• UNIX版共通事項

  INCLUDEファイル

  INCLUDEファイルはどのOSの場合も以下のファイルが必要です。

  • /opt/systemwalker/include/f1egopag.h
  • /opt/systemwalker/include/mp_operr_api.h
  • /opt/systemwalker/include/mp_opagt_api.h

  ただし、mp_opagt_api.hをインクルードすれば他の2つもその中からインクルードされます。

• Solaris OE版

  リンクするライブラリ

  • /usr/lib/libpthread.so
  • /usr/lib/libopagtall.so
• Linux版:

  リンクするライブラリ

  • /usr/lib/libdl.so
  • /usr/lib/libopagtall.so
• AIX版:

  リンクするライブラリ

  • /usr/lib/libopagtall.so
• HP-UX版:

  リンクするライブラリ

  • /usr/lib/libopagtall.sl

■使用例

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

• メッセージを監視する
• メッセージログを読み出す

---

2.1.2.1 メッセージを監視する

2.1.2.2 メッセージログを読み出す