分散トランザクション処理機能 OpenTP1 クライアント使用の手引 TP1/Client/W,TP1/Client/P編

[目次][索引][前へ][次へ]

6.3.1 CBLDCRPS('OPEN ')UAPの開始

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

(1) 形式

(a) マルチスレッド環境の場合
●PROCEDURE DIVISIONの指定
 
CALL 'CBLDCRPS' USING 一意名1 一意名2 一意名3
 
●DATA DIVISIONの指定
 
01 一意名1.
   02 データ名A  PIC X(8)  VALUE 'OPEN    '.
   02 データ名B  PIC X(5).
   02 FILLER    PIC X(3).
   02 データ名C  PIC S9(9) COMP VALUE ZERO.
   02 データ名D  PIC 9(9)  COMP.
 
01 一意名2.
   02 FILLER    PIC X(1).
 
01 一意名3.
   02 FILLER    PIC X(1).
 
(b) シングルスレッド環境の場合
●PROCEDURE DIVISIONの指定
 
CALL 'CBLDCRPC' USING 一意名1
 
●DATA DIVISIONの指定
 
01 一意名1.
   02 データ名A  PIC X(8)  VALUE 'OPEN    '.
   02 データ名B  PIC X(5).
   02 FILLER    PIC X(3).
   02 データ名C  PIC S9(9) COMP VALUE ZERO.
 

(2) 機能

OpenTP1のSPPを呼び出すための環境,またはTCP/IP通信機能を使用するための環境を初期化します。

CBLDCRPS('OPEN ')は,RPC,トランザクション制御,トランザクション制御の各種プログラムを発行する前に実行してください。

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

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

(5) ステータスコード

ステータスコード 意味
00000 正常終了しました。
02401 データ名に設定した値が間違っています。要求コード(データ名A)が間違っている場合も含みます。
02402 CBLDCRPS('OPEN ')はすでに実行されています。
02403 次のどれかの要因で,このステータスコードが戻りました。
  • 初期化に失敗しました。
  • ユーザ認証がされていません。
  • クライアント環境定義の指定が誤っています。
02415 設定したサービスが存在するノードのOpenTP1が実行されていません。
02447 指定したポート番号は使用されています。
02544 データ名Dに指定したクライアントIDはCBLDCCLS('CLTIN '),またはCBLDCCLS('EXCLTIN ')で受け取ったクライアントIDと異なっています。

(6) 注意事項

次に示す場合は,CBLDCRPS('CLOSE ')を実行した直後に,再びデータ名Cに8を指定したCBLDCRPS('OPEN ')は実行できません。この場合,15秒から20秒後にCBLDCRPS('OPEN ')を実行してください。