dc_mcf_sendrecv − 同期型の問い合わせメッセージの送受信（C言語）

ANSI C，C++の形式

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

K&R版Cの形式

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

●action

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

{DCMCFESI｜DCMCFEMI}〔｜{DCMCFBUF1｜DCMCFBUF2}〕

DCMCFESI

先頭セグメントまたは中間セグメントを送信する場合に設定します。

DCMCFEMI

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

メッセージの送信の終了を連絡するために，最後は必ずこの値を設定してください。この値を設定してdc_mcf_sendrecv関数を呼び出すと，相手システムからの応答を待ちます。

DCMCFBUF1

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

DCMCFBUF2

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

●commform

同期型メッセージの送受信を示す，DCMCFIOを設定します。

●termnam

メッセージを出力して応答を入力する論理端末名称を設定します。論理端末名称は最大8バイトの長さです。論理端末名称の最後にはヌル文字を付けてください。

●resv01

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

●senddata

送信するセグメントの内容を設定した領域を設定します。一つのセグメントで32000バイトまで送信できます。

先頭セグメントの送信後，メッセージの送信の終了を連絡する場合で，セグメントの内容がないときも，必ず設定してください。

●sdataleng

送信するセグメントの長さを設定します。先頭セグメントの送信後，メッセージの送信の終了を連絡する場合で，セグメントの内容がないときは，0を設定してください。

●recvdata

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

単一セグメントまたは最終セグメントを送信するdc_mcf_sendrecv関数が終了すると，受信したメッセージの先頭セグメントが返されます。

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

●inbufleng

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

●watchtime

dc_mcf_sendrecv関数を呼び出してから終了するまでの最大時間を設定します。

0を設定した場合，MCFマネジャ定義のUAP共通定義で指定した同期型送受信監視時間（mcfmuap -t sndrcvtim）が設定されます。負の値を設定した場合は，時間を監視しません。

注意事項

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

●recvdata

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

●rdataleng

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

●time

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