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後処理トランザクションで通知されます。