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メソッドと異なります。