dc_mcf_reply − 応答メッセージの送信（C言語）

〈このページの構成〉

形式
機能
UAPで値を設定する引数
リターン値

形式

ANSI C，C++の形式

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

K&R版Cの形式

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

ページの先頭へ

機能

問い合わせをしたシステムへ送る応答メッセージのうち，一つのセグメントを送信します。セグメントの数だけdc_mcf_reply関数を呼び出すと，一つの論理メッセージを送信できます。

送信できるメッセージの一つのセグメントの最大長は，32000バイトです。

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

[図データ]

ページの先頭へ

UAPで値を設定する引数

●action

送信するセグメント，出力通番を付けるかどうか，および使用するバッファ形式を，次の形式で設定します。

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

DCMCFESI

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

DCMCFEMI

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

メッセージの送信の終了を連絡するために，最後は必ずこの値を設定してください。

DCMCFSEQ

出力通番を付ける場合に設定します。

ただし，非応答型のアプリケーションの場合は，DCMCFSEQを指定しても，MCFは応答メッセージに出力通番を付けません。

DCMCFNSEQ

出力通番を付けない場合に設定します。

DCMCFBUF1

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

DCMCFBUF2

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

●commform

DCNOFLAGSを設定します。

●resv01

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

●resv02

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

●senddata

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

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

●sdataleng

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

●resv03

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

●opcd

DCNOFLAGSを設定します。

ページの先頭へ

リターン値

リターン値	リターン値（数値）	意味
DCMCFRTN_00000	0	正常に終了しました。
DCMCFRTN_71002	-12002	メッセージキューへの出力処理中に障害が発生しました。
		メッセージキューが閉塞されています。
		メッセージキューが割り当てられていません。
		sdatalengに32000バイトを超える値を設定しています。
		MCFが終了処理中のため，メッセージの送信を受け付けられません。
DCMCFRTN_71003	-12003	メッセージキューが満杯です。
DCMCFRTN_71004	-12004	メッセージを格納するバッファをメモリ上に確保できませんでした。
DCMCFRTN_71108	-12108	メッセージを送信しようとしましたが，送信先の管理テーブルが確保できませんでした。
DCMCFRTN_71108	-12108	プロセスのローカルメモリが不足しています。
DCMCFRTN_72000	-13000	＜MHPの実行でリターンした場合＞先頭セグメントを受信するdc_mcf_receive関数を呼び出す前に，dc_mcf_reply関数を呼び出しています。非応答型のアプリケーションからdc_mcf_reply関数を呼び出しています。
DCMCFRTN_72000	-13000	＜SPPの実行でリターンした場合＞ SPPではdc_mcf_reply関数を呼び出せません。
DCMCFRTN_72001	-13001	入力元論理端末は，応答メッセージの送信をサポートしていません。
DCMCFRTN_72005	-13005	＜actionでDCMCFESIを設定した場合＞ sdatalengに0バイト，またはマイナス値を設定しています。
DCMCFRTN_72008	-13008	最終セグメントを送信するdc_mcf_reply関数を呼び出したあとで，再びdc_mcf_reply関数を呼び出しています。
DCMCFRTN_72008	-13008	応答型のアプリケーションからdc_mcf_execap関数を呼び出して応答型のアプリケーションを起動したあとで，dc_mcf_reply関数を呼び出しています。
DCMCFRTN_72016	-13016	opcdに設定した値が間違っています。
		resv01，resv02，またはresv03に設定した値が間違っています。
		引数に設定した値に間違いがあります。
DCMCFRTN_72026	-13026	actionに設定したセグメント種別（DCMCFESIまたはDCMCFEMI）の値が間違っています。
DCMCFRTN_72041	-13041	＜actionでDCMCFEMIを設定した場合＞ sdatalengに0バイト，またはマイナス値を設定しています。 actionにDCMCFESIを設定したdc_mcf_reply関数を呼び出さないで，メッセージの送信の終了を連絡しています。
DCMCFRTN_72045	-13045	継続問い合わせ応答型のアプリケーションはサポートしていません。
DCMCFRTN_72047	-13047	継続問い合わせ応答型のアプリケーションはサポートしていません。
上記以外	−	プログラムの破壊などによる，予期しないエラーが発生しました。

（凡例）: −：該当しません。

ページの先頭へ