5.2.3　MCFイベント情報の形式（C言語）

(a)　形式

struct dc_mcf_evtheader {
  char mcfevt_name[9] ;        … MCFイベントコード
  char le_name[16] ;           … 論理端末名称
  char cn_name[9] ;            … MCF使用領域
  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では，閉塞解除または閉塞した論理端末名称が設定されます。

• time

  メッセージを入力した時刻が，1970年1月1日0時0分0秒からの通算の秒数で設定されます。

(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以外から送信された場合はヌル文字が設定されます。

(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の理由コードが設定されます。理由コードの詳細については，「付録I　理由コード一覧」を参照してください。

(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が次の形式で設定されます。

  

(a)　形式

struct dc_mcf_evta_type {
  struct dc_mcf_evtheader  evtheader ; 
                               … MCFイベント共通ヘッダ
  char   reserve01[12] ;       … 予備
  char   reserve02[10] ;       … 予備
  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以外から送信された場合はヌル文字が設定されます。

(a)　形式

typedef struct {
    struct dc_mcf_evtheader  header ;
                               … MCFイベント共通ヘッダ
    DCLONG err_fact ;          … 障害要因コード(4バイト)
    DCLONG err_reason1 ;       … 理由コード1(4バイト)
    DCLONG err_reason2 ;       … 理由コード2(4バイト)
    char   reserve1[48];       … 予備
} dcmudp_cerrevt ;

(b)　MCFイベントとして設定される項目

• err_fact

  CERREVTの障害要因コードが，次に示す値で設定されます。

  (00000031)₁₆

  論理端末障害発生

• err_reason1，err_reason2

  CERREVTの理由コード1，理由コード2が設定されます。「付録I　理由コード一覧」を参照してください。

(a)　形式

typedef struct {
  struct dc_mcf_evtheader  header ;
                               … MCFイベント共通ヘッダ
  char  reserve1[60];          … 予備
} dcmudp_statevt ;

(b)　MCFイベントとして設定される項目

ありません。