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;
 

相手システムへ送る一方送信メッセージのうち，一つのセグメントを送信します。セグメントの数だけdc_mcf_send関数を呼び出すと，一つの論理メッセージを送信できます。先頭セグメントを送信する場合は，セグメント内に通信回線の情報を付加します。

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

先頭セグメントの送信時

セレクションENQ文字列

通信管理に指示するセレクション文字列情報（SA1，SA2，UA，ENQの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

送信するメッセージのセグメントの長さを設定します。先頭セグメントの場合は1010バイト以下，第2セグメント以降では446バイト以下の値を設定してください。

メッセージの送信の終了を連絡する場合で，セグメントの内容がない場合は，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に設定した値が間違っています。
		opcdに設定した値が間違っています。
		resv01またはresv02に設定した値が間違っています。
		引数に設定した値に間違いがあります。
DCMCFRTN_72017	-13017	actionに設定した出力通番の要否（DCMCFSEQまたはDCMCFNSEQ）の値が間違っています。
DCMCFRTN_72024	-13024	commformに設定した値が間違っています。
DCMCFRTN_72026	-13026	actionに設定したセグメント種別（DCMCFESIまたはDCMCFEMI）の値が間違っています。
DCMCFRTN_72041	-13041	単一セグメントの送信時に，sdatalengに0またはマイナス値を設定しています。
上記以外	−	プログラムの破壊などによる，予期しないエラーが発生しました。

（凡例）

−：該当しません。