ANSI C，C++　の形式

 
#include<dcmcf.h>
int dc_mcf_send(DCLONG action, DCLONG commform, char *termnam,
                char *resv01, char *senddata, DCLONG sdataleng,
                char *resv02, DCLONG opcd)
 

K&R版C　の形式

 
#include<dcmcf.h>
int dc_mcf_send(action, commform, termnam, resv01, senddata,
                sdataleng, resv02, opcd)
DCLONG    action;
DCLONG    commform;
char      *termnam;
char      *resv01;
char      *senddata;
DCLONG    sdataleng;
char      *resv02;
DCLONG    opcd;
 

MCFで管理する論理端末に送信するメッセージの，一つのセグメントを送信要求します。必要なセグメントの数だけ，dc_mcf_send関数を呼び出すと，一つの論理メッセージを送信できます。

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

• 　action
  送信するセグメントが論理メッセージの最終セグメントかどうか，一般か優先かどうか，出力通番を付けるかどうか，および使用するバッファ形式を，次の形式で設定します。
  

   
  {DCMCFESI|DCMCFEMI}〔|{DCMCFNORM|DCMCFPRIO}〕〔|{DCMCFSEQ|DCMCFNSEQ}〕〔|{DCMCFBUF1|DCMCFBUF2}〕
   

  DCMCFESI

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

  DCMCFEMI

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

  DCMCFNORM

  一般の一方送信メッセージとして送信する場合に設定します。

  DCMCFPRIO

  優先の一方送信メッセージとして送信する場合に設定します。

  DCMCFSEQ

  出力通番が必要な場合に設定します。

  DCMCFNSEQ

  出力通番が必要ない場合に設定します。

  DCMCFBUF1

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

  DCMCFBUF2

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

• 　commform
  一方送信を示す，DCMCFOUTを設定します。
  
• 　termnam
  メッセージの出力先の論理端末名称を設定します。論理端末名称は最大8バイトの長さです。論理端末名称の最後にはヌル文字を付けてください。
  
• 　resv01
  ヌル文字を設定します。
  
• 　senddata
  送信するメッセージのセグメントの内容を設定します。メッセージの送信の終了を連絡する場合でセグメントの内容がないときにも，必ず設定してください。
  
• 　sdataleng
  送信するメッセージのセグメントの長さを設定します。先頭セグメントまたは中間セグメントの送信後，メッセージの送信の終了を連絡する場合には，0を設定してください。
  
• 　resv02
  ヌル文字を設定します。
  
• 　opcd
  DCNOFLAGSを設定します。
  

リターン値	リターン値 （数値）	意味
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_send関数を呼び出しています。
		＜SPPの実行でリターンした場合＞ トランザクションの処理でないSPPで，dc_mcf_send関数を呼び出しています。
DCMCFRTN_72001	-13001	termnamに設定した論理端末名称が間違っています。
		termnamに設定した出力先の論理端末名称は，MCFで定義されていません。
		dc_mcf_send関数を呼び出せない論理端末を設定しています。
DCMCFRTN_72005	-13005	先頭セグメントまたは中間セグメントを送信するdc_mcf_send関数で，長さが0バイトのセグメントを送信しています。
DCMCFRTN_72016	-13016	actionに設定したメッセージ種別（DCMCFNORMまたはDCMCFPRIO）の値が間違っています。
		actionに設定した値が間違っています。
		resv01，resv02に設定した値が間違っています。
		opcdに設定した値が間違っています。
		引数に設定した値に間違いがあります。
DCMCFRTN_72017	-13017	actionに設定した出力通番の要否（DCMCFSEQまたはDCMCFNSEQ）の値が間違っています。
DCMCFRTN_72024	-13024	commformに設定した値が間違っています。
DCMCFRTN_72026	-13026	actionに設定したセグメント種別（DCMCFESIまたはDCMCFEMI）の値が間違っています。
DCMCFRTN_72041	-13041	単一セグメントを送信するdc_mcf_send関数で，長さが0バイトのセグメントを送信しています。
上記以外	−	プログラムの破壊などによる，予期しないエラーが発生しました。

（凡例）

−：該当しません。