ANSI C，C++の形式

 
#include <dcmcf.h>
#include <dcmcfuoc.h>
#include <dcmpcm.h>
#include <dcmhsc2.h>
DCLONG    uoc_func(dcmcf_uoc_min_n *parm)
 

K&R版 Cの形式

 
#include <dcmcf.h>
#include <dcmcfuoc.h>
#include <dcmpcm.h>
#include <dcmhsc2.h>
DCLONG    uoc_func(parm)
 
dcmcf_uoc_min_n *parm ;
 

uoc_func（論理端末名称決定UOC）を呼び出すとき，MCFは次に示す所定のパラメタをparmに設定します。

(a)　dcmcf_uoc_min_nの内容

 
typedef struct {
    DCLONG pro_kind;            …プロトコル種別
    char   le_name[9];          …論理端末名称 
    char   reserve1[7];         …予備
    DCLONG rcv_prim;            …受信サ−ビスプリミテイブ
    dcmcf_uocbuff_list_n *buflist_adr;
                                …受信バッファリストアドレス
    dcmcf_uocbuff_list_n *ebuflist_adr;
                                …未使用
    char   aplname[9];          …未使用
    char   reserve2[7];         …予備
    char   *pro_indv_ifa;       …dcmhs2_uoc_protを示すポインタ変数
    DCLONG rtn_detail;          …詳細リターンコード
    char   reserve3[8];         …予備
} dcmcf_uoc_min_n;
 

なお，dcmcf_uoc_min_nは，<dcmcfuoc.h>で定義されています。

(b)　dcmcf_uocbuff_list_n（バッファリスト）の内容

 
typedef struct {
    DCLONG buf_num;             …バッファ情報数
    DCLONG used_buf_num;        …使用バッファ情報数
    char   reserve1[8];         …予備
    dcmcf_uocbufinf_n buf_array[DCMCF_UOC_BUFF_MAX];
                                …バッファ情報
} dcmcf_uocbuff_list_n;
 

なお，dcmcf_uocbuff_list_nは，<dcmcfuoc.h>で定義されています。

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

 
typedef struct {
    char    *buf_adr;           …バッファアドレス
    DCULONG buf_size;           …バッファ最大長
    DCULONG seg_size;           …バッファ使用長（セグメント長）
    char    reserve1[4];        …予備
    dcmcfuoc_w_type buff_id;    …MCF内部情報1
    DCMLONG buff_addr;          …MCF内部情報2
    char    reserve2[4];        …予備
} dcmcf_uocbufinf_n;
 

なお，dcmcf_uocbufinf_nは，<dcmcfuoc.h>で定義されています。

(d)　dcmhsc2_uoc_protの内容

 
typedef struct {
    DCLONG le_num;              …定義されている論理端末数
    DCLONG reserve[3];          …予備
    dcmhs2_le_inf le_list[DCMHS2_UOC_LE_MAX];
                                …論理端末名称リスト
} dcmhsc2_uoc_prot;
typedef struct {
    char   le_name[16];         …論理端末名称 
    DCLONG le_inf;              …論理端末の状態
}  dcmhs2_le_inf

(a)　dcmcf_uoc_min_n

• pro_kind
  プロトコル種別として，次の値が設定されます。
  

  DCMCF_UOC_PRO_HSC2

  HSC2手順

• le_name
  ヌル文字が設定されます。
  
• rcv_prim
  受信サービスプリミティブとして，次の値が設定されます。
  

  DCMCF_UOC_RCV_BRD

  一方送信メッセージの受信

• buflist_adr
  受信用バッファリストのアドレスが設定されます。
  
• ebuflist_adr
  未使用の項目です。ヌル文字が設定されます。
  
• aplname
  未使用の項目です。ヌル文字が設定されます。
  
• pro_indv_ifa
  dcmhs2_uoc_protを示すポインタ変数です。
  

(b)　dcmcf_uocbuff_list_n（バッファリスト）

• buf_num
  バッファ情報の数が設定されます。
  
• buf_array
  バッファ情報の配列が設定されます。バッファ情報は，buf_numの数だけ設定されます。
  

(c)　dcmcf_uocbufinf_n（バッファ情報）

• buf_adr
  バッファのアドレスが設定されます。
  
• buf_size
  バッファの最大長が設定されます。
  
• seg_size
  送信，または受信用バッファリストの場合だけ，バッファの使用長（セグメント長）が設定されます。
  
• buff_id，buff_addr
  MCFで使用するパラメタです。
  

(d)　dcmhsc2_uoc_prot

• le_num
  定義されている論理端末の数が設定されます。
  
• le_list
  論理端末名称のリストが設定されます。
  
• le_inf
  論理端末の状態が設定されます。
  

  DCMHS2_LE_USE

  論理端末はほかの回線で使用されています。

  DCMHS2_LE_NOUSE

  論理端末は使用されていません。

(a)　dcmcf_uoc_min_n

• rtn_detail
  詳細リターンコードを設定します。
  このコードは，UOCがDCMCF_UOC_MSG_NGをリターンしたときに，MCFに渡されます。MCFは，詳細リターンコードをメッセージログファイルに出力します。詳細リターンコードは-19999〜-19000の範囲で指定してください。
  

(b)　dcmhsc2_uoc_prot

• le_name
  論理端末名称を設定します。
  

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

リターン値	意味
DCMCF_UOC_MSG_OK	正常リターン
DCMCF_UOC_MSG_NG	メッセージ編集エラー

UOCインタフェース用のパラメタとバッファの関係を次の図に示します。

図5-1　UOCインタフェース用のパラメタとバッファの関係（論理端末名称決定UOCの場合）

注※

バッファ情報は32バイトで，次の形式をしています。