6.4.3 CBLDCCLS('STRAPHST')常設コネクション確立要求先の指定

<この項の構成>
(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 'STRAPHST'.
     02  データ名B   PIC X(5).
     02  FILLER      PIC X(3).
     02  データ名C   PIC S9(9) COMP VALUE ZERO.
     02  データ名D   PIC 9(9) COMP.
     02  データ名E   PIC X(n).

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

CALL 'CBLDCCLT' USING 一意名1

●DATA DIVISIONの指定

01一意名1.
     02  データ名A   PIC X(8) VALUE 'STRAPHST'.
     02  データ名B   PIC X(5).
     02  FILLER      PIC X(3).
     02  データ名C   PIC S9(9) COMP VALUE ZERO.
     02  FILLER      PIC 9(9) COMP.
     02  データ名E   PIC X(n).

(2) 機能

常設コネクション確立要求先のホスト名およびポート番号を指定します。この関数を使用した場合,クライアント環境定義DCCLTRAPHOSTに定義したホスト名およびポート番号は無視され,以降のCBLDCCLS('CONNECT ')では,この関数で指定したホスト名およびポート番号が使用されます。

常設コネクション確立要求先のホスト名およびポート番号をこの関数の実行前に戻すときは,CBLDCCLS('GTRAPHST')で返された元の値を,この関数で再設定してください。

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

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

(5) ステータスコード

ステータスコード意味
00000正常終了しました。
02501引数に指定した値が間違っています。要求コード(データ名A)が間違っている場合も含みます。
02502次のどれかの要因が考えられます。
  • トランザクション内で発行されています。
  • 常設コネクション確立中です。
  • CBLDCRPS('OPEN ')が発行されていません。
02504必要なバッファが確保できませんでした。
02544データ名Dに指定したクライアントIDはCBLDCCLS('CLTIN '),またはCBLDCCLS('EXCLTIN ')で受け取ったクライアントIDと異なっています。

(6) 注意事項