Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 TP1/EE/Message Control Extension 使用の手引


ee_mcp_dctcn - コネクションの解放

〈このページの構成〉

機能

コネクションを解放します。

コネクションの解放後,MCP後処理トランザクションを起動します。

形式

ANSI C,C++の形式
#include <eemcp.h>
int  ee_mcp_dctcn(EEMCPCNINF *info, char form, int flags)

UAPで値を設定する引数

●info

コネクションを解放するコネクションIDを設定したEEMCPCNINF構造体ポインタのアドレスを設定します。

typedef struct ee_mcp_cninf {
        int         con_num;
        char        con_id1[9];
        char        con_id2[9];
        char        con_id3[9];
        char        con_id4[9];
        char        con_id5[9];
        char        con_id6[9];
        char        con_id7[9];
        char        con_id8[9];
}EEMCPCNINF;

con_numにはコネクションを解放するコネクションID数を1〜8の範囲で設定します。

con_id1〜con_id8にはコネクションを解放するコネクションIDを設定します。コネクションIDの長さは最大8バイトです。コネクションIDの後ろはNULL文字を付けてください。

コネクションIDは,*を使って一括指定できます。一括指定は一つだけ指定できます。一括指定する場合は,con_numに1を設定しcon_id1に「*」または「先行文字列*」の形式で設定してください。

「*」の場合はすべてのコネクションを解放します。「先行文字列*」の場合は先行文字列で始まるすべてのコネクションを解放します。

●form

コネクションの解放形態を設定します。この設定値は,eemcpcn定義コマンドの-fオプションのcnreleaseオペランドにrstを指定した場合に有効になります。finを指定した場合は,formの設定値に関係なくFINパケットを送信してコネクションを解放します。

EEMCPFRC

RSTパケットを送信して,コネクションを強制的に解放する場合に設定します。

EEMCPNRM

FINパケットを送信して,コネクションを解放する場合に設定します。

●flags

EENOFLAGSを設定します。

リターン値

リターン値

意味

EE_OK

正常に終了しました。

EECOMER_CNDUOC

UOCから発行しているため,この機能は使用できません。

EECOMER_ENVIRON

TP1/EEの環境下にありません。

EEMCPER_CON_NAME

指定したコネクションIDの中に不正なコネクションIDがあります。

EEMCPER_CONDITION

発行条件が不正です。

EEMCPER_FORM

formに設定した値が間違っています。

EEMCPER_INFO

infoに設定した値が間違っています。

EEMCPER_NUM

con_numに設定した値が間違っています。

EEMCPER_OPTION

flagsに設定した値が間違っています。

EEMCPER_PART

一部のコネクションの解放に失敗しました。

EEMCPER_SYSERR

システムエラーが発生しました。

注意事項

コネクションの解放は非同期で行われます。したがって,この関数でのリターン値がEE_OKであった場合でも,コネクションの解放に失敗している場合があります。コネクションの解放結果はMCP後処理トランザクションで通知されます。