6.4.1 CBLDCCLS('CONNECT ')常設コネクションの確立

<この項の構成>
(1) 形式
(2) 機能
(3) UAPで値を設定するデータ領域
(4) 値が返されるデータ領域
(5) ステータスコード
(6) 注意事項

(1) 形式

(a) マルチスレッド環境の場合
●PROCEDURE DIVISIONの指定

CALL  'CBLDCCLS'  USING  一意名1

●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 9(9)  COMP.

(b) シングルスレッド環境の場合
●PROCEDURE DIVISIONの指定

CALL  'CBLDCCLT'  USING  一意名1

●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.

(2) 機能

CUP実行プロセス,rapサーバ,またはDCCM3の論理端末との間に常設コネクションを確立します。

常設コネクションを確立するCUP実行プロセスが起動されているOpenTP1ノードは,CBLDCCLS('CLTIN ')のデータ名Dに指定したOpenTP1ノード,クライアント環境定義DCCLTRAPHOSTまたはDCHOSTに指定したOpenTP1ノードです。

DCCM3の論理端末との間に常設コネクションを確立する場合,クライアント環境定義にDCCLTDCCMHOSTおよびDCCLTDCCMPORTを定義し,CBLDCCLS('CONNECT ')のデータ名Cに32を指定します。

また,リモートAPI機能を使用する場合,DCCM3の論理端末との間に常設コネクションを確立するには,DCCLTRAPHOSTにDCCM3の論理端末のホスト名およびポート番号を指定し,CBLDCCLS('CONNECT ')のデータ名Cに0を指定します。

(3) UAPで値を設定するデータ領域

(4) 値が返されるデータ領域

(5) ステータスコード

ステータスコード意味
00000正常終了しました。または,すでに常設コネクションが確立されています。
02501データ名に指定した値が間違っています。要求コード(データ名A)が間違っている場合も含みます。
02502次のどれかの要因が考えられます。
  • トランザクション内で発行されています
  • CBLDCRPS('OPEN ')が発行されていません。
  • OpenTP1に対する確立要求が発行されましたが,すでにDCCM3との常設コネクションが確立されています。
  • DCCM3に対する確立要求が発行されましたが,すでにOpenTP1との常設コネクションが確立されています。
02504必要なバッファが確保できませんでした。
02506通信障害が発生しました。
02507常設コネクション確立時に時間切れ(タイムアウト)が発生しました。
02515次のどれかの要因が考えられます。
  • OpenTP1サーバ,またはDCCM3論理端末が起動されていません。
  • クライアント拡張サービスが起動されていません。システムサービス構成定義clt_confの指定が正しいか見直してください。
  • CUP実行プロセスが起動されていません。クライアントサービス定義clt_cup_confの指定が正しいか見直してください。
02518システムエラーが発生しました。
02539DCCM3の論理端末に対する確立要求が発行されましたが,ホスト名が不正です。
02544データ名Dに指定したクライアントIDはCBLDCCLS('CLTIN '),またはCBLDCCLS('EXCLTIN ')で受け取ったクライアントIDと異なっています。
02547指定したポート番号は使用されています。または,OSが自動的に割り当てるポート番号が不足しています。

(6) 注意事項