分散トランザクション処理機能 OpenTP1 プロトコル TP1/NET/XMAP3編

[目次][用語][索引][前へ][次へ]

5.1.4 出力メッセージ編集UOCインタフェース

出力メッセージ編集UOCは,次に示す形式で呼び出します。

<この項の構成>
(1) 形式
(2) 説明
(3) パラメタの内容
(4) MCFが設定する項目
(5) ユーザが値を設定する項目
(6) リターン値

(1) 形式

ANSI C,C++の形式
 
#include <dcmcfuoc.h>
#include <dcmxpn.h>
DCLONG uoc_func(dcmcf_uoc_mout_n *parm)
 
K&R版 Cの形式
 
#include <dcmcfuoc.h>
#include <dcmxpn.h>
DCLONG uoc_func(parm)
 
dcmcf_uoc_mout_n *parm;
 

(2) 説明

uoc_func(出力メッセージ編集UOC)を呼び出す場合,MCFは次に示すパラメタをparmに設定します。

(3) パラメタの内容

(a) dcmcf_uoc_mout_nの内容
 
typedef struct {
  DCLONG pro_kind;                 …プロトコル種別
  char le_name[9];                 …論理端末名称
  char reserve1[7];                …予備
  dcmcf_uocbuff_list_n *buflist_adr;
                                   …送信バッファリストアドレス
  dcmcf_uocbuff_list_n *ebuflist_adr;
                                   …編集バッファリストアドレス
  DCLONG output_no;                …メッセージ出力通番
  char msg_type;                   …メッセージ種別
  char outputno_flag;              …メッセージ出力通番有効フラグ
  char resend_flag;                …再送メッセージフラグ
  char reserve2[1];                …予備
  char *pro_indv_ifa;
                                   …プロトコル個別インタフェース領域
  DCLONG rtn_detail;               …詳細リターンコード
  char reserve3[20];               …予備
} dcmcf_uoc_mout_n;
 
(b) dcmcf_uocbuff_list_n(バッファリスト)の内容

5.1.2 入力メッセージ編集UOCインタフェース」を参照してください。

(c) dcmcf_uocbufinf_n(バッファ情報)の内容

5.1.2 入力メッセージ編集UOCインタフェース」を参照してください。

(d) dcmxp_mout_ifa(プロトコル個別インタフェース)の内容
 
typedef struct {
  char map_name[9];           …要求マップ名
  char reserve1[7];           …予備
  char print_map_name[9];     …表示中マップ名
  char reserve2[7];           …予備
  char device[8];             …デバイス
  char *inf_adr;              …MCF使用領域
  char reserve3[20];          …予備
} dcmxp_mout_ifa;
 

デバイスについては,「5.1.2 入力メッセージ編集UOCインタフェース」を参照してください。

(4) MCFが設定する項目

(a) dcmcf_uoc_mout_n
(b) dcmcf_uocbuff_list_n(バッファリスト)
(c) dcmcf_uocbufinf_n(バッファ情報)
(d) dcmxp_mout_ifa(プロトコル個別インタフェース)

(5) ユーザが値を設定する項目

(a) dcmcf_uoc_mout_n
(b) dcmcf_uocbuff_list_n(バッファリスト)
(c) dcmcf_uocbufinf_n(バッファ情報)
(d) dcmxp_mout_ifa(プロトコル個別インタフェース)

(6) リターン値

uoc_func()は次のコードでリターンしてください。

リターン値 意味
DCMCF_UOC_MSG_OK 正常リターン(編集バッファでスケジューリング)
DCMCF_UOC_MSG_OK_SND 正常リターン(送信バッファでスケジューリング)
DCMCF_UOC_MSG_NG メッセージ編集エラー