5.4.11 コネクション確立UOCインタフェース
(1) 形式
- ANSI C,C++の形式
#include <eemcp.h> int uoc_func(struct eemcp_uoc_con_n *parm)
(2) 説明
コネクション確立UOCを呼び出すとき,MCPは次に示す所定のパラメタをparmに設定します。
(3) パラメタの内容
(a) eemcp_uoc_con_nの内容
typedef struct eemcp_uoc_con_n { char con_id[9]; … コネクションID char reserve1[7]; … 予備 unsigned char ripaddr[16]; … 自システムのIPアドレス unsigned char oipaddr[16]; … 相手システムのIPアドレス unsigned short rportno; … 自システムのポート番号 unsigned short oportno; … 相手システムのポート番号 EELONG reject_reason; … コネクション確立拒否理由 EELONG rtn_detail; … 詳細リターンコード char reserve2[4]; … 予備 char *usat_adr; … ユーザSATアドレス EEULONG64 usat_large_size; … ユーザSATサイズ(拡張) char reserve3[32]; … 予備 } EEMCPUOCCONN;
(4) MCPが値を設定する項目
(a) eemcp_uoc_con_n
- ●con_id
-
確立要求を受け付けたコネクションIDが設定されます。
- ●ripaddr
-
確立要求を受け付けた自システムのIPアドレスが設定されます。
IPアドレスはripaddrの下位4バイトに次の形式で設定されます。
- ●oipaddr
-
確立要求を行った相手システムのIPアドレスが設定されます。
IPアドレスの設定形式はripaddrを参照してください。
- ●rportno
-
確立要求を受け付けた自システムのポート番号が設定されます。
ポート番号はホストバイトオーダー形式の数値で設定されます。
- ●oportno
-
確立要求を行った相手システムのポート番号が設定されます。
ポート番号はホストバイトオーダー形式の数値で設定されます。
- ●usat_adr
-
ユーザSATエリアのアドレスが設定されます。TP1/EEのサービス定義のメモリ関連定義のsystem_user_areaオペランドに0を指定した場合は,値を参照できません。該当領域に排他を掛けています。
- ●usat_large_size
-
ユーザSATエリアのサイズが設定されます(単位:バイト)。
(5) ユーザが値を設定する項目
(a) eemcp_uoc_con_n
- ●reject_reason
-
コネクション確立UOCがEEMCP_UOC_CON_OK_REJECT(コネクション確立拒否)でリターンするときの拒否理由を設定します。値は任意です。この拒否理由はログメッセージ(KFSB81406-I)に出力されます。
- ●rtn_detail
-
コネクション確立UOCがEEMCP_UOC_CON_NG(UOC異常終了)でリターンするときの詳細リターンコードを設定します。この詳細リターンコードはログメッセージ(KFSB51401-E)に出力されます。値は-19999〜-19000の範囲内で設定します。MCPは,値の範囲をチェックしません。
(6) リターン値
コネクション確立UOCは次のコードでリターンしてください。
リターン値 |
意味 |
---|---|
EEMCP_UOC_CON_OK_ACCEPT |
正常リターン(コネクション確立要求を受け入れ) |
EEMCP_UOC_CON_OK_REJECT |
正常リターン(コネクション確立要求拒否) |
EEMCP_UOC_CON_NG |
コネクション確立要求判定エラー |
- ■EEMCP_UOC_CON_OK_REJECTの場合
-
UOCからEEMCP_UOC_CON_OK_REJECTでリターンした場合,MCPはメッセージログを出力し,コネクションの確立を拒否します。
- ■EEMCP_UOC_CON_NGの場合
-
UOCからEEMCP_UOC_CON_NGでリターンした場合,MCPはメッセージログを出力し,コネクションの確立を拒否します。