dc_mcf_reply応答メッセージの送信(C言語)

形式

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関数を呼び出すと,一つの論理メッセージを送信できます。

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

[図データ]

UAPで値を設定する引数

●action

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

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

DCMCFESI
先頭セグメントまたは中間セグメントを送信する場合に設定します。
DCMCFEMI
最終セグメントを送信する場合に設定します。
メッセージが単一セグメントの場合も,DCMCFEMIを設定します。
メッセージの送信の終了を連絡するために,最後は必ずこの値を設定してください。
DCMCFBUF1
バッファ形式1を使用する場合に設定します。
DCMCFBUF2
バッファ形式2を使用する場合に設定します。

●commform

DCNOFLAGSを設定します。

●resv01,resv02

ヌル文字を設定します。

●senddata

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

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

●sdataleng

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

●resv03

ヌル文字を設定します。

●opcd

DCNOFLAGSを設定します。

リターン値

リターン値意味
DCMCFRTN_00000正常に終了しました。
DCMCFRTN_71002メッセージキューへの出力処理中に障害が発生しました。
メッセージキューが閉塞されています。
メッセージキューが割り当てられていません。
sdatalengに32000バイトを超える値を設定しています。
MCFが終了処理中のため,メッセージの送信を受け付けられません。
DCMCFRTN_71003メッセージキューが満杯です。
DCMCFRTN_71004メッセージを格納するバッファをメモリ上に確保できませんでした。
DCMCFRTN_71108メッセージを送信しようとしましたが,送信先の管理テーブルが確保できませんでした。
プロセスのローカルメモリが不足しています。
DCMCFRTN_72000<MHPの実行でリターンした場合>
  • 先頭セグメントを受信するdc_mcf_receive関数を呼び出す前に,dc_mcf_reply関数を呼び出しています。
  • 非応答型のアプリケーションからdc_mcf_reply関数を呼び出しています。
<SPPの実行でリターンした場合>
SPPではdc_mcf_reply関数を呼び出せません。
DCMCFRTN_72001dc_mcf_reply関数を呼び出せない論理端末を設定しています。
DCMCFRTN_72005先頭セグメントまたは中間セグメントを送信するdc_mcf_reply関数で,長さが0バイトのセグメントを送信しています。
DCMCFRTN_72008最終セグメントを送信するdc_mcf_reply関数を呼び出したあとに,再びdc_mcf_reply関数を呼び出しています。
dc_mcf_execap関数を呼び出して応答型のアプリケーションを起動させたあとに,dc_mcf_reply関数を呼び出しています。
DCMCFRTN_72016opcdに設定した値が間違っています。
resv01,resv02,またはresv03に設定した値が間違っています。
引数に設定した値に間違いがあります。
DCMCFRTN_72026actionに設定したセグメント種別(DCMCFESIまたはDCMCFEMI)の値が間違っています。
DCMCFRTN_72041単一セグメント送信時,sdatalengに0以下の値を設定しています。
上記以外プログラムの破壊などによる,予期しないエラーが発生しました。