3.26 Mp_ReadEventLog（）関数

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

目次索引

第3章 APIリファレンス

3.26 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, IPadddr,
                        reserve);

int        fp;               /*ファイル識別子を指定する           */
long       *hisnum;          /*監視イベント番号格納領域のアドレスを*/
                             /*  指定する                        */
unsigned long  *status;      /*イベントの状態格納領域のアドレスを指*/
                             /*  定する                          */
char       *category;        /*監視イベントの種別格納領域のアドレス*/
                             /*  を指定する                      */
time_t     *timerec;         /*イベントの発生日時格納領域のアドレス*/
                             /*  を指定する                      */
time_t     *logtime;         /*イベントのロギング日時格納領域のアド*/
                             /*  レスを指定する                  */
char       *nodename;        /*ノード名格納領域のアドレスを指定する*/
unsigned long  *NodeID;      /*リザーブ領域                      */
unsigned long  *DatabaseID;  /*リザーブ領域                      */
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:

イベントをロギングした日時が格納されます。
システム監視エージェントサービスが、メッセージをメッセージログファイルに格納した時間です。
ただし、日時が正しく獲得できなかった場合、0x00FFFFFFが設定されます。

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:

監視システムでイベントの対処を開始した日時が格納されます。
ただし、日時が正しく獲得できなかった場合、0x00FFFFFFが設定されます。

chgetime:

監視システムで、イベントの対処を終了した日時が格納されます。
ただし、日時が正しく獲得できなかった場合、0x00FFFFFFが設定されます。

IPaddr:

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

reserve:

1バイトの予約域です。

◆参照

Mp_OpenEventLog（）,Mp_CloseEventLog（）

◆復帰値

1:: 正常終了（監視イベントを正常に獲得）。
0（EOF）:: 正常終了（監視イベントをすべて獲得）。
－1:: 異常終了。

◆備考

異常終了した場合の詳細なエラーコードは、errnoに設定されます。

errnoには、システムのエラーコード（/usr/include/sys/errno.hに定義）、または/opt/systemwalker/include/mp_operr_api.hに定義されている値が設定されます。

◆API格納場所

/usr/lib

◆動作環境による差異

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

目次索引