ANSI C，C++　の形式

 
#include<dcmcf.h>
int dc_mcf_recvsync (DCLONG action, DCLONG commform, 
                     char *termnam,char *resv01, 
                     char *recvdata,DCLONG *rdataleng,
                     DCLONG inbufleng, DCLONG *time,
                     DCLONG resv02)
 

K&R版C　の形式

 
#include<dcmcf.h>
int dc_mcf_recvsync (action, commform, termnam, resv01,
                     recvdata, rdataleng, inbufleng,
                     time, resv02)
DCLONG action;
DCLONG commform;
char   *termnam;
char   *resv01;
char   *recvdata;
DCLONG *rdataleng;
DCLONG inbufleng;
DCLONG *time;
DCLONG resv02;
 

相手システムから届いた論理メッセージ（同期型で受信）のうち，先頭セグメント以外の後続する一つのセグメントを受信します。先頭セグメントを受信するdc_mcf_sendrecv関数のあとに，後続するセグメントの数だけdc_mcf_recvsync関数を発行することによって一つの論理メッセージを受信できます。

セグメントを受信する領域の形式を次に示します。Lは，バッファ形式1の場合は8バイト，バッファ形式2の場合は4バイトです。

• 　action
  受信するセグメントが論理メッセージの先頭セグメントかどうかを，次の形式で設定します。
  

   
  DCMCFSEG〔|{DCMCFBUF1|DCMCFBUF2}〕
   

  DCMCFSEG

  中間セグメントまたは最終セグメントを受信する場合に設定します。

  DCMCFBUF1

  バッファ形式1のバッファを使用します。

  DCMCFBUF2

  バッファ形式2のバッファを使用します。

• 　commform
  DCNOFLAGSを設定します。
  
• 　termnam
  入力元の論理端末名称を設定します。論理端末名称は最大8バイトの長さです。論理端末名称の最後にはヌル文字を付けてください。
  
• 　resv01
  ヌル文字を設定します。
  
• 　recvdata
  受信領域を設定します。
  dc_mcf_recvsync関数がリターンすると，受信したメッセージのセグメントが設定されます。
  
• 　inbufleng
  セグメントを受信する領域の長さを設定します。
  
• 　resv02
  DCNOFLAGSを設定します。
  

• 　recvdata
  受信したメッセージのセグメントの内容が返されます。
  
• 　rdataleng
  受信したメッセージのセグメントの長さが返されます。
  
• 　time
  メッセージを受信した時刻が，1970年1月1日0時0分0秒からの通算の秒数で返されます。
  

リターン値	リターン値 （数値）	意味
DCMCFRTN_00000	0	正常に終了しました。
DCMCFRTN_71001	-12001	メッセージの最終セグメントを受信したあとで，その次のセグメントを受信するdc_mcf_recvsync関数を呼び出しています。直前に呼び出したdc_mcf_recvsync関数でメッセージはすべて受信しました。 このリターン値が返されたあとに，再び次のセグメントを受信するdc_mcf_recvsync関数を呼び出した場合は，リターン値DCMCFRTN_72000が返されます。
DCMCFRTN_71002	-12002	MCFが終了処理中のため，受け付けられません。
DCMCFRTN_71108	-12108	メッセージ送受信に必要な管理テーブルが確保できませんでした。
		プロセスのローカルメモリが不足しています。
DCMCFRTN_72000	-13000	＜MHPの実行でリターンした場合＞ 先頭セグメントを受信するdc_mcf_receive関数を呼び出す前に，dc_mcf_recvsync関数を呼び出しました。
		リターン値DCMCFRTN_71001が返されたあとに，再び次のセグメントを受信するdc_mcf_recvsync関数を呼び出しました。
DCMCFRTN_72001	-13001	termnamに設定した論理端末名称が間違っています。
		termnamに設定した論理端末名称は，MCFで定義されていません。
		該当する論理端末では，dc_mcf_recvsync関数を呼び出せません。
DCMCFRTN_72013	-13013	inbuflengの指定値を超えるセグメントを受信しました。inbuflengの指定値を超えた部分は切り捨てました。
DCMCFRTN_72016	-13016	actionに設定した値が間違っています。
		resv01またはresv02に設定した値が間違っています。
		引数に設定した値に間違いがあります。
DCMCFRTN_72024	-13024	commformに設定した値が間違っています。
DCMCFRTN_72025	-13025	actionに設定したセグメント種別（DCMCFFRSTまたはDCMCFSEG）の値が間違っています。
DCMCFRTN_72036	-13036	inbuflengの指定値が不足しています。バッファ形式1の場合は9バイト以上，バッファ形式2の場合は5バイト以上の領域を確保してください。
DCMCFRTN_73018	-14018	resv02に設定した値が間違っています。
上記以外	−	プログラムの破壊などによる，予期しないエラーが発生しました。

（凡例）

−：該当しません。