Y：ネームサービスを使用したRPCを使用します。

N：ネームサービスを使用したRPCを使用しません。

形式

dcrapdirect=Yの場合

ホスト名〔:rapリスナーのポート番号〕〔,ホスト名〔:rapリスナーのポート番号〕,…〕

dcscddirect=Yの場合

ホスト名〔:スケジュールサービスのポート番号〕〔,ホスト名〔:スケジュールサービスのポート番号〕,…〕

dcnamuse=Yの場合

ホスト名〔:ネームサービスのポート番号〕〔,ホスト名〔:ネームサービスのポート番号〕,…〕

　

・ホスト名　〜〈文字列〉

・ポート番号　〜〈符号なし整数〉((5001〜65535))

指定できる最大文字数は256です。区切り文字','の後ろ以外は空白文字（スペースまたはタブ）を入れないでください。ホスト名には，10進ドット記法のIPアドレスを指定することもできます。

TP1/Serverのホスト名を二つ以上指定した場合，窓口となるTP1/Serverの障害を検出したとき，dchostオペランドに指定されている次のTP1/Serverを参照して切り替えを試みます。ただし，RPCをrapリスナー経由で行う場合は，TP1/Client/J環境定義でdcrapautoconnect=Y，またはsetDccltextendメソッドでDCRPC_RAP_AUTOCONNECTを指定した場合だけ，dchostオペランドの次のTP1/Serverを参照して切り替えを試みます。

ポート番号は，dcrapdirect=Yの場合，rapリスナーのポート番号を指定します。dcscddirect=Yの場合，スケジュールサービスのポート番号を指定します。dcnamuse=Yの場合，ネームサービスのポート番号を指定します。

ポート番号を省略すると，dcrapdirect=Yの場合，dcrapportオペランドの値を仮定します。dcscddirect=Yの場合，dcscdportオペランドの値を仮定します。dcnamuse=Yの場合，dcnamportオペランドの値を仮定します。

• closeConnectionメソッド
• openConnectionメソッド
• rpcCallメソッド（スケジューラダイレクト機能を使用した非応答型RPCの場合を除く）
• rpcCallToメソッド（同期応答型RPCの場合）
• trnBeginメソッド
• trnChainedCommitメソッド
• trnChainedRollbackメソッド
• trnUnchainedCommitメソッド
• trnUnchainedRollbackメソッド

Y：rapサーバ側にCUPの最大応答待ち時間を引き継ぎます。

N：rapサーバ側にCUPの最大応答待ち時間を引き継ぎません。

Y：TP1/Server側にCUPの最大応答待ち時間を引き継ぎます。

N：TP1/Server側にCUPの最大応答待ち時間を引き継ぎません。

00000000：TP1/Client/Jの機能を拡張しません。

00000001：rpcCallメソッド呼び出し時，自CUPのIPアドレスをサービスに連絡します。呼び出したサービスでdc_rpc_get_callers_address()関数を実行し，CUPのアドレスを求める必要がある場合に指定します。

Y：窓口となるTP1/Serverをランダムに選択します。

N：窓口となるTP1/Serverをランダムに選択しません。

Yを指定した場合

窓口となるTP1/Serverのネームサービスへ問い合わせ中に障害を検出した場合，障害を検出したTP1/Serverを除いて，再び窓口となるTP1/Serverをランダムに選択し，切り替えを試みます。

Nを指定した場合

窓口となるTP1/Serverのネームサービスへ問い合わせ中に障害を検出した場合，dchostオペランドに指定された次のTP1/Serverに切り替えを試みます。

Y：スケジューラダイレクト機能を使用したRPCを使用します。

N：スケジューラダイレクト機能を使用したRPCを使用しません。

Y：サービス要求を受け付けた窓口となるTP1/Serverを優先して負荷分散します。

N：サービス要求を受け付けた窓口となるTP1/Serverを優先しません。TP1/Serverは，ノード間の負荷を分散します。

Y：次回メソッド実行時に自動的に常設コネクションを確立します。常設コネクション確立要求先は，TP1/Client/J環境定義のdchostオペランドに指定したrapリスナーです。

N：常設コネクションを自動的に確立させません。

コネクション確立モードの違いによる各メソッドの動作

非オートコネクトモードの場合およびオートコネクトモードの場合のコネクション確立処理は，次の表のようになります。

表5-2　コネクション確立モードの違いによる各メソッドの動作

dcrapautoconnectオペランドの指定値	openConnection()メソッドを発行	openConnection(host, port)メソッドを発行	openConnection(url, flags)メソッドを発行	rpcCall()メソッドを発行
N	dchostオペランドが指定されている場合，dchostオペランドに指定されたrapサーバにコネクションを確立する。 dcweburlオペランドが指定されている場合，dcweburlオペランドに指定されたURLにコネクションを確立する。 dchostオペランドおよびdcweburlオペランドが指定されていない場合，ErrHostUndefExceptionが返される。	host引数およびport引数に指定されたrapサーバにコネクションを確立する。	url引数に指定されたURLにコネクションを確立する。	ErrProtoExceptionが返される。
Y	ErrProtoExceptionが返される。	ErrProtoExceptionが返される。	ErrProtoExceptionが返される。	dchostオペランドが指定されている場合，dchostオペランドに指定されたrapサーバにコネクションを確立する。 dcweburlオペランドが指定されている場合，dcweburlオペランドに指定されたURLにコネクションを確立する。 dchostオペランドおよびdcweburlオペランドが指定されていない場合，ErrHostUndefExceptionが返される。

注

• setRpcextendメソッドによってdcrapautoconnectオペランドの値を動的に変更できます。
• rpcOpenメソッドで定義を読み込みます。
• rpcCloseメソッドで読み込んだ定義情報を破棄します。
• 引数にURLを指定したopenConnectionメソッドを実行した場合，指定されたURLは，そのURLを指定したopenConnectionメソッドだけで採用します。このメソッドの実行後，closeConnectionメソッドでコネクションを切断し，次に引数指定無しのopenConnectionメソッドを実行しても，前回の引数に指定したURLは採用されません。

Y：エラートレースを取得します。

N：エラートレースを取得しません。

Y：メソッドトレースを取得します。

N：メソッドトレースを取得しません。

Y：UAPトレースを取得します。

N：UAPトレースを取得しません。

Y：データトレースを取得します。

N：データトレースを取得しません。

nothing

統計情報を取得しません。

base

基本情報として，次の情報を取得します。

・トランザクションブランチの識別子

・トランザクションブランチの決着結果

・トランザクションブランチの実行プロセス種別

・トランザクションブランチの実行サーバ名

・トランザクションブランチの実行サービス名

executiontime

基本情報とトランザクションブランチの実行時間情報を取得します。

cputime

基本情報とトランザクションブランチのCPU時間情報を取得します。

• トランザクションサービス定義にtrn_tran_statistics=Yを指定
• trnsticsコマンドで-sオプションを指定

base

同期点取得処理全体（プリペア処理，コミット処理，およびロールバック処理）を最適化します。OpenTP1のトランザクション制御は2相コミット方式で実行しているため，二つのトランザクションブランチ間のコミット制御には，4回のプロセス間通信が必要となります。

次の条件をすべて満たす場合，親トランザクションブランチが子トランザクションブランチのコミット処理を代わりに実行することで，コミット制御で必要な4回のプロセス間通信を削減します。

・親トランザクションブランチと，子トランザクションブランチが同一OpenTP1下にあること。

・親トランザクションブランチが，子トランザクションブランチを同期応答型RPCで呼び出していること。

・子トランザクションブランチでアクセスしたリソースマネジャのXAインタフェース用オブジェクトが，親トランザクションブランチにもリンケージされていること。

asyncprepare

baseの指定条件を満たしていないため同期点取得処理全体の最適化ができない場合に，プリペア処理を最適化します。

次の条件をすべて満たす場合，親トランザクションブランチから発行されたRPCによって子トランザクションブランチがサービス要求を実行したときに，RPCが返される前にプリペア処理を実行することで，2回のプロセス間通信を削減します。

・baseを指定した最適化ができないこと。

・親トランザクションブランチが，子トランザクションブランチを同期応答型RPCで呼び出していること。

ただし，この最適化を実行した場合，親トランザクションブランチが発行した同期応答型RPCの応答時間が遅くなります。また，子トランザクションブランチは，プリペア処理からコミット処理までの間隔（親トランザクションブランチからの指示がないとトランザクションを決着できない状態）が大きくなります。そのため，親トランザクションブランチのOpenTP1がシステムダウンし，トランザクションブランチ間の連絡ができなくなると，ジャーナルファイルのスワップやチェックポイントダンプファイルの有効化が遅れ，子トランザクションブランチのOpenTP1もシステムダウンする場合があります。

1＞2

no

ロールバック情報を取得しません。

self

ロールバック要因が発生したトランザクションブランチでだけ，ログにロールバック情報を取得します。

remote

selfに加え，他ノードのトランザクションブランチからロールバック要求されたトランザクションブランチでも，ログにロールバック情報を取得します。

all

remoteに加え，自ノードのトランザクションブランチからロールバック要求されたトランザクションブランチでも，ログにロールバック情報を取得します。

• rpcCallメソッドのタイムアウト時間
  「K≧このオペランドの指定時間」の場合：要求処理を実行しないで，タイムアウトでエラーリターンします。
  「K＜このオペランドの指定時間」および「（このオペランドの指定時間−K）≧W」の場合：Wをタイムアウト時間とします。
  「K＜このオペランドの指定時間」および「（このオペランドの指定時間−K）＜W」の場合：（このオペランドの指定時間−K）をタイムアウト時間とします。
  「K」「W」の内容は次のとおりです。
  K：現時刻−トランザクションブランチ開始時刻
  W：dcwatchtimオペランド指定時間
  
• 同期点処理内で行う通信のタイムアウト時間
  「K≧このオペランドの指定時間」の場合：タイムアウト時間を1秒とします。
  「K＜このオペランドの指定時間」および「（このオペランドの指定時間−K）≧W」の場合：Wをタイムアウト時間とします。
  「K＜このオペランドの指定時間」および「（このオペランドの指定時間−K）＜W」の場合：（このオペランドの指定時間−K）をタイムアウト時間とします。
  「K」「W」の内容は次のとおりです。
  K：現時刻−トランザクションブランチ開始時刻
  W：dcclttrwatchtimeオペランド指定時間（dcclttrwatchtimeオペランドを省略した場合はdcwatchtimオペランド指定時間）
  

Y：ロールバック完了通知を受信します。

N：ロールバック完了通知を受信しません。

（障害1）RPCがタイムアウトした場合

この場合，RPC発行元トランザクションブランチは，サービス要求がどのプロセスで実行されているかがわからないため，RPC発行先トランザクションブランチにトランザクション同期点メッセージを送信できません。そのため，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチはトランザクション同期点メッセージ待ちとなり，トランザクションの決着に時間が掛かります。

（障害2）rapサーバがRPCの応答受信前にダウンした場合

この場合，RPC発行元トランザクションブランチは，サービス要求がどのプロセスで実行されているかがわからないため，RPC発行先トランザクションブランチにトランザクション同期点メッセージを送信できません。そのため，RPC発行先トランザクションブランチはトランザクション同期点メッセージ待ちとなり，トランザクションの決着に時間が掛かります。

（障害3）RPC発行先UAPからの応答受信後にrapサーバとRPC発行先UAPがほぼ同時にダウンした場合

この場合，それぞれのトランザクションブランチを引き継いだトランザクション回復プロセスは，相手プロセスのダウンを知らないため，すでに存在しないプロセスにトランザクション同期点メッセージを送信してしまい，トランザクションの決着に時間が掛かることがあります。

type1

（障害1）が発生した場合，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

（障害2）が発生した場合，RPC発行元トランザクションブランチは，RPC発行先トランザクションブランチにトランザクション同期点メッセージを送信しないでトランザクションを決着します。RPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

（障害3）が発生した場合，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

type2

（障害1）が発生してトランザクションをコミットする場合はtype1と同じです。

（障害1）が発生してトランザクションをロールバックする場合，または（障害2）が発生した場合は，RPC発行元トランザクションブランチは，RPC発行先トランザクションブランチが存在するノードのトランザクションサービスプロセスにトランザクション同期点メッセージを送信後，トランザクションを決着します。トランザクション同期点メッセージを受信したトランザクションサービスプロセスは，該当するトランザクションブランチを処理中のプロセスに，トランザクション同期点指示を送信します。

（障害3）が発生した場合，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

type3

（障害1）が発生してトランザクションをコミットする場合は，type1と同じです。

（障害1）が発生してトランザクションをロールバックする場合，（障害2）が発生した場合，または（障害3）が発生した場合，相手トランザクションブランチが存在するノードのトランザクションサービスプロセスに，トランザクション同期点メッセージを送信します。トランザクション同期点メッセージを受信したトランザクションサービスプロセスは，該当するトランザクションブランチを処理中のプロセスに，トランザクション同期点指示を送信します。

• RPC実行中に，RPC発行先UAPの状態が変更となり（負荷増加，UAP終了，UAP閉塞など），ほかのノードの同一UAPにサービス要求が再転送された場合
• 相手先のOpenTP1がこのオプションをサポートしていないバージョンの場合
• 相手先トランザクションブランチがトランザクション同期点メッセージ受信処理以外で時間が掛かっている場合

1. 監視対象のトランザクションブランチが，RPC機能を使ってほかのトランザクションブランチを呼び出し，その処理が終わるのを待つ時間
2. 連鎖型RPCで呼び出されたサーバUAPが次のサービス要求を待つ時間
3. 監視対象のトランザクションブランチが，非応答型RPCを使用してほかのトランザクションブランチを呼び出したあと，処理結果受信処理を行っている時間

Y：1，2，3すべてを監視時間に含みます。

N：3だけを監視時間に含みます。

F：1，2，3のどれも監視時間に含みません。

DCCLT_ONEWAY_SND：メッセージを一方送信するための環境

DCCLT_ONEWAY_RCV：メッセージを一方受信するための環境

DCCLT_SNDRCV：メッセージを送受信するための環境

Y：cltReceiveメソッド実行時に，コネクションが確立されていない場合は受信用ソケットを開設します。

N：rpcOpenメソッド実行時に，受信用ソケットを開設します。

• スケジューラダイレクト機能を使用したRPC
• 通信先を指定したRPC
• TP1/Web接続機能

表5-3　dccltrpcmaxmsgsizeオペランドに2以上を指定した場合のrpcCallメソッドの動作

（凡例）

○：要求できます。

×：要求できません。

注※1

窓口となるTP1/Serverに指定されているall_nodeオペランドで定義された，SPPを起動しているノードのバージョンです。

注※2

システム共通定義にrpc_max_message_sizeオペランドを指定している場合。

注※3

入力データ長が1メガバイト以上の場合は，ErrMessageTooBigExceptionが発生し，入力データ長が1メガバイト以下で出力領域長が1メガバイト以上の場合はErrInvalidArgsExceptionが発生します。

注※4

ErrNoSuchServiceGroupExceptionが発生します。

Y：サービス要求先スケジューラをRPCごとに分散させます。

N：サービス要求先スケジューラをRPCごとに分散させません。

Y：負荷レベルが最も低いサービス要求先スケジューラの情報をキャッシュに格納します。

N：負荷レベルが最も低いサービス要求先スケジューラの情報をキャッシュに格納しません。

Y：性能解析トレースを取得します。ただし，PRFデーモンが起動していない場合は性能解析トレースを取得しません。

N：性能解析トレースを取得しません。

Y：TP1/Client/J内部で識別情報を付加します。

N：TP1/Client/J内部で識別情報を付加しません。

Y：マルチホームドホスト形態のTP1/Serverに対してネームサービスを使用したRPCを行います。RPCの要求先を複数定義している場合，またはマルチホームドホスト形態のTP1/Serverが一つ以上ある場合に指定してください。

N：マルチホームドホスト形態のTP1/Serverに対してネームサービスを使用したRPCを行いません。マルチホームドホスト形態のTP1/Serverに対してネームサービスを使用したRPCを行うと，エラーが発生する場合があります。

Y：データ圧縮機能を使用します。

N：データ圧縮機能を使用しません。

• openConnectionメソッドを呼び出します。引数有りのopenConnectionメソッドの場合，引数hostにDCCM3論理端末のホスト名，引数portにDCCM3論理端末のポート番号を指定します。
• TP1/Client/J環境定義のdcrapautoconnectオペランドにYを指定し，rpcCallメソッドを呼び出します。

Y：マルチスケジューラ機能を使用します。

N：マルチスケジューラ機能を使用しません。

• 下限値：dchostまたはdcscdportに指定したポート番号の値
• 上限値：下限値 + dcscdmulticountに指定したプロセス数 - 1

• スケジューラダイレクト機能を使用したRPC
• ネームサービスを使用したRPC
• リモートAPI機能を使用したRPC
• 通信先を指定したRPC
• TCP/IP通信機能

• ホスト名としてlocalhostを指定した場合
• 127で始まるIPアドレスを指定した場合
• CUPを実行するマシン上に存在しないホストを指定した場合

• スケジューラダイレクト機能を使用したRPCの受信時（受信ポート）
• ネームサービスを使用したRPCの受信時（受信ポート）