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

2.1.3 リモートコマンドのAPI

リモートコマンドのAPI一覧を以下に示します。

[リモートコマンドのAPI一覧]

関数名	機能
Mp_OpenRemoteCmd	リモートコマンドの開始要求
Mp_ExecRemoteCmd	リモートコマンドのコマンド実行要求
Mp_RespRemoteCmd	リモートコマンドの応答リード要求
Mp_GetRemoteCmdMap【Windows】	リモートコマンドの受信データの取出し要求
Mp_CloseRemoteCmd	リモートコマンドの終了要求
Mp_OpenRemoteCmdLog	リモートコマンドログの読み出し開始要求
Mp_ReadRemoteCmdLog	リモートコマンドログの読み出し要求
Mp_CloseRemoteCmdLog	リモートコマンドログの読み出し終了要求

リモートコマンドのAPI共通の動作環境、注意事項、および必要ファイルについての説明を以下に示します。

■動作環境

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

• 運用管理サーバ
• 部門管理サーバ
• 業務サーバ
• クライアント【Windows】

■注意事項

• LIBファイル、およびINCLUDEファイルは、同じバージョン/レベルで提供されたものを使用してください。
• リモートコマンドのAPIは、マルチスレッドプログラミングをサポートしていません。
• システム監視のAPIを使用するアプリケーションは、signal を使用しないでください。
• リモートコマンドのAPIの最大同時実行数は4つまでです。
• Systemwalker Centric Managerのバージョンが異なる環境で作成されたシステム監視のAPIを使用するアプリケーションは動作しません。
  動作させるには、動作環境と同じSystemwalker Centric Managerのバージョンの環境下で、アプリケーションのリコンパイルを行ってください。
• 本APIを使用する場合、SIGPIPEシグナルに対応したシグナルハンドラを無効にするかまたは、変更してください。この処理を実施しないと、Systemwalker停止時に本APIを使用しているプログラムがSIGPIPEシグナルにより終了する場合があります。設定方法の詳細は、OS提供のオンラインマニュアルを参考にしてください。
  関連関数：sigset
• リモートコマンドのAPIは、被監視システムにコマンドの発行を依頼し、その結果を受け取るためのAPIです。システム監視エージェントが動作していない場合には使用できません。
• Windows for Itanium版のアプリケーションから本APIを使用することはできません。
• Linux for Itaniumでは、コンパイルするときにプリプロセッサオプションとして“-D__LP64__”をつけてください。
• Linux for Itanium版では、アプリケーションはシステムのデフォルトロケールで作成してください。

■必要ファイル

上記リモートコマンドのAPIを使用するには、以下のファイルが必要となります。

【Windowsの場合】

リモートコマンドのAPIはLIBファイルに格納され、各APIで使用する定数、および構造体は、INCLUDEファイルに宣言されています。

• Systemwalkerインストールディレクトリ\MPWALKER.DM\Lib\mpopagt.lib
• Systemwalkerインストールディレクトリ\MPWALKER.DM\Include\mp_opagt_api.h、Include\mp_operr_api.h
• Systemwalkerインストールディレクトリ\MPWALKER.DM\Bin\mpopagt.dll

【UNIXの場合】

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

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

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

• ライブラリ

  OS	リンクするライブラリ
  Solaris	/usr/lib/libopagtall.so
  Linux	/usr/lib/libdl.so /usr/lib/libopagtall.so
  AIX	/usr/lib/libopagtall.so
  HP-UX	/usr/lib/libopagtall.sl

◆コンパイル環境

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

【Windowsの場合】

• コンパイラ : Microsoft Visual C++ 6.0
• ランタイムライブラリ : “マルチスレッド（DLL）”を使用してください。

【UNIXの場合】

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