分散トランザクション処理機能 OpenTP1 プロトコル TP1/NET/User Agent編
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で値を設定する引数
メッセージの最終セグメントを送信するかどうかを,次の形式で設定します。
{DCMCFESI|DCMCFEMI}〔|{DCMCFBUF1|DCMCFBUF2}〕
DCNOFLAGSを設定します。
ヌル文字を設定します。
送信するセグメントの内容を設定した領域を設定します。一つのセグメントで32000バイトまで送信できます。
メッセージの送信の終了を連絡する場合で,セグメントの内容がないときも,必ず設定してください。
送信するセグメントの長さを設定します。メッセージの送信の終了を連絡する場合で,セグメントの内容がないときは,0を設定してください。
ヌル文字を設定します。
DCNOFLAGSを設定します。
リターン値
| リターン値 | 意味 |
|---|---|
| DCMCFRTN_00000 | 正常に終了しました。 |
| DCMCFRTN_71002 | メッセージキューへの出力処理中に障害が発生しました。 |
| メッセージキューが閉塞されています。 | |
| メッセージキューが割り当てられていません。 | |
| sdatalengに32000バイトを超える値を設定しています。 | |
| MCFが終了処理中のため,メッセージの送信を受け付けられません。 | |
| DCMCFRTN_71003 | メッセージキューが満杯です。 |
| DCMCFRTN_71004 | メッセージを格納するバッファをメモリ上に確保できませんでした。 |
| DCMCFRTN_71108 | メッセージを送信しようとしましたが,送信先の管理テーブルが確保できませんでした。 |
| プロセスのローカルメモリが不足しています。 | |
| DCMCFRTN_72000 | <MHPの実行でリターンした場合>
|
| <SPPの実行でリターンした場合> SPPではdc_mcf_reply関数を呼び出せません。 |
|
| DCMCFRTN_72001 | dc_mcf_reply関数を呼び出せない論理端末を設定しています。 |
| DCMCFRTN_72005 | 先頭セグメントまたは中間セグメントを送信するdc_mcf_reply関数で,長さが0バイトのセグメントを送信しています。 |
| DCMCFRTN_72008 | 最終セグメントを送信するdc_mcf_reply関数を呼び出したあとに,再びdc_mcf_reply関数を呼び出しています。 |
| dc_mcf_execap関数を呼び出して応答型のアプリケーションを起動させたあとに,dc_mcf_reply関数を呼び出しています。 | |
| DCMCFRTN_72016 | opcdに設定した値が間違っています。 |
| resv01,resv02,またはresv03に設定した値が間違っています。 | |
| 引数に設定した値に間違いがあります。 | |
| DCMCFRTN_72026 | actionに設定したセグメント種別(DCMCFESIまたはDCMCFEMI)の値が間違っています。 |
| DCMCFRTN_72041 | 単一セグメント送信時,sdatalengに0以下の値を設定しています。 |
| 上記以外 | プログラムの破壊などによる,予期しないエラーが発生しました。 |
All Rights Reserved. Copyright (C) 2006, Hitachi, Ltd.