8.3.5 TCP/IP通信機能
TP1Accessクラスで提供するTCP/IP通信機能メソッドの一覧を以下に記載します。
|
項番 |
メソッド名 |
機能 |
|---|---|---|
|
1 |
receive |
メッセージの受信 |
|
2 |
receive2 |
メッセージの受信（障害時メッセージ受信）（TCP/IP通信機能） |
|
3 |
send |
メッセージの送信 |
(1) メッセージの受信
[ receiveメソッド ] public void receive(int cltid, java.lang.String[] buff, int recvleng, int timeout, int flags) throws J2CBException
- パラメタ：
-
cltid - クライアントID
buff - 受信したメッセージ，要素数1以上のString配列を指定する。配列[0]に値が設定される。
recvleng - 受信するメッセージの長さ
timeout - メッセージ受信時の最大待ち時間（秒）
- flags -メッセージ受信後，コネクションを解放するかどうか
-
-
TP1Const.DCNOFLAGS：メッセージ受信後，コネクションを解放しません。
-
TP1Const.DCCLT_RCV_CLOSE：メッセージ受信後，コネクションを解放します。
-
- 戻り値：
-
なし
- 例外：J2CBException - 例外情報の取得
-
詳細は「8.8 J2CBExceptionユーザインタフェースAPI」をご覧ください。
- 注意事項：
-
出力引数をStringオブジェクトで受け取る点が，「8.2 TP1/COBOLアクセス用BeanユーザインタフェースAPI(TP1/Client/PおよびTP1/Client/W)」で提供されるreceiveメソッドと異なります。
(2) メッセージの受信（障害時メッセージ受信）
[ receive2メソッド ] public void receive2(int cltid, java.lang.String[] buff, int[] recvleng, int timeout, int flags) throws J2CBException
- パラメタ：
-
cltid - クライアントID
- buff - 受信したメッセージ，要素数1以上のString配列を指定する。
-
配列[0]に値が設定される。
recvleng - 受信するメッセージの長さ，要素数1以上のint配列を指定する。
Timeout - メッセージ受信時の最大待ち時間（秒）
- flags - メッセージ受信後，コネクションを解放するかどうか
-
-
TP1Const.DCNOFLAGS：メッセージ受信後，コネクションを解放しません。
-
TP1Const.DCCLT_RCV_CLOSE：メッセージ受信後，コネクションを解放します。
-
- 戻り値：
-
なし。
- 例外：J2CBException - 例外情報の取得
-
詳細は「8.8 J2CBExceptionユーザインタフェースAPI」をご覧ください。
- 注意事項：
-
出力引数をStringオブジェクトで受け取る点が，「8.2 TP1/COBOLアクセス用BeanユーザインタフェースAPI(TP1/Client/PおよびTP1/Client/W)」で提供されるreceive2メソッドと異なります。
(3) メッセージの送信
[ sendメソッド ] public void send(int cltid, java.lang.String buff, int sendleng, java.lang.String hostname, int portnum, int flags) throws J2CBException
- パラメタ：
-
cltid - クライアントID
buff - 送信するメッセージ
sendleng - 送信するメッセージの長さ
hostname - 接続するMHPが存在するノードのホスト名
portnum - MHPのポート番号
- flags - メッセージ送信後，コネクションを解放するかどうか
-
-
TP1Const.DCNOFLAGS：メッセージを送信後，コネクションを解放しません。
-
TP1Const.DCCLT_SND_CLOSE：メッセージを送信後，コネクションを解放します。
-
- 戻り値：
-
なし
- 例外：J2CBException - 例外情報の取得
-
詳細は「8.8 J2CBExceptionユーザインタフェースAPI」をご覧ください。
- 注意事項：
-
入力引数をStringオブジェクトで渡す点が，「8.2 TP1/COBOLアクセス用BeanユーザインタフェースAPI(TP1/Client/PおよびTP1/Client/W)」で提供されるsendメソッドと異なります。