3.16 Mp_GetEventMap（）関数【Windows版】

Systemwalker Centric Manager APIガイド - UNIX/Windows(R)共通 -

目次索引

第3章 APIリファレンス

3.16 Mp_GetEventMap（）関数【Windows版】

■機能説明

Mp_ReadEvent（）発行後にイベントの受信が完了し、Mp_GetEventMap（）関数を呼び出すことにより、イベントのデータを取り出します。

■呼び出し形式

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

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

■パラメタ

buf:

Mp_ReadEvent（）で指定したバッファを指定します。

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:

イベントをロギングした日時が格納されます。
システム監視エージェントサービスが、メッセージをメッセージログファイルに格納した時間です。

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:

監視システムでイベントの対処を開始した日時が格納されます。

chgetime:

監視システムでイベントの対処を終了した日時が格納されます。

IPaddr:

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

reserve:

1バイトの予約域です。

rddatatyp:

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

MPOP_GEM_MONITOR:: Systemwalker Centric Managerに通知された監視イベントのデータが読み出された。
MPOP_GEM_CHSTATUS:: 状態が変更された監視イベントのデータが読み出された。

■実行に必要な権限/実行環境

【Windows版】

運用管理サーバでは、Administrator権限/DmAdmin権限/DmOperation権限/DmReference権限が必要です。
運用管理サーバで実行可能です。

■参照

以下のシステム監視のAPIを参照してください。

Mp_OpenEvent（）関数
Mp_ReadEvent（）関数
Mp_CloseEvent（）関数

■復帰値

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

■API格納場所

“監視イベントのAPI”を参照してください。

■動作環境による差異

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

目次索引