3.16 Mp_GetEventMap（）関数

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

目次索引

第3章 APIリファレンス

3.16 Mp_GetEventMap（）関数

◆機能説明

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;     /*  ＩＰアドレス格納領域のアドレスを*/
                           /*     指定する                   */
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:: 状態が変更された監視イベントのデータが読み出された。

◆参照

Mp_OpenEvent（）,Mp_ReadEvent（）,Mp_CloseEvent（）

◆復帰値

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

◆API格納場所

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

◆動作環境による差異

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

目次索引