5.2.3 MCFイベント情報の形式（C言語）
MCFイベント情報は構造体で，MCFイベント処理用MHPに渡されます。MHPに渡される構造体の形式は，MCFイベントの種類によって異なります。ただし，MCFイベント情報の先頭部分の形式は，各イベントで共通です。
エラーイベント（ERREVTn）で使用する構造体は，<dcmcf.h>で定義してあります。なお，dcmoum_statevtは，<dcmoum.h>で定義されています。<dcmoum.h>の前に<dcmcf.h>を取り込んでおいてください。
- 〈この項の構成〉
(1) MCFイベントの共通ヘッダ
(a) 形式
struct dc_mcf_evtheader {
char mcfevt_name[9]; …MCFイベントコード
char le_name[16]; …入力元論理端末名称
(ERREVT1,ERREVT2,ERREVT3の場合)
出力先論理端末名称
(ERREVTAの場合)
char cn_name[9]; …コネクション名
unsigned char format_kind; …MCF使用領域
char reserve01; …予備
DCLONG time; …メッセージ入力時刻
};(b) MCFイベントとして設定される項目
-
le_name
ERREVT1，ERREVT2，またはERREVT3では，メッセージを入力した論理端末名称が設定されます。
ただし，ERREVT2またはERREVT3で，次に示す場合は，'*'が設定されます。
-
SPPからアプリケーション起動機能で起動したMHPで，障害が発生した場合
-
上記の障害が発生したあとに，MCFイベントとして起動したMHPからさらにアプリケーション起動機能で起動したMHPで，障害が発生した場合
ERREVTAでは，メッセージを出力する論理端末名称が設定されます。
CERREVTでは，論理端末障害が発生した論理端末名称が設定されます。コネクション障害時は無効です。
COPNEVTでは，閉塞解除した論理端末名称が設定されます。コネクション確立時は無効です。
CCLSEVTでは無効です。
-
-
cn_name
コネクション名が設定されます。
ただし，ERREVT2またはERREVT3で，次に示す場合は，'*'が設定されます。
-
SPPからアプリケーション起動機能で起動したMHPで，障害が発生した場合
-
上記の障害が発生したあとに，MCFイベントとして起動したMHPからさらにアプリケーション起動機能で起動したMHPで，障害が発生した場合
-
-
time
メッセージを入力した時刻が，1970年1月1日0時0分0秒からの通算の秒数で設定されます。
(2) ERREVT1
(a) 形式
struct dc_mcf_evt1_type {
struct dc_mcf_evtheader evtheader ;
…MCFイベント共通ヘッダ
char reserve01[12] ; …予備
char reserve02[10] ; …予備
char reserve03[2] ; …予備
char ap_name[10] ; …アプリケーション名
(メッセージに対応する
アプリケーション名)
char reserve04[2] ; …予備
};(b) MCFイベントとして設定される項目
-
ap_name
次に示すどちらかが設定されます。
-
形式不正の場合…不正となったアプリケーション名
-
定義されていない場合…定義されていないアプリケーション名
アプリケーション名は，MHPから送信されたメッセージの場合に設定されます。MHP以外から送信された場合は，ヌル文字が設定されます。
-
(3) ERREVT2
(a) 形式
struct dc_mcf_evt2_type {
struct dc_mcf_evtheader evtheader ;
…MCFイベント共通ヘッダ
char reserve01[12] ; …予備
char reserve02[10] ; …予備
char reserve03[2] ; …予備
char ap_name[10] ; …アプリケーション名
(メッセージに対応する
アプリケーション名)
short reason_code ; …理由コード
};(b) MCFイベントとして設定される項目
-
ap_name
エラーになったUAPのアプリケーション名が設定されます。
アプリケーション名は，MHPから送信されたメッセージの場合に設定されます。MHP以外から送信された場合は，ヌル文字が設定されます。
-
reason_code
ERREVT2の理由コードが設定されます。理由コードの詳細については，「付録H 理由コード一覧」を参照してください。
(4) ERREVT3
(a) 形式
struct dc_mcf_evt3_type {
struct dc_mcf_evtheader evtheader ;
…MCFイベント共通ヘッダ
char reserve01[12] ; …予備
char map_name[10] ; …MCF使用領域
char reserve03[2] ; …予備
char ap_name[10] ; …アプリケーション名
(異常が発生したメッセージの
アプリケーション名）
char reserve04[2] ; …予備
char service_name[32] ; …サービス名
char serv_grp_name[32] ; …サービスグループ名
char bid[36] ; …トランザクションブランチID領域
};(b) MCFイベントとして設定される項目
-
ap_name
異常が発生したMHPのアプリケーション名が設定されます。
アプリケーション名は，MHPから送信されたメッセージの場合に設定されます。MHP以外から送信された場合は，ヌル文字が設定されます。
-
service_name
異常が発生したMHPのアプリケーション名に対応するサービス名が設定されます。
-
serv_grp_name
異常が発生したMHPのサービスが属するサービスグループ名が設定されます。
-
bid
トランザクションブランチIDが次の形式で設定されます。
![[図データ]](GRAPHICS/ZU040500.GIF)
(5) ERREVTA
(a) 形式
struct dc_mcf_evta_type {
struct dc_mcf_evtheader evtheader ;
…MCFイベント共通ヘッダ
char reserve01[12] ; …予備
char map_name[10] ; …MCF使用領域
char reserve03[2] ; …予備
char ap_name[10] ; …アプリケーション名
(正常終了したメッセージの
アプリケーション名)
char reserve04[2] ; …予備
char reserve05[32] ; …予備
char reserve06[32] ; …予備
DCLONG user_leng ; …他プロトコルの場合の使用領域
char user_data[16] ; …他プロトコルの場合の使用領域
char reserve07[16] ; …予備
};(b) MCFイベントとして設定される項目
-
ap_name
正常終了したメッセージのアプリケーション名が設定されます。
アプリケーション名は，MHPから送信されたメッセージの場合に設定されます。MHP以外から送信された場合は，ヌル文字が設定されます。
(6) CERREVT
(a) 形式
typedef struct {
struct dc_mcf_evtheader header ;
…MCFイベント共通ヘッダ
DCLONG err_fact ; …障害要因コード（4バイト）
DCLONG err_reason1 ; …理由コード1（4バイト）
DCLONG err_reason2 ; …理由コード2（4バイト）
DCLONG err_rcv_action ; …MCF使用領域
char rname[16] ; …MCF使用領域
char reserve1[26] ; …予備
} dcmoum_cerrevt ;(b) MCFイベントとして設定される項目
-
err_fact
CERREVTの障害要因コードが，次に示す値で設定されます。
- (00000030)16
-
コネクション障害発生
- (00000031)16
-
論理端末障害発生
-
err_reason1，err_reason2
CERREVTの理由コードが設定されます。「付録H 理由コード一覧」を参照してください。
(7) COPNEVT，CCLSEVT
(a) 形式
typedef struct {
struct dc_mcf_evtheader header ;
…MCFイベント共通ヘッダ
DCLONG notice_fact ; …通知要因コード
char reserve1[12] ; …予備
char rname[16] ; …MCF使用領域
char reserve2[26] ; …予備
} dcmoum_statevt ;(b) MCFイベントとして設定される項目
-
notice_fact
COPNEVTの場合，通知された要因が次に示す値で設定されます。
- (00000030)16
-
コネクション確立
- (00000031)16
-
論理端末閉塞解除