Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス COBOL言語編


CBLDCRPC('GETCLADR')

〈このページの構成〉

名称

クライアントUAPのノードアドレスの取得

形式

PROCEDURE DIVISIONの指定

CALL  'CBLDCRPC' USING 一意名1

DATA DIVISIONの指定

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

機能

クライアントUAPのプロセスが稼働するノードアドレスを,サーバUAPで取得します。リターンしたアドレス値で,クライアントUAPのセキュリティチェックができます。

返されたアドレスを使って,サービスの応答やエラーの応答などは送信できません。

CBLDCRPC('GETCLADR')は,サービスプログラムから呼び出してください。サービスプログラム以外から呼び出した場合の処理は保証しません。

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

●データ名A

クライアントUAPのノードアドレスの取得を示す要求コードを「VALUE 'GETCLADR'」と設定します。

●データ名C

0を設定します。

OpenTP1から値が返されるデータ領域

●データ名B

ステータスコードが,5けたの数字で返されます。

●データ名D

クライアントUAPのノードアドレスが返されます。

ステータスコード

ステータスコード

意味

00000

正常に終了しました。

00301

データ名に設定した値が間違っています。

要求コード(データ名A)が間違っている場合も含みます。

上記以外

プログラムの破壊などによる,予期しないエラーが起こりました。

注意事項

次の条件が重なった場合,CBLDCRPC('GETCLADR')が返すクライアントUAPのノードアドレスは,実際にクライアントUAPが通信で使用したノードアドレスと異なる場合があります。