Hitachi

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


ee_mcp_cninfo - コネクション情報の取得

〈このページの構成〉

機能

コネクション情報を取得します。

形式

ANSI C,C++の形式
#include <eemcp.h>
int ee_mcp_cninfo(EELONG action, char *idname,
                  EEMCPCONIDINF *info, int flags)

UAPで値を設定する引数

●action

情報を取得するコネクションの指定方法を次の形式で設定します。

{EEMCPLE|EEMCPCN}
EEMCPLE

情報を取得するコネクションを論理端末名称で指定するときに設定します。

EEMCPCN

情報を取得するコネクションをコネクションIDで指定するときに設定します。

●idname

情報を取得するコネクションの論理端末名称,またはコネクションIDを設定します。論理端末名称,またはコネクションIDは8バイト以内で設定し,文字列の最後にNULL文字を付けます。

●info

コネクション状態を格納する領域ee_mcp_conid_infを設定します。

●flags

EENOFLAGSを設定します。

MCPから値が返される引数

●info

この関数の対象となったコネクションの情報が,構造体ee_mcp_conid_infで返されます。ただし,コネクション情報が設定されるのはリターン値がEE_OKの場合だけです。

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

typedef struct ee_mcp_conid_inf {
        char           con_id[9];
        char           resv01[1];
        unsigned short id_len;
        char           pname[4];
        unsigned char  r_ipaddr[16];
        unsigned char  o_ipaddr[16];
        unsigned short r_port;
        unsigned short o_port;
        char resv02[4];
}EEMCPCONIDINF;

●con_id

要求したコネクションのコネクションIDが設定されます。

●resv01

領域をNULL文字で埋めます。

●id_len

要求したコネクションのコネクションIDの文字列長が設定されます。

●pname

要求したコネクションのプロトコル種別が文字列で設定されます。

''TCP''

TCP/IPプロトコル

●r_ipaddr

相手システムのIPアドレスを設定します。

o_hostを設定した場合はo_ipaddrの設定は不要です。o_host,o_ipaddr共に設定した場合はo_ipaddr設定値が有効になります。

IPアドレスを設定する場合は,xxx.xxx.xxx.xxxの形式で設定します。xxxは,0〜255(10進数)で設定してください。ただし,0.0.0.0,255.255.255.255の設定は不可とします。

IPアドレスはo_ipaddrの下位4バイトに次の形式で設定します。

[図データ]

●o_ipaddr

相手システムのIPアドレスを設定します。

IPアドレスの設定形式に関してはr_ipaddrを参照してください。

●r_port

相手システムのポート番号を設定します。

ポート番号はホストバイトオーダー形式の数値で設定してください。数値は,1〜65535の符号なし整数で設定してください。

●o_port

相手システムのポート番号を設定します。

ポート番号の設定形式に関してはr_portを参照してください。

●resv02

領域をNULL文字で埋めます。

リターン値

リターン値

意味

EE_OK

正常に受け付けました。

EECOMER_ENVIRON

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

EECOMER_CNDUOC

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

EEMCPER_ACTION

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

EEMCPER_IDNAME

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

EEMCPER_OPTION

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

EEMCPER_ACT_BEGIN

指定したコネクションが確立処理中状態です。

EEMCPER_DCT

指定したコネクションが未確立状態です。

EEMCPER_DCT_BEGIN

指定したコネクションが解放処理中状態です。

EEMCPER_INFO

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