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は、マルチスレッドプログラミングをサポートしていません。
• コンパイル環境として、コンパイラは、VisualC++（バージョン5.0以降）を、ランタイムライブラリは“マルチスレッド（DLL）”を使用してください。

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

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

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

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

◆必要ファイル

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

監視メッセージのAPIはLIBファイルに格納し、各APIで使用する定数および構造体はINCLUDEファイルに宣言します。

• /opt/FJSVfwbs/lib/libopagtall.so、libthread.so
• /opt/systemwalker/include/mp_opmgr_api.h

■使用例

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

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

---

2.1.2.1 メッセージを監視する

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