Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス C言語編


dc_mcf_tdlqle

〈このページの構成〉

名称

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

形式

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)を通知します。

UAPで値を設定する引数

●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通信プロセス識別子の指定をお勧めします。

    注※

    MCF環境定義(mcftenv -s)で指定するMCF通信プロセス識別子は16進数とみなしてください。

    例えば,MCF通信プロセス識別子が10の場合,16を設定してください。

  • 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に設定された文字列中に不正な文字があります。