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

3.25 Mp_ReadEvent（）関数

◆機能説明

Mp_OpenEvent（）発行後、Mp_ReadEvent（）関数を発行することにより、監視イベントを1イベントずつ読み出します。

◆呼び出し形式

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

int    fp;                   /* Mp_OpenEvent()で獲得したファイル記述子*/
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;      /* 予約格納領域のアドレスを指定する       */
unsigned long  *rddatatyp;   /* イベントデータの種類格納領域のアドレスを*/
                            /*   指定する                             */

◆パラメタ

fp:

Mp_OpenEvent（）で獲得したファイル記述子を指定します。

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〜ox3B）

logtime:

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

nodename:

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

NodeID:

リザーブ領域。

DatabaseID:

リザーブ領域。

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:

監視システムで、イベントの対処を開始した日時が格納されます。
発生イベント（rddatatyp==MPOP_GEM_MONITOR）の場合は0が格納されます。
ただし、獲得日時が正しくない場合は、0x00FFFFFFが設定されます。

chgetime:

監視システムで、イベントの対処を終了した日時が格納されます。
発生イベント（rddatatyp==MPOP_GEM_MONITOR）の場合は0が格納されます。
ただし、獲得日時が正しくない場合は、0x00FFFFFFが設定されます。

IPaddr:

監視システムが発生したシステムのIPアドレスが格納されます。
IPアドレスがない場合は、0が格納されます。

reserve:

1バイトの予約域です。

rddatatyp:

読み出したイベントデータの種類が格納されます。
このパラメタには、以下の値のどちらかが格納されます。

MPOP_GEM_MONITOR:

Systemwalker Centric Managerに通知された監視イベントのデータが読み出された。

MPOP_GEM_CHSTATUS:

状態が変更された監視イベントのデータが読み出された。

◆参照

Mp_OpenEvent（）,Mp_CloseEvent（）

◆復帰値

0:

正常終了。

−1:

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

◆API格納場所

/usr/lib

◆動作環境による差異

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