dc_mcf_receive − メッセージの受信（C言語）

ANSI C， C++の形式

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

K＆R版Cの形式

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

●action

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

{DCMCFFRST｜DCMCFSEG}〔｜{DCMDFBUF1｜DCMDFBUF2}〕

DCMCFFRST

先頭セグメントを受信する場合や，論理メッセージが単一セグメントの場合に設定します。

DCMCFSEG

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

DCMDFBUF1

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

DCMDFBUF2

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

●commform

DCNOFLAGSを設定します。

●termnam

先頭セグメントまたは単一セグメントを受信する場合は，メッセージ入力元の論理端末名称を受け取る領域を設定します。

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

中間セグメントまたは最終セグメントを受信する場合は，先頭セグメントの受信時に返されたメッセージ入力元の論理端末名称を設定します。論理端末名称は最大8バイトの長さです。論理端末名称の最後にはヌル文字を付けてください。

中間セグメントまたは最終セグメントを受信した場合，値は返されません。

●resv01

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

●recvdata

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

dc_mcf_receive関数が終了すると，メッセージのセグメントの一つが返されます。

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

●inbufleng

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

●termnam

先頭セグメントまたは単一セグメントを受信する場合，入力元の論理端末名称が返されます。論理端末名称は最大8バイトの長さです。論理端末名称の最後にはヌル文字が付けられます。

中間セグメントまたは最終セグメントを受信する場合は，ここで返された論理端末名称を，termnamに設定してください。

●recvdata

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

●rdataleng

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

●time

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