Systemwalker Centric Manager APIガイド - UNIX共通 -
目次 索引 前ページ次ページ
第3章 APIリファレンス

3.30 Mp_ReadEventLog（）関数

■機能説明

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

■呼び出し形式

[UNIX版の場合]

#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;        /*ノード名格納領域のアドレスを指*/
                             /*定する                        */
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;      /*予約格納領域のアドレスを指定す*/
                             /*る                            */

[Linux for Itanium版の場合]

#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);

long       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:
監視イベントがイベントログに格納された日時が格納されます。日付、時刻が獲得できない、または日付だけ獲得できない場合は、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:
異常終了。

備考

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

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

■API格納場所

/usr/lib

■動作環境による差異

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

目次 索引 前ページ次ページ
All Rights Reserved, Copyright(C) 富士通株式会社 1995-2005