論理端末の出力キュー削除

ANSI C，C++の形式

 
#include <dcmcf.h>
int dc_mcf_tdlqle (DCLONG action, dcmcf_tdlqleopt *leopt,
                   char *resv01, DCLONG *resv02,
                   char *resv03, char *resv04)
 

K&R版Cの形式

 
#include <dcmcf.h>
int dc_mcf_tdlqle (action, leopt, resv01, resv02, resv03, resv04)
DCLONG             action;
dcmcf_tdlqleopt    *leopt;
char               *resv01;
DCLONG             *resv02;
char               *resv03;
char               *resv04;
 

論理端末の出力キューを削除します。

出力キューを正常に削除すると，未処理送信メッセージ廃棄通知イベント（ERREVTA）を通知します。

●action

論理端末名称で指定することを示す，DCMCFLEを設定します。

●leopt

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

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

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

• mcfid
  処理対象の論理端末を持つMCF通信サービスのMCF通信プロセス識別子を設定します。設定できる範囲は0〜239です。
  0を指定すると，該当する論理端末名称が属するMCF通信サービスを検索します。MCF通信サービスが多い構成やUAPからdc_mcf_tdlqle関数を多数発行する場合は，MCF通信プロセス識別子の指定をお勧めします。
  
• resv01
  領域をヌル文字で埋めます。
  
• idnam
  出力キューを削除する論理端末の論理端末名称を設定します。論理端末名称は8バイト以内で設定し，文字列の最後にヌル文字を付けます。
  
• resv02，resv03，resv04
  領域をヌル文字で埋めます。
  

●resv01，resv02，resv03，resv04

NULLを設定します。

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