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

3.42 Mp_ReadEventLog（）関数

■機能説明

Mp_OpenEventLog（）発行後、Mp_ReadEventLog（）関数を発行することによりロギングされた監視イベントを、1イベントずつ読み出します。

■呼び出し形式

#include <mp_opmgr_api.h>
int    Mp_ReadEventLog( fp, hisnum, status, category, timerec, logtime,
                        nodename, NodeID, DatabaseID, folder,
                        application, dealer, eventtext, level, evttype,
                        jobnum, memo, chgstime, chgetime, IPaddr,
                        reserve);

int        fp;         /*ファイル識別子を指定する            */
long       *hisnum;    /*監視イベント番号格納領域のアドレス  */
                       /*を指定する                          */
unsigned long *status; /*イベントの状態格納領域のアドレスを指*/
                       /*定する                              */
char       *category;  /*監視イベントの種別格納領域のアドレス*/
                       /*を指定する                          */
time_t     *timerec;   /*イベントの発生日時格納領域のアドレス*/
                       /*を指定する                          */
time_t     *logtime;   /*イベントのロギング日時格納領域のアド*/
                       /*レスを指定する                      */
char       *nodename;  /*ノード名格納領域のアドレスを指定する*/
DWORD      *rsv;       /*リザーブ領域                        */
DWORD      *rsv;       /*リザーブ領域                        */
char       *folder;    /*フォルダ名格納領域のアドレスを指定  */
                       /*する                                */
char     *application; /*表示名格納領域のアドレスを指定する  */
char       *dealer;    /*対応者格納領域のアドレスを指定する  */
char       *eventtext; /*イベントテキスト格納領域のアドレスを*/
                       /*指定する                            */
unsigned long  *level; /*イベントの重要度レベル格納領域のアド*/
                       /*レスを指定する                      */
unsigned long *evttype; /*イベントの属性格納領域のアドレスを指*/
                       /*定する                              */
char       *jobnum;    /*ジョブ番号格納領域のアドレスを指定す*/
                       /*る                                  */
char       *memo;      /*メモ格納領域のアドレスを指定する    */
time_t     *chgstime;  /*イベントの対処開始日時格納領域のアド*/
                       /*レスを指定する                      */
time_t     *chgetime;  /*イベントの対処終了日時格納領域のアド*/
                       /*レスを指定する                      */
unsigned int  *IPaddr; /*IPアドレス格納領域のアドレスを指定す*/
                       /*る                                  */
unsigned char *reserve; /*予約格納領域のアドレスを指定する   */

■パラメタ

fp:

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

hisnum:

監視イベントの発生順序を示す監視イベント番号が格納されます。

status:

監視イベントに対する対処の状況が格納されます。
このパラメタには、以下の値のどれかが格納されます。

MPOP_RE_NOFIXEVT:

監視イベントの状態は[未対処]

MPOP_RE_DEFEVT:

監視イベントの状態は[保留]

MPOP_RE_UINVEVT:

監視イベントの状態は[調査中]

MPOP_RE_FIXEVT:

監視イベントの状態は[対処済]

MPOP_RE_REPEVT:

監視イベントの状態は[返答済]

category:

発生した監視イベントの種別が格納されます。
MPOP_CATEGORYLENバイト分呼び出し元で準備します。

timerec:

被監視システムで、イベントが発生した日時が格納されます。
ただし、日時が正しく獲得できなかった場合、以下のように値が設定されます。

日付、時刻が獲得できない/項目がない場合:

0x00FFFFFF

日付だけ獲得できない場合:

0x00hhmmss

hh:

時（0x00 〜0x17）

mm:

分（0x00 〜0x3B）

ss:

秒（0x00 〜0x3B）

logtime:

監視イベントがイベントログに格納された日時が格納されます。日付、時刻が獲得できない、または日付だけ獲得できない場合は、timerecと同様の設定になります。

nodename:

監視イベントが発生したシステムのノード名が格納されます。
MPOP_NODENAMELENバイト分呼び出し元で準備します。

folder:

監視イベントが発生したシステムのフォルダ名が格納されます。
MPOP_FOLDERLENバイト分呼び出し元で準備します。

application:

監視イベントが発生したシステムの表示名が格納されます。
MPOP_APPLICATIONLENバイト分呼び出し元で準備します。

dealer:

監視イベントに対応した人の名前が格納されます。
MPOP_DEALERLENバイト分呼び出し元で準備します。

eventtext:

発生したイベントテキストが格納されます。
MPOP_EVENTLENバイト分呼び出し元で準備します。

level:

監視イベントの重要度レベルが格納されます。
このパラメタには、以下の値のどれかが格納されます。

MPOP_RE_SPEMG:

最重要

MPOP_RE_EMG:

重要

MPOP_RE_WARN

警告

evttype:

監視イベントの属性が格納されます。
このパラメタには、以下の値のどれかが格納されます。

MPOP_RE_NORMTYP:

監視イベントの属性は[一般]

MPOP_RE_REPLYTYP:

監視イベントの属性は[返答要求]

MPOP_RE_SPCLTYP:

監視イベントの属性は[高輝度]

jobnum:

監視イベントに対するジョブ番号が格納されます。
MPOP_JOBNUMLENバイト分呼び出し元で準備します。

memo:

監視イベントに対するユーザメモが格納されます。
MPOP_MEMOLENバイト分呼び出し元で準備します。

chgstime:

監視システムで、イベントの対処を開始した日時が格納されます。
日付、時刻が獲得できない、または日付だけ獲得できない場合は、timerecと同様の設定になります。

chgetime:

監視システムで、イベントの対処を終了した日時が格納されます。
日付、時刻が獲得できない、または日付だけ獲得できない場合は、timerecと同様の設定になります。

IPaddr:

監視システムが発生したシステムのIPアドレスが格納されます。

reserve:

1バイトの予約域です。

■参照

システム監視のAPI、Mp_OpenEventLog（）関数、Mp_CloseEventLog（）関数を参照してください。

■復帰値

1:

正常終了（監視イベントを正常に獲得）。

0（EOF）:

正常終了（監視イベントをすべて獲得）。

−1:

異常終了。

備考

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

■API格納場所

Systemwalkerインストールディレクトリ\mpwalker.dm\bin

■動作環境による差異

運用管理サーバで使用可能です。