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

3.29 Mp_ReadRemoteCmdLog（）関数

◆機能説明

Mp_OpenRemoteCmdLog（）発行後、Mp_ReadRemoteCmdLog（）関数を発行することにより、ロギングされたコマンドデータを1行ずつ読み出します。

◆呼び出し形式

#include <mp_opagt_api.h>
int Mp_ReadRemoteCmdLog( fp, id, logtime, status, text, node,
                         NodeID, DatabaseID );

int  fp;          /*  Mp_OpenRemoteCmdLog()で獲得したファイル識*/
                  /*    別子を指定する                        */
int  *id;         /*  コマンド要求とコマンド応答を対応づける識別*/
                  /*    子の格納領域のアドレスを指定する       */
time_t *logtime;  /*  コマンドデータが自システムに通知された日時*/
                  /*    の格納領域のアドレスを指定する         */
int  *status;     /*  ステータスの格納領域のアドレスを指定する  */
char *text;       /*  要求コマンドテキスト、コマンドの実行結果、*/
                  /*  詳細コードの格納領域のアドレスを指定する  */
char *node;       /*  コマンド要求先システムまたはコマンドを応答*/
                  /*    したシステムのノード名の格納領域のアドレ*/
                  /*    スを指定する                          */
char *rsv;       /*  NULLを指定する                          */

◆パラメタ

fp:

Mp_OpenRemoteCmdLog（）で獲得したファイル識別子を指定します。

id:

Mp_ExecRemoteCmd（）の復帰コードに対応する識別子が格納されます。
これにより、どのコマンド要求に対するコマンド応答かを識別することができます。

logtime:

システム監視エージェントサービスがコマンドログファイルに格納した日時が格納されます。

status:

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

コマンド要求
    STATUS_IN:コマンドの発行要求です。
コマンド結果応答
    STATUS_OUT:標準出力に出力されたコマンドの結果です。
    STATUS_ERR:標準エラー出力に出力されたコマンドの結果です。
コマンド最終応答
    STATUS_END:コマンド応答が正常に終了しました
                (復帰コードあり)。
    STATUS_AED:コマンド応答が終了しました(異常終了等)。

text:

statusがコマンド要求の場合、発行されたコマンドテキストが格納されます。
statusがコマンド結果応答、およびコマンド最終応答の場合、textには、Mp_GetRemoteCmdMap（）のパラメタrespと同じ値が格納されます。
2048バイト分呼び出し元で準備します。

node:

statusがコマンド要求の場合はコマンド要求先のシステムのノード名、statusがコマンド結果応答、およびコマンド最終応答の場合はコマンドを応答したシステムのノード名が格納されます。
MPOP_NODENAMELENバイト分呼び出し元で準備します。

NodeID:

statusがコマンド要求の場合は、コマンド要求先のシステムのノードIDが格納されます。
statusがコマンド結果応答、およびコマンド最終応答の場合は、コマンドを応答したシステムのノードIDが格納されます。

DatabaseID:

statusがコマンド要求の場合は、コマンド要求先のシステムのデータベースIDが格納されます。
statusがコマンド結果応答、およびコマンド最終応答の場合は、コマンドを応答したシステムのデータベースIDが格納されます。

◆復帰値

1:

正常終了。メッセージを正常に獲得。

0:

正常終了。メッセージをすべて獲得。

−1:

異常終了。詳細なエラーコードは、GetLastError（）で取得してください。