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

ANSI C，C++の形式

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

K&R版Cの形式

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

●action

受信する論理メッセージのセグメントと，使用するバッファ形式を次の形式で指定します。

{DCMCFFRST|DCMCFSEG}|DCMCFBUF2

DCMCFFRST

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

DCMCFSEG

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

DCMCFBUF2

バッファ形式2のバッファを示すDCMCFBUF2を設定します。

●commform

DCNOFLAGSを設定します。

●termnam

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

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

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

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

●recvdata

セグメントを受信する領域を設定します。最大セグメントより4バイト大きい領域を確保しておく必要があります。TP1/NET/XMAP3の論理端末画面から入力されたメッセージを受け取る場合は，入力論理マップの先頭アドレスを設定します。

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

●inbufleng

セグメントを受信する領域の長さを設定します。TP1/NET/XMAP3の論理端末画面から入力されたメッセージを受け取る場合は，入力論理マップの長さを設定します。

●termnam

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

●mapname

XMAP3のドローで指定した次画面名（マップ名）が返されます。次画面名は最大6バイトの長さです。最後にはヌル文字が付けられます。ただし，次の場合は，ヌル文字列が返されます。

• 次画面名を指定していない場合

• アプリケーション起動機能（dc_mcf_execap関数）で起動されたMHPから，dc_mcf_receive関数を発行する場合

●recvdata

受信したセグメントの内容が返されます。TP1/NET/XMAP3の論理端末画面から入力されたメッセージを受信した場合，論理マップ可変部・定数部に設定されるデータが返されます。

●rdataleng

受信したセグメントの長さが返されます。TP1/NET/XMAP3の論理端末画面から入力されたメッセージを受信した場合，論理マップ可変部・定数部の長さが返されます。

●time

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