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

3.34 Mp_RespRemoteCmd（）関数

■機能説明

Mp_ExecRemoteCmd（）関数発行後、Mp_RespRemoteCmd（）関数を発行することにより、コマンド実行結果を1行ずつ読み出します。

Mp_RespRemoteCmd（）関数は、システム監視エージェントサービスに対して、コマンド実行結果の受信を要求し、すぐに呼び出し元に戻ります。

■呼び出し形式

#include <mp_opagt_api.h>
int Mp_RespRemoteCmd(fp, id, status, resp, node, rsv);

int  fp;       /*Mp_OpOpenRemoteCmd()で獲得したファイル記述子*/
int  *id;      /*コマンド要求に対応する記述子格納領域のアドレ*/
               /*ス                                          */
int  *status;  /*応答ステータス格納領域のアドレス            */
char *resp;    /*コマンドの実行結果、詳細コード格納領域のアド*/
               /*レス                                        */
char *node;    /*コマンドを応答したシステム名格納領域のアドレ*/
               /*ス                                          */
char *rsv;     /*リザーブ領域                                */

■パラメタ

fp:

Mp_OpenRemoteCmd（）で獲得した記述子を指定します。

id:

Mp_ExecRemoteCmd()によるコマンド要求の戻り値に対応させる記述子格納領域のアドレスを指定します。

status:

statusは、コマンドデータの種別です。応答ステータスには、以下のものがあり、どれかの値が格納されます。

コマンド結果応答

STATUS_OUT:標準出力に出力されたコマンドの結果です。

STATUS_ERR:標準エラー出力に出力されたコマンドの結果です。

コマンド最終応答

STATUS_END:コマンド応答が正常に終了しました(復帰コードあり)。

STATUS_AED:コマンド応答が終了しました(異常終了等)。

resp:

statusがコマンド結果応答の場合、実行されたコマンドの出力結果が格納されます。2048バイト分呼び出し元で準備します。statusがコマンド最終応答の場合、先頭4バイトにコマンドの詳細コードが格納されます。

応答ステータスがSTATUS_ENDの場合、詳細コードは以下の関数を使用して獲得してください。

・コマンドの終了状態

WIFEXITED

・コマンドの終了コード

WEXITSTATUS

上記関数の詳細はwait関数関連のマニュアルを参照してください。

応答ステータスがSTATUS_AEDの場合、詳細コードは、以下に示すコードのどれかです。

OP_RSPINFO_ABE:

コマンド実行中にシステムが停止しました。

OP_RSPINFO_NDE:

要求されたシステムが停止しています。

OP_RSPINFO_EXECERR:

資源不足等でコマンドの実行に失敗しました。

OP_RSPINFO_RSPERR:

コマンドは実行しましたが、その結果の獲得に失敗しました。

OP_RSPINFO_TPH:

通信パスに異常が発生しました。

OP_RSPINFO_LEN:

コマンド実行結果のテキストが長すぎて処理できません。

OP_RSPINFO_CEK:

ハードウェアが保守中のため、コマンドを投入できません。

OP_RSPINFO_LOC:

キーボードロック中で、コマンドを投入できません。

OP_RSPINFO_PAR:

内部論理エラーが発生しました。

OP_RSPINFO_AOT:

タイムアウトが発生しました。

OP_RSPINFO_EXC:

コマンドの送信に失敗しました。

OP_RSPINFO_SDW:

FTOPSII(SYSCOM)がスローダウンしました。

OP_RSPINFO_RST:

アテンションリセット中断が発生しました。

OP_RSPINFO_LOWERLEVEL:

機能レベルが低いために、コマンドを投入できません。

OP_RSPINFO_FTOPS2:

FTOPSIIへのコマンド投入は不可能です。

OP_RSPINFO_END:

コマンド応答が正常に終了しました(復帰コードなし)。

OP_RSPINFO_NOANSPART:

下位システムのシステム監視エージェントサービスが停止しているために、コマンドを投入できません。

OP_RSPINFO_NOANSRAS:

下位システムのシステム監視エージェントサービスが停止しているか、RASによる接続処理が行われていないために、コマンドを投入できません。

OP_RSPINFO_NOHST:

下位システムのIPアドレスが未定義のために、コマンドを投入できません。

OP_RSPINFO_CONREQ:

下位システムに対して接続依頼中のために、コマンドを投入できません。

node:

コマンドを応答したシステム名格納領域のアドレスを指定します。

■復帰値

0:

正常。コマンド実行結果を正常に受信。

−1:

異常。内部動作異常。