dc_mcf_recvsync − 同期型メッセージの受信（C言語）

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  watchtime)

K&R版 Cの形式

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

●action

受信するセグメント，および使用するバッファ形式を次の形式で指定します。

DCMCFFRST〔|｛DCMCFBUF1|DCMCFBUF2｝〕

DCMCFFRST

単一セグメントを示すDCMCFFRSTを設定します。

DCMCFBUF1

バッファ形式1を使用する場合に設定します。

DCMCFBUF2

バッファ形式2を使用する場合に設定します。

●commform

DCNOFLAGSを設定します。

●termnam

入力元の論理端末名称を設定します。論理端末名称は最大8バイトの長さです。論理端末名称の最後にはヌル文字を付けてください。

●resv01

NULLまたはヌル文字列を設定します。

●recvdata

セグメントを受信する領域を設定します。

dc_mcf_recvsync関数がリターンすると，受信したセグメントが設定されます。

処理終了後，recvdataにはOpenTP1から値が返ります。

●inbufleng

セグメントを受信する領域の長さを設定します。

●watchtime

dc_mcf_recvsync関数を呼び出してから終了するまでの監視時間を設定します。0を設定した場合，MCFマネジャ定義のUAP共通定義で指定した同期型受信監視時間（mcfmuap -t recvtim）が設定されます。

負の値を設定した場合は，時間を監視しません。

注意事項

監視時間の精度は秒単位です。また，タイマ定義（mcfttim -t）のbtimオペランドで指定する時間の間隔でタイムアウトが発生したかどうかを監視しています。このため，設定した監視時間と実際にタイムアウトを検出する時間には秒単位の誤差が生じます。そのため，タイミングによっては，設定した監視時間よりも短い時間で起動することがあります。監視時間が小さくなるほど，誤差の影響を受けやすくなりますので，監視時間は3（単位：秒）以上の値の設定を推奨します。

●recvdata

受信したセグメントの内容が返されます。

●rdataleng

受信したセグメントの長さが返されます。

●time

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