リモートAPI機能とは，クライアント側のノードにあるUAPが発行したAPIを，OpenTP1がサーバ側に転送してサーバ側のプロセスで代理実行する機能です。リモートAPI機能を要求するクライアント側のノードにあるUAPをrapクライアントといいます。rapクライアントが発行したAPIを，OpenTP1のrapリスナーが受け付け，rapサーバがサーバ側のノードで実行します。rapリスナー，rapサーバはOpenTP1のユーザサービスとして動作します。

リモートAPI機能を次の図に示します。

図3-68　リモートAPI機能

rapクライアントとなるUAPを次の表に示します。

表3-16　rapクライアントとなるUAP

プログラムプロダクト	rapクライアントとなるUAP
TP1/Server Base，TP1/LiNK	SUP，SPP，MHP
TP1/Client	CUP

次に，rapクライアントから代理実行できるAPIをrapクライアントの種類ごとに示します。

• TP1/Server Base，TP1/LiNKがrapクライアントとなる場合
  

  C言語ライブラリ	COBOL-UAP作成用プログラム
  dc_rpc_call	CBLDCRPC（'CALL '）

• TP1/Client/P，TP1/Client/Wがrapクライアントとなる場合
  

  C言語ライブラリ	COBOL-UAP作成用プログラム
  dc_rpc_call_s	CBLDCRPS（'CALL '）
  dc_trn_begin_s	CBLDCTRS（'BEGIN '）
  dc_trn_chained_commit_s	CBLDCTRS（'C-COMMIT'）
  dc_trn_chained_rollback_s	CBLDCTRS（'C-ROLL '）
  dc_trn_unchained_commit_s	CBLDCTRS（'U-COMMIT'）
  dc_trn_unchained_rollback_s	CBLDCTRS（'U-ROLL '）

• TP1/Client/Jがrapクライアントとなる場合
  

  メソッド
  rpcCall
  trnBegin
  trnChainedCommit
  trnChainedRollback
  TrnUnchainedCommit
  trnUnchainedRollback

• TP1/Client for .NET Frameworkがrapクライアントとなる場合
  

  メソッド
  Call
  Begin
  CommitChained
  RollbackChained
  Commit
  Rollback

＜この節の構成＞

3.7.1　リモートAPI機能の使用例

3.7.2　常設コネクション

3.7.3　コネクトモード

3.7.4　rapクライアントマネジャ

3.7.5　リモートAPI機能を使用する場合に設定する必要がある定義

3.7.6　XAリソースサービスを使用する場合