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