分散トランザクション処理機能 OpenTP1 プロトコル TP1/NET/TCP/IP編

[目次][用語][索引][前へ][次へ]

dc_mcf_tdctle論理端末の閉塞(C言語)

形式

 ANSI C,C++の形式

 
 #include <dcmcf.h>
 int dc_mcf_tdctle (DCLONG action, dcmcf_tdctleopt *leopt,
                     char *proinf, DCLONG *resv02,
                     char *resv03, char *resv04)
 

 K&R版Cの形式

 
 #include <dcmcf.h>
 int dc_mcf_tdctle (action, leopt, proinf, resv02, resv03, resv04)
 DCLONG             action;
 dcmcf_tdctleopt    *leopt;
 char               *proinf;
 DCLONG             *resv02;
 char               *resv03;
 char               *resv04;
 

機能

論理端末を閉塞します。

なお,dc_mcf_tdctle関数の正常終了は,論理端末の閉塞要求をTP1/NET/TCP/IPが正常に受け付けたことを意味します。このため,論理端末の閉塞が正常に完了したことを示すものではありません。

dc_mcf_tdctle関数の呼び出し後に論理端末に関する何らかの処理をする場合は,dc_mcf_tlsle関数を用いて論理端末の状態を確認してください。

UAPで値を設定する引数

●action

閉塞する論理端末の指定方法を次の形式で設定します。

 
DCMCFLE
 
DCMCFLE
閉塞する論理端末を論理端末名称で指定するときに設定します。

●leopt

この関数の対象となったコネクションの情報を,構造体dcmcf_tdctleoptに設定します。

構造体の形式を次に示します。

 
typedef struct {
                DCLONG    mcfid;         …MCF通信プロセス識別子
                char      resv01[4];     …予備領域
                char      idnam[9];      …論理端末名称
                char      resv02[7];     …予備領域
                char      resv03[112];   …予備領域
                char      resv04[376];   …予備領域
                } dcmcf_tdctleopt;
 

●proinf,resv02,resv03,resv04

NULLを設定します。

リターン値

リターン値 リターン値
(数値)
意味
DCMCFRTN_00000 0 正常に終了しました。
DCMCFRTN_71001 -12001 MCFが開始処理中のため,dc_mcf_tdctle関数が受け付けられません。
DCMCFRTN_71002 -12002 MCFが終了処理中のため,dc_mcf_tdctle関数が受け付けられません。
DCMCFRTN_71004 -12004 dc_mcf_tdctle関数の処理中にメモリ不足が発生しました。
DCMCFRTN_71005 -12005 通信障害が発生しました。原因については,メッセージログファイルを参照してください。
DCMCFRTN_71006 -12006 内部障害が発生しました。原因については,メッセージログファイルを参照してください。
DCMCFRTN_71008 -12008 指定された論理端末名称は登録されていません。
DCMCFRTN_71009 -12009 dc_mcf_tdctle関数が,該当するMCF通信プロセスではサポートされていません。または,サポートしていないDCMCFPROを指定しています。
DCMCFRTN_71010 -12010 MCF通信プロセスに論理端末の閉塞を要求しましたが,受け付けられませんでした。原因については,メッセージログファイルを参照してください。
DCMCFRTN_71011 -12011 論理端末が削除されているため,dc_mcf_tdctle関数が受け付けられません。
DCMCFRTN_72050 -13050 actionに未サポートのフラグを設定しています。
actionにDCMCFLEが指定されていません。
DCMCFRTN_72051 -13051 leoptにNULLが設定されています。
DCMCFRTN_72052 -13052 proinfにNULLが設定されていません。
DCMCFRTN_72053 -13053 resv02にNULLが設定されていません。
DCMCFRTN_72054 -13054 resv03にNULLが設定されていません。
DCMCFRTN_72055 -13055 resv04にNULLが設定されていません。
DCMCFRTN_72061 -13061 dcmcf_tdctleoptのmcfidに0未満または240以上の値が設定されています。
DCMCFRTN_72062 -13062 dcmcf_tdctleoptのresv01がヌル文字で埋められていません。
DCMCFRTN_72063 -13063 dcmcf_tdctleoptのidnamの先頭がヌル文字です。
DCMCFRTN_72064 -13064 dcmcf_tdctleoptのresv02がヌル文字で埋められていません。
DCMCFRTN_72065 -13065 dcmcf_tdctleoptのresv03がヌル文字で埋められていません。
DCMCFRTN_72067 -13067 dcmcf_tdctleoptのresv04がヌル文字で埋められていません。
DCMCFRTN_72073 -13073 dcmcf_tdctleoptのidnamに設定された文字数が9以上です。
DCMCFRTN_72074 -13074 dcmcf_tdctleoptのidnamに設定された文字列中に不正な文字があります。