CBLDCRAP('CONNECT ')
- 〈このページの構成〉
形式
PROCEDURE DIVISIONの指定
CALL 'CBLDCRAP' USING 一意名1 一意名2
DATA DIVISIONの指定
01 一意名1. 02 データ名A PIC X(8) VALUE 'CONNECT '. 02 データ名B PIC X(5). 02 FILLER PIC X(3). 02 データ名C PIC S9(9) COMP VALUE ZERO. 02 データ名D PIC S9(9) COMP. 01 一意名2. 02 データ名E PIC X(64). 02 データ名F PIC S9(9) COMP.
機能
rapリスナーとrapクライアントとの間にコネクションを確立します。
UAPで値を設定するデータ領域
●データ名A
rapリスナーとのコネクションの確立要求を示す要求コードを「VALUE 'CONNECT△'」と設定します。
●データ名C
0を設定します。
●データ名E
rapリスナーが起動されているOpenTP1ノードのホスト名を設定します。
指定するホスト名は1〜64文字です。65文字以上のホスト名を指定する場合は,CBLDCRAP('CONNECTX')を使用してください。
●データ名F
rapリスナーの使用しているウェルノウンポートのポート番号を設定します。
OpenTP1から値が返されるデータ領域
●データ名B
ステータスコードが,5けたの数字で返されます。
●データ名D
サービスIDを受け取る領域です。
rapリスナーとのコネクションが正常に確立された場合にサービスIDが設定されます。CBLDCRAP('DISCNCT ')でコネクションを解放するときにも同じサービスIDを使用します。
ステータスコード
ステータスコード |
意味 |
---|---|
00000 |
正常終了しました。rapリスナーとのコネクションが確立されました。 |
05501 |
データ領域に設定した値に誤りがあります。または,データ領域が設定されていません。次の値を見直してください。
|
05502 |
プロトコル不正です。要因としては次のことが考えられます。
|
05503 |
メモリ不足が発生しました。 |
05517 |
一つのプロセスからCBLDCRAP('CONNECT ')が呼び出せる上限値を超えました。 |
05505 |
rapリスナーとの通信でネットワーク障害が発生しました。 |
05506 |
rapリスナーとの通信でタイムアウトが発生しました。 |
05507 |
ソケット不足が発生しました。 |
05508 |
ホスト名称が解決できません。 |
05521 |
rapリスナーは停止中です。 |
05522 |
続行できない障害が発生しました。障害の要因として次のことが考えられます。
|
05523 |
システムコールで予期しないエラーが発生しました。 |
05531 |
接続されていないネットワーク上のrapリスナーに対してコネクションを確立しようとしています。 |
05520 |
rapリスナーまたはrapサーバでメモリ不足が発生しました。 |
05532 |
rapリスナーサービス定義のrap_watch_timeオペランドに指定したメッセージ送受信監視時間内にコネクションが確立できませんでした。 |
05533 |
rapリスナーでシステム障害が発生しました。 |
05528 |
rapリスナーは開始処理中,または停止処理中です。 |
05529 |
すでにrapリスナーとコネクションは確立しています。 |
05534 |
rapリスナーの管理するrapクライアントのコネクション要求受付可能最大数を超えました。 |
注意事項
「05529」以外のステータスコードで,CBLDCRAP('CONNECT ')がエラーリターンした場合,rapリスナーとのコネクションは確立されていません。
UAPトレースに取得されるエラー要因コードは次のとおりです。
0:エラーなし。
1:一意名1が設定されていません。
2:要求コード(データ名A)が間違っています。
3:一意名2が設定されていません。
6:ユーザサービス定義のrpc_rap_auto_connectオペランドの指定値がYの場合に,CBLDCRAP('CONNECT')が呼び出されました。または,ユーザサービスネットワーク定義が定義されていません。
7:コネクション確立後に発行したCBLDCRPC('CALL ')がエラーとなった場合は,CBLDCRAP('DISCNCT ')でコネクションを解放したあと,再度CBLDCRAP('CONNECT ')でコネクションを確立させてください。