Hitachi

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


CBLDCRPC('GETGWADR')

〈このページの構成〉

名称

ゲートウェイのノードアドレスの取得

形式

PROCEDURE DIVISIONの指定

CALL 'CBLDCRPC' USING 一意名1

DATA DIVISIONの指定

01 一意名1.
   02 データ名A  PIC X(8) VALUE 'GETGWADR'.
   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でゲートウェイのノードアドレスを取得します。

リモートAPI機能を使用してサービスを要求した場合,サーバUAPで,ゲートウェイのノードアドレスを取得できます。

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

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

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

●データ名A

ゲートウェイのノードアドレスの取得を示す要求コードを「VALUE 'GETGWADR'」と設定します。

●データ名C

0を設定します。

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

●データ名B

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

●データ名D

ノードアドレスが返されます。リモートAPI機能を使用していない場合は,0が設定されます。

ステータスコード

ステータスコード

意味

00000

正常に終了しました。

00301

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

00302

サービスプログラムから呼び出されていません。