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

K&R版C　の形式

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

同期型でメッセージを送信したあと，同期型でメッセージを受信します。

dc_mcf_sendrecv関数では，相手システムへ送る論理メッセージのうち，一つのセグメントを送信できます。必要なセグメントの数だけdc_mcf_sendrecv関数を発行することによって，一つの論理メッセージを送信できます。メッセージの最終セグメントを送信すると，dc_mcf_sendrecv関数は相手システムからの応答を待ちます。応答が届くと，そのメッセージの先頭セグメントを受信します。

中間セグメントおよび最終セグメントを受信する場合は，dc_mcf_recvsync関数を発行してください。

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

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

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

  DCMCFESI

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

  DCMCFEMI

  最終セグメントを送信する場合，および論理メッセージが単一セグメントの場合に設定します。メッセージの送信の終了を連絡するために，最後は必ずこの値を設定してください。この値を設定してdc_mcf_sendrecv関数を発行すると，応答メッセージを待ちます。

  DCMCFBUF1

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

  DCMCFBUF2

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

• 　commform
  同期型メッセージの送受信を示すDCMCFIOを設定します。
  
• 　termnam
  メッセージを出力して応答を入力する論理端末名称を設定します。論理端末名称は最大8バイトの長さです。論理端末名称の最後にはヌル文字を設定してください。
  
• 　resv01
  ヌル文字を設定します。
  
• 　senddata
  送信する応答メッセージのセグメントの内容を設定します。一つのセグメントで32000バイトまで送信できます。
  メッセージの送信の終了を連絡する場合で，セグメントの内容がないときも，必ず設定してください。
  
• 　sdataleng
  送信する応答メッセージのセグメントの長さを設定します。メッセージの送信の終了を連絡する場合でセグメントの内容がないときは，0を設定してください。
  
• 　recvdata
  受信領域を設定します。
  単一セグメントまたは最終セグメントを送受信するdc_mcf_sendrecv関数がリターンすると，受信したメッセージの先頭セグメントが返されます。
  処理終了後，recvdataにはOpenTP1から値が返ります。
  
• 　inbufleng
  セグメントを受信する領域の長さを設定します。
  
• 　resv02
  DCNOFLAGSを設定します。
  

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

リターン値	リターン値 （数値）	意味
DCMCFRTN_00000	0	正常に終了しました。
DCMCFRTN_71002	-12002	メッセージキューへの入出力処理時に障害が発生しました。
		メッセージキューが閉塞されています。
		メッセージキューが割り当てられていません。
		sdatalengに32000バイトを超える値を設定しています。
		MCFが終了処理中のため，メッセージの送受信を受け付けられません。
DCMCFRTN_71003	-12003	メッセージキューが満杯です。
DCMCFRTN_71004	-12004	メッセージを格納するバッファをメモリ上に確保できませんでした。
DCMCFRTN_71108	-12108	メッセージを送信しようとしましたが，送信先の管理テーブルが確保できませんでした。
		プロセスのローカルメモリが不足しています。
DCMCFRTN_72000	-13000	＜MHPの実行でリターンした場合＞ 先頭セグメントを受信するdc_mcf_receive関数を呼び出す前に，dc_mcf_sendrecv関数を呼び出しています。
DCMCFRTN_72001	-13001	termnamに設定した論理端末名称が間違っています。
		dc_mcf_sendrecv関数を呼び出せない論理端末を設定しています。
DCMCFRTN_72005	-13005	先頭セグメントまたは中間セグメントを送信するdc_mcf_sendrecv関数で，長さが0バイトのセグメントを送信しています。
DCMCFRTN_72013	-13013	inbuflengの指定値を超えるセグメントを受信しました。inbuflengの指定値を超えた部分は切り捨てられました。
DCMCFRTN_72016	-13016	actionに設定した値が間違っています。
		resv01に設定した値が間違っています。
		引数に設定した値に間違いがあります。
DCMCFRTN_72024	-13024	commformに設定した値が間違っています。
DCMCFRTN_72026	-13026	actionに設定したセグメント種別（DCMCFESIまたはDCMCFEMI）の値が間違っています。
DCMCFRTN_72036	-13036	inbuflengの指定値が不足しています。バッファ形式1の場合は9バイト以上，バッファ形式2の場合は5バイト以上の領域を確保してください。
DCMCFRTN_72041	-13041	単一セグメントを送信するdc_mcf_sendrecv関数で，長さが0バイトのセグメントを送信しています。
DCMCFRTN_73001	-14001	メッセージの送受信処理中に障害が発生しました。
DCMCFRTN_73002	-14002	論理端末が閉塞しています。
DCMCFRTN_73004	-14004	メッセージの送信処理中にタイムアウトが発生しました。
DCMCFRTN_73005	-14005	メッセージの受信処理中にタイムアウトが発生しました。
DCMCFRTN_73008	-14008	運用コマンドまたは障害による論理端末閉塞処理中に，dc_mcf_sendrecv関数を呼び出しました。
DCMCFRTN_73009	-14009	論理端末の閉塞解除の処理中に，dc_mcf_sendrecv関数を呼び出しました。
DCMCFRTN_73010	-14010	入力メッセージ編集UOCまたは出力メッセージ編集UOCで障害が発生しました。
DCMCFRTN_73015	-14015	出力先の論理端末は，ほかのUAPで仕掛り中です。
DCMCFRTN_73018	-14018	resv02に設定した値が間違っています。
上記以外	−	プログラムの破壊などによる，予期しないエラーが発生しました。

（凡例）

−：該当しません。