ここでは，TP1/Client/J環境定義の一覧，定義の規則，およびパス名の形式について説明します。

(a)　TP1/Client/J環境定義の一覧

TP1/Client/J環境定義の一覧を，次の表に示します。

項番	オペランド	定義内容	指定値※
1	dcnamuse	ネームサービスを使用したRPCを使用するかどうかを指定	Y｜《N》
2	dcnamport	ネームサービスのポート番号	〈符号なし整数〉((5001〜65535))《10000》
3	dchost	窓口となるTP1/Serverのホスト名	〈文字列〉
4	dcwatchtim	最大応答待ち時間	〈符号なし整数〉((0〜65535))《180》（単位：秒）
5	dccltinquiretime	常設コネクション問い合わせ間隔最大時間	〈符号なし整数〉((0〜1048575))（単位：秒）
6	dcwatchtiminherit	リモートAPI機能を使用したRPCを行う場合に，CUPの最大応答待ち時間をrapサーバ側に引き継ぐかどうかを指定	Y｜《N》
7	dcwatchtimrpcinherit	CUPの最大応答待ち時間をTP1/Server側に引き継ぐかどうかを指定	Y｜《N》
8	dccltdelay	最大通信遅延時間	〈符号なし整数〉((0〜65535))《0》（単位：秒）
9	dcselint	応答電文監視時間間隔	〈符号なし整数〉((1〜65535))《100》（単位：ミリ秒）
10	dccltextend	TP1/Client/Jの機能拡張レベルの設定を指定	00000000｜00000001
11	dccache	ネームキャッシュの最大エントリ数	〈符号なし整数〉((2〜256))《8》
12	dchostselect	窓口となるTP1/Serverをランダムに選択するかどうかを指定	Y｜《N》
13	dcscddirect	TP1/Serverのネームサービスにサービス情報を問い合わせないで，スケジューラダイレクト機能を使用したRPCを使用するかどうかを指定	Y｜《N》
14	dcscdport	スケジュールサービスのポート番号	〈符号なし整数〉((5001〜65535))
15	dcscdloadpriority	サービス要求を受け付けた窓口となるTP1/Serverを優先して負荷分散するかどうかを指定	Y｜《N》
16	dcrapdirect	TP1/Serverのネームサービスにサービス情報を問い合わせないで，直接rapリスナーに問い合わせる機能，すなわちリモートAPI機能を使用するかどうかを指定	《Y》｜N
17	dcrapport	rapリスナーのポート番号	〈符号なし整数〉((5001〜65535))
18	dcrapautoconnect	CUPとrapサーバとの間の常設コネクションを自動的に確立させるかどうかを指定	Y｜《N》
19	dcerrtrace	CUPでエラートレースを取得するかどうかを指定	Y｜《N》
20	dcerrtracepath	エラートレースファイル作成ディレクトリ	〈文字列〉
21	dcerrtracesize	エラートレースファイルサイズ	〈符号なし整数〉((4096〜1048576))《4096》（単位：バイト）
22	dcmethodtrace	CUPでメソッドトレースを取得するかどうかを指定	Y｜《N》
23	dcmethodtracepath	メソッドトレースファイル作成ディレクトリ	〈文字列〉
24	dcmethodtracesize	メソッドトレースファイルサイズ	〈符号なし整数〉((4096〜1048576))《4096》（単位：バイト）
25	dcuaptrace	CUPでUAPトレースを取得するかどうかを指定	Y｜《N》
26	dcuaptracepath	UAPトレースファイル作成ディレクトリ	〈文字列〉
27	dcuaptracesize	UAPトレースファイルサイズ	〈符号なし整数〉((4096〜1048576))《4096》（単位：バイト）
28	dcdatatrace	CUPでデータトレースを取得するかどうかを指定	Y｜《N》
29	dcdatatracepath	データトレースファイル作成ディレクトリ	〈文字列〉
30	dcdatatracesize	データトレースファイルサイズ	〈符号なし整数〉((4096〜1048576))《4096》（単位：バイト）
31	dcdatatracemaxsize	データトレースの最大データ長	〈符号なし整数〉((16〜1048576))《128》（単位：バイト）
32	dcclttrstatisitem	トランザクションブランチの統計情報を取得する項目を指定	統計情報項目〔,統計情報項目〕…
33	dcclttroptiitem	複数のユーザサーバで構成されるグローバルトランザクションの性能を向上させるための最適化項目を指定	トランザクション最適化項目〔,トランザクション最適化項目〕…
34	dcclttrwatchtime	トランザクション同期点処理時の最大通信待ち時間	〈符号なし整数〉((1〜65535))（単位：秒）
35	dcclttrrbinfo	トランザクションブランチがロールバックした場合に，ロールバック要因に関する情報をログに取得するかどうかを指定	no｜self｜remote｜all
36	dcclttrlimittime	トランザクションブランチ最大実行可能時間	〈符号なし整数〉((0〜65535))（単位：秒）
37	dcclttrrbrcv	RPC先トランザクションブランチにロールバック指示を送信したあと，ロールバック完了通知を受信するかどうかを指定	Y｜N
38	dcclttrrecoverytype	UAP障害時のトランザクション同期点処理方式を指定	type1｜type2｜type3
39	dcclttrexptm	トランザクションブランチ限界経過時間	〈符号なし整数〉((0〜65535))（単位：秒）
40	dcclttrcputm	トランザクションブランチCPU監視時間	〈符号なし整数〉((0〜65535))（単位：秒）
41	dcclttrexpsp	トランザクションブランチの処理を監視するとき，次の処理時間も監視時間に含むかどうかを指定 監視対象のトランザクションブランチが，RPC機能を使ってほかのトランザクションブランチを呼び出し，その処理が終わるのを待つ時間 連鎖型RPCで呼び出されたサーバUAPが次のサービス要求を待つ時間 監視対象のトランザクションブランチが，非応答型RPCを使用してほかのトランザクションブランチを呼び出したあと，処理結果受信処理を行っている時間	Y｜N｜F
42	dcsndrcvtype	TCP/IP通信機能の使用時に，初期化する環境を指定	DCCLT_ONEWAY_SND｜DCCLT_ONEWAY_RCV｜DCCLT_SNDRCV
43	dcrcvport	受信用のCUPのポート番号	〈符号なし整数〉((1〜65535))《11000》
44	dcsndhost	接続するMHPが存在するノードのホスト名	〈文字列〉
45	dcsndport	接続するMHPのポート番号	〈符号なし整数〉((1〜65535))《12000》
46	dcsockopenatrcv	TCP/IP通信機能の使用時に，1コネクションで送受信する場合の，受信用ソケットを開設する契機（送信相手からの接続を待ち受け始める契機）を指定	Y｜《N》
47	dcweburl	サービス要求先のTP1/WebのURL	〈パス名〉
48	dccltdbgtrcfilecount	デバッグトレースファイルの最大ファイル数	〈符号なし整数〉((0〜256))《0》
49	dccltrpcmaxmsgsize	RPC送受信電文の最大長	〈符号なし整数〉((1〜8))《1》（単位：メガバイト）
50	dcscdhostchange	TP1/Client/J環境定義のdchostオペランドに指定したサービス要求先スケジューラをRPCごとに分散させるかどうかを指定	Y｜《N》
51	dccltloadbalance	ネームサーバから得た複数のサービス要求先スケジューラの情報から，負荷レベルが最も低いサービス要求先スケジューラの情報をキャッシュに格納するかどうかを指定	Y｜《N》
52	dccltcachetim	キャッシュの有効期限	〈符号なし整数〉((0〜65535))《30》（単位：秒）
53	dccltconnecttimeout	コネクション確立最大監視時間	〈符号なし整数〉((0〜65535))《0》（単位：秒）
54	dccltprftrace	TP1/Client/Jをサービスプラットフォーム上で動作させた場合に，サービスプラットフォームの性能解析トレースを取得するかどうかを指定	《Y》｜N
55	dccltprfinfosend	TP1/Serverに対して，ネームサービスを使用したRPC，およびスケジューラダイレクト機能を使用したRPCを行う場合に，OpenTP1の性能検証用トレースに出力する情報としてTP1/Client/J内部で識別情報を付加するかどうかを指定	《Y》｜N
56	dccltnammlthost	マルチホームドホスト形態のTP1/Serverに対してネームサービスを使用したRPCを行うかどうかを指定	Y｜《N》
57	dccltdatacomp	データ圧縮機能を使用するかどうかを指定	Y｜《N》
58	dccltconnectinf	端末識別情報として，DCCM3論理端末の論理端末名称をEBCDIKコードで指定	端末識別情報
59	dcscdmulti	マルチスケジューラ機能を使用するかどうかを指定	Y｜《N》
60	dcscdmulticount	マルチスケジューラデーモンのプロセス数	〈符号なし整数〉((1〜4096))《1》
61	dccltcupsndhost	CUPの送信元ホスト	〈文字列〉
62	dccltcuprcvport	サーバからのメッセージを受信するCUPのポート番号	〈符号なし整数〉((5001〜65535))
63	dcclttrcmplmttm	トランザクション完了限界時間	〈符号なし整数〉((0〜65535))（単位：秒）

注※

指定値の記号については，「(b)　定義の規則」を参照してください。

(b)　定義の規則

定義の説明に使用する各種の記号を説明します。

ここで述べる文法記述記号，属性記述記号，および構文要素記号は実際の定義には記述しません。

●文法記述記号

文法の記述について説明する記号です。

文法記述記号	意味
〔　　　〕	この記号で囲まれている項目は省略できることを示します。 （例）ホスト名〔:ポ−ト番号〕 これは，「ホスト名」と指定するか，または「ホスト名:ポ−ト番号」と指定することを示します。
｜	この記号で仕切られた項目は選択できることを示します。 （例）dcnamuse=Y｜N これは，dcnamuse=Yと指定するか，またはdcnamuse=Nと指定することを示します。
…	記述が省略されていることを示します。この記号の直前に示された項目を繰り返し複数個指定できます。 （例）ホスト名〔:ポ−ト番号〕〔,ホスト名〔:ポ−ト番号〕,…〕 ホスト名〔:ポ−ト番号〕を続けて指定できることを示します。

●属性記述記号

ユーザ指定値の範囲などを説明する記号です。

属性記述記号	意味
〜	この記号のあとにユーザ指定値の属性を示します。
《 》	ユーザ指定値の省略値を示します。
〈 〉	ユーザ指定値の構文要素記号を示します。
(( ))	ユーザ指定値の指定範囲を示します。

●構文要素記号

ユーザ指定値の内容を説明する記号です。

構文要素記号	意味
〈英字〉	アルファベット（A〜Z，a〜z），および_（アンダースコア）
〈英数字〉	英字と数字（0〜9）
〈英字記号〉	アルファベット（A〜Z，a〜z），#，@，および\
〈符号なし整数〉	数字（0〜9）
〈符号なし16進整数〉	数字（0〜9），A〜F，a〜f
〈記号名称〉	英字記号と数字の並び（先頭は英字記号）
〈文字列〉	任意の文字の配列
〈パス名〉	記号名称，/，および .（ピリオド） （ただし，パス名は使用するOSに依存）

(c)　パス名の記述形式

次のオペランドにパス名を指定する場合，ファイル区切り文字に「\」を使用するときは，「\」を「\\」と記述してください。

• dcerrtracepath
• dcmethodtracepath
• dcuaptracepath
• dcdatatracepath

例　"C:\Clt4J\trace"にエラートレースを取得する場合

 
dcerrtracepath = C:\\Clt4J\\trace
 

または，

 
dcerrtracepath = C:/Clt4J/trace

Javaアプリケーション，またはJavaサーブレットでは，TP1/Client/J環境定義を任意のファイルに格納してrpcOpenメソッドの引数でこのファイル名を指定します。また，rpcOpenメソッドを引数なしで呼び出した場合は，システムプロパティとして定義することもできます。

Javaアプレットでは，paramタグでTP1/Client/J環境定義を定義します。

TP1/Client/J環境定義を次に示します。

(a)　形式

〔dcnamuse=Y|N〕
〔dcnamport=ネームサービスのポート番号〕
〔dchost=窓口となるTP1/Serverのホスト名〕
〔dcwatchtim=最大応答待ち時間〕
〔dccltinquiretime=常設コネクション問い合わせ間隔最大時間〕
〔dcwatchtiminherit=Y|N〕
〔dcwatchtimrpcinherit=Y|N〕
〔dccltdelay=最大通信遅延時間〕
〔dcselint=応答電文監視時間間隔〕
〔dccltextend=機能拡張レベル〕
〔dccache=ネームキャッシュの最大エントリ数〕
〔dchostselect=Y|N〕
〔dcscddirect=Y|N〕
〔dcscdport=スケジュールサービスのポート番号〕
〔dcscdloadpriority=Y|N〕
〔dcrapdirect=Y|N〕
〔dcrapport=rapリスナーのポート番号〕
〔dcrapautoconnect=Y|N〕
〔dcerrtrace=Y|N〕
〔dcerrtracepath=エラートレースファイル作成ディレクトリ〕
〔dcerrtracesize=エラートレースファイルサイズ〕
〔dcmethodtrace=Y|N〕
〔dcmethodtracepath=メソッドトレースファイル作成ディレクトリ〕
〔dcmethodtracesize=メソッドトレースファイルサイズ〕
〔dcuaptrace=Y|N〕
〔dcuaptracepath=UAPトレースファイル作成ディレクトリ〕
〔dcuaptracesize=UAPトレースファイルサイズ〕
〔dcdatatrace=Y|N〕
〔dcdatatracepath=データトレースファイル作成ディレクトリ〕
〔dcdatatracesize=データトレースファイルサイズ〕
〔dcdatatracemaxsize=データトレースの最大データ長〕
〔dcclttrstatisitem=統計情報項目〕
〔dcclttroptiitem=トランザクション最適化項目〕
〔dcclttrwatchtime=トランザクション同期点処理時の最大通信待ち時間〕
〔dcclttrrbinfo=no|self|remote|all〕
〔dcclttrlimittime=トランザクションブランチ最大実行可能時間〕
〔dcclttrrbrcv=Y|N〕
〔dcclttrrecoverytype=type1|type2|type3〕
〔dcclttrexptm=トランザクションブランチ限界経過時間〕
〔dcclttrcputm=トランザクションブランチCPU監視時間〕
〔dcclttrexpsp=Y|N|F〕
〔dcsndrcvtype=DCCLT_ONEWAY_SND｜DCCLT_ONEWAY_RCV｜DCCLT_SNDRCV〕
〔dcrcvport=受信用のCUPのポート番号〕
〔dcsndhost=接続するMHPが存在するノードのホスト名〕
〔dcsndport=接続するMHPのポート番号〕
〔dcsockopenatrcv=Y|N〕
〔dcweburl=サービス要求先のTP1/WebのURL〕
〔dccltdbgtrcfilecount=デバッグトレースファイルの最大ファイル数〕
〔dccltrpcmaxmsgsize=RPC送受信電文の最大長〕
〔dcscdhostchange=Y|N〕
〔dccltloadbalance=Y|N〕
〔dccltcachetim=キャッシュの有効期限〕
〔dccltconnecttimeout=コネクション確立最大監視時間〕
〔dccltprftrace=Y|N〕
〔dccltprfinfosend=Y|N〕
〔dccltnammlthost=Y|N〕
〔dccltdatacomp=Y|N〕
〔dccltconnectinf=端末識別情報〕
〔dcscdmulti=Y|N〕
〔dcscdmulticount=マルチスケジューラデーモンのプロセス数〕
〔dccltcupsndhost=送信元ホスト〕
〔dccltcuprcvport=CUPの受信で使用するポート番号〕
〔dcclttrcmplmttm=トランザクション完了限界時間〕

(b)　オペランド

dcnamuse=Y｜N　〜《N》

ネームサービスを使用したRPCを使用するかどうかを指定します。

Y

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

N

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

dcnamuse，dcrapdirect，およびdcscddirectオペランドは排他関係にあるため，同時にYを指定できません。これらのオペランドの2つ以上にYを指定した場合，定義エラーとなります。

TP1/Web接続機能は，dcrapdirectオペランドにYを指定した場合にだけ使用できます。dcweburlオペランドを定義して，かつdcscddirect=Yおよびdcrapdirect=Yの場合は，定義エラーとなります。

dcnamport=ネームサービスのポート番号

〜〈符号なし整数〉((5001〜65535))《10000》

クライアントが属しているOpenTP1のシステム共通定義のname_portオペランドで指定したネームサービスのポート番号を指定します。dchostオペランドでポート番号を指定していないホストに対して，この定義の値が有効になります。

dchost=窓口となるTP1/Serverのホスト名　〜〈文字列〉

窓口となるTP1/Serverのホスト名と，rapリスナーのポート番号，スケジュールサービスのポート番号，またはネームサービスのポート番号を指定します。区切り文字「,」を使用して，複数のTP1/Serverを指定できます。RPCをrapリスナー経由で行う場合は，rapリスナーのホスト名，またはファイアウォールのホスト名を指定します。

dchostオペランドとdcweburlオペランドの両方を指定した場合は，dcweburlオペランドの指定が有効になります。

形式

dcrapdirect=Yの場合

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

dcscddirect=Yの場合

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

dcnamuse=Yの場合

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

• ホスト名　〜〈文字列〉
  TP1/Serverのホスト名を2つ以上指定した場合，窓口となるTP1/Serverの障害を検出したとき，dchostオペランドに指定されている次のTP1/Serverを参照して切り替えを試みます。ただし，RPCをrapリスナー経由で行う場合は，TP1/Client/J環境定義でdcrapautoconnect=Y，またはsetDccltextendメソッドでDCRPC_RAP_AUTOCONNECTを指定した場合だけ，dchostオペランドの次のTP1/Serverを参照して切り替えを試みます。
  
• ポート番号　〜〈符号なし整数〉((5001〜65535))
  ポート番号は，dcrapdirect=Yの場合，rapリスナーのポート番号を指定します。dcscddirect=Yの場合，スケジュールサービスのポート番号を指定します。dcnamuse=Yの場合，ネームサービスのポート番号を指定します。
  ポート番号を省略すると，dcrapdirect=Yの場合，dcrapportオペランドの値を仮定します。dcscddirect=Yの場合，dcscdportオペランドの値を仮定します。dcnamuse=Yの場合，dcnamportオペランドの値を仮定します。
  

dcwatchtim=最大応答待ち時間

〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

CUPからTP1/Serverに対しての要求を開始してから応答が返るまでの待ち時間の最大値を指定します。

指定時間を過ぎても応答が返らない場合は，CUPへエラーリターンします。0を指定した場合は，応答を受信するまで無限に待ち続けます。

dcwatchtimオペランドの指定が適用されるAPI（メソッド）を次に示します。

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

dccltinquiretime=常設コネクション問い合わせ間隔最大時間

〜〈符号なし整数〉((0〜1048575))（単位：秒）

CUPがサーバに対して問い合わせを行ってから，次の問い合わせをするまでの間隔の最大時間を指定します。常設コネクション問い合わせ間隔最大時間はrapサーバで監視するタイマです。指定時間を超えても問い合わせがない場合，rapサーバ側で強制的に常設コネクションを解放します。また，トランザクション内で常設コネクション問い合わせ間隔最大時間に達したことを検知した場合は，該当するトランザクションを強制的にロールバックします。

この定義に0を指定した場合は，CUPからの問い合わせを無限に待ちます。この指定を省略した場合は，rapリスナーサービス定義のrap_inquire_timeオペランドの指定に従います。

dcwatchtiminherit=Y｜N　〜《N》

リモートAPI機能を使用したRPCを行う場合に，CUPの最大応答待ち時間をrapサーバ側に引き継ぐかどうかを指定します。

Y

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

N

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

dcwatchtimrpcinherit=Y｜N　〜《N》

CUPの最大応答待ち時間をTP1/Server側に引き継ぐかどうかを指定します。CUPの最大応答待ち時間を引き継ぐと，CUPがタイムアウトしているのにTP1/Server側でサービスを実行することを防止できます。

Y

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

N

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

dccltdelay=最大通信遅延時間

〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

CUPとrapサーバとの間の通信オーバヘッドを考慮し，rapサーバ側の応答監視をTP1/Client/J側よりも早く終わらせる場合に指定します。この定義を指定すると，rapサーバ側の監視を指定した時間分だけ早く終了させ，TP1/Client/J側の監視時間のタイムアウトによるメッセージのすれ違いを防ぎます。

この定義は，TP1/Client/J環境定義にdcrapdirect=Yおよびdcwatchtiminherit=Yを指定した場合にだけ有効です。

TP1/Client/J環境定義にdcwatchtim=0を指定した場合またはsetDcwatchtimメソッドで0を指定した場合，およびTP1/Client/J環境定義にdcwatchtiminherit=Nを指定した場合は，dccltdelayオペランドの指定は無視されます。dcwatchtimオペランドに指定した値からdccltdelayオペランドに指定した値を引いたときに，0または負の値になった場合も，dccltdelayオペランドの指定は無視され，1が仮定されます。

dcselint=応答電文監視時間間隔　〜〈符号なし整数〉((1〜65535))《100》（単位：ミリ秒）

このオペランドは，旧バージョンとの互換性のためだけに存在します。現在はこのオペランドを指定しても無視されます。

dccltextend=00000000｜00000001

TP1/Client/Jの機能拡張レベルの設定を指定します。

00000000

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

00000001

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

dccache=ネームキャッシュの最大エントリ数　〜〈符号なし整数〉((2〜256))《8》

TP1/Client/Jで使用するサービス情報をキャッシュするためのキャッシュの最大エントリ数を指定します。LRU方式で管理します。キャッシュのエントリ数が指定値を超える場合は，最も過去に呼び出されたサービス情報を削除します。

dchostselect=Y｜N　〜《N》

rpcOpenメソッド実行時，窓口となるTP1/Serverをランダムに選択するかどうかを指定します。この定義は，dchostオペランドに窓口となるTP1/Serverを複数指定した場合にだけ有効です。

Y

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

N

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

窓口となるTP1/Serverへ問い合わせ中に障害を検出した場合，障害を検出したTP1/Serverを除いて，dchostオペランドに指定された次のTP1/Serverに切り替えを試みます。詳細については，「付録A.1(15)　ホスト切り替え機能」を参照してください。

dcscddirect=Y｜N　〜《N》

TP1/Serverのネームサービスにサービス情報を問い合わせないで，スケジューラダイレクト機能を使用したRPCを使用するかどうかを指定します。

Y

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

N

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

TP1/Client/J環境定義のdcscdportオペランドにスケジュールサービスのポート番号を指定したときは，そのポート番号を使用して問い合わせを行います。dcrapdirect，dcscddirect，およびdcnamuseオペランドは排他関係にあるため，同時にYを指定できません。これらのオペランドの2つ以上にYを指定した場合，定義エラーとなります。

TP1/Web接続機能は，dcrapdirectオペランドにYを指定した場合にだけ使用できます。dcweburlオペランドを定義して，かつdcscddirect=Yおよびdcrapdirect=Yの場合は，定義エラーとなります。

dcscdport=スケジュールサービスのポート番号

〜〈符号なし整数〉((5001〜65535))

クライアントが属しているOpenTP1のスケジュールサービス定義のscd_portオペランドで指定したスケジュールサービスのポート番号を指定します。dchostオペランドでポート番号を指定していないホストに対して，この定義の値が有効になります。このオペランドはTP1/Client/J環境定義にdcscddirect=Yを指定したときだけ有効です。詳しくは，TP1/Client/J環境定義のdcscddirectオペランドを参照してください。

dcscdloadpriority=Y｜N　〜《N》

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

Y

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

N

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

この定義は，スケジューラダイレクト機能を使用したRPCを行う場合（TP1/Client/J環境定義にdcscddirect=Yを指定）にだけ，有効です。

dcrapdirect=Y｜N　〜《Y》

TP1/Serverのネームサービスにサービス情報を問い合わせないで，直接rapリスナーに問い合わせる機能，すなわちリモートAPI機能を使用するかどうかを指定します。このオペランドの指定を有効にするには，TP1/Client/J環境定義のdcrapportオペランドにrapリスナーのポート番号を指定します。

dcrapdirect，dcscddirect，およびdcnamuseオペランドは排他関係にあるため，同時にYを指定することはできません。これらのオペランドの2つ以上にYを指定した場合，定義エラーとなります。

dcrapport=rapリスナーのポート番号　〜〈符号なし整数〉((5001〜65535))

クライアントが属しているTP1/Serverのrapリスナーのポート番号，またはファイアウォールのポート番号を指定します。dchostオペランドでポート番号を指定していないホストに対して，このオペランドの値が有効になります。

このオペランドは，TP1/Client/J環境定義にdcrapdirect=Yを指定したときだけ有効です。詳しくは，TP1/Client/J環境定義のdcrapdirectオペランドを参照してください。

dcrapautoconnect=Y｜N　〜《N》

CUPとrapサーバとの間の常設コネクションを自動的に確立させるかどうかを指定します。

Y

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

N

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

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

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

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

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は採用されません。

dcerrtrace=Y｜N　〜《N》

CUPでエラートレースを取得するかどうかを指定します。

Y

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

N

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

CUPをJavaアプレットとして動作させる場合，Yを指定しないでください。Yを指定した場合の動作は保証されません。

dcerrtracepath=エラートレースファイル作成ディレクトリ　〜〈文字列〉

エラートレースファイルを作成するディレクトリのパス名を指定します。

このオペランドは，TP1/Client/J環境定義にdcerrtrace=Yを指定した場合にだけ有効です。

dcerrtracesize=エラートレースファイルサイズ　〜〈符号なし整数〉((4096〜1048576)) 《4096》（単位：バイト）

エラートレースファイルのサイズを指定します。

このオペランドは，TP1/Client/J環境定義にdcerrtrace=Yを指定した場合にだけ有効です。

dcmethodtrace=Y｜N　〜《N》

CUPでメソッドトレースを取得するかどうかを指定します。

Y

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

N

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

CUPをJavaアプレットとして動作させる場合，Yを指定しないでください。Yを指定した場合の動作は保証されません。

dcmethodtracepath=メソッドトレースファイル作成ディレクトリ　〜〈文字列〉

メソッドトレースファイルを作成するディレクトリのパス名を指定します。

このオペランドは，TP1/Client/J環境定義にdcmethodtrace=Yを指定した場合にだけ有効です。

dcmethodtracesize=メソッドトレースファイルサイズ　〜〈符号なし整数〉((4096〜1048576)) 《4096》（単位：バイト）

メソッドトレースファイルのサイズを指定します。

このオペランドは，TP1/Client/J環境定義にdcmethodtrace=Yを指定した場合にだけ有効です。

dcuaptrace=Y｜N　〜《N》

CUPでUAPトレースを取得するかどうかを指定します。

Y

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

N

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

CUPをJavaアプレットとして動作させる場合，Yを指定しないでください。Yを指定した場合の動作は保証されません。

dcuaptracepath=UAPトレースファイル作成ディレクトリ　〜〈文字列〉

UAPトレースファイルを作成するディレクトリのパス名を指定します。

このオペランドは，TP1/Client/J環境定義にdcuaptrace=Yを指定した場合にだけ有効です。

dcuaptracesize=UAPトレースファイルサイズ　〜〈符号なし整数〉((4096〜1048576))《4096》（単位：バイト）

UAPトレースファイルのサイズを指定します。

このオペランドは，TP1/Client/J環境定義にdcuaptrace=Yを指定した場合にだけ有効です。

dcdatatrace=Y｜N　〜《N》

CUPでデータトレースを取得するかどうかを指定します。

Y

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

N

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

CUPをJavaアプレットとして動作させる場合，Yを指定しないでください。Yを指定した場合の動作は保証されません。

dcdatatracepath=データトレースファイル作成ディレクトリ　〜〈文字列〉

データトレースファイルを作成するディレクトリのパス名を指定します。

このオペランドは，TP1/Client/J環境定義にdcdatatrace=Yを指定した場合にだけ有効です。

dcdatatracesize=データトレースファイルサイズ　〜〈符号なし整数〉((4096〜1048576)) 《4096》（単位：バイト）

データトレースファイルのサイズを指定します。

このオペランドは，TP1/Client/J環境定義にdcdatatrace=Yを指定した場合にだけ有効です。

dcdatatracemaxsize=データトレースの最大データ長　〜〈符号なし整数〉((16〜1048576)) 《128》（単位：バイト）

1件のデータトレースのデータ長の最大値を指定します。

このオペランドは，TP1/Client/J環境定義にdcdatatrace=Yを指定した場合にだけ有効です。

dcclttrstatisitem=統計情報項目〔,統計情報項目〕…

トランザクションブランチの統計情報を取得する項目を，次の文字列で指定します。CUPからトランザクションを開始する場合にだけ有効です。

nothing

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

base

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

• トランザクションブランチの識別子
• トランザクションブランチの決着結果
• トランザクションブランチの実行プロセス種別
• トランザクションブランチの実行サーバ名
• トランザクションブランチの実行サービス名

executiontime

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

cputime

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

nothingの指定は，1つしかできません。また，nothingとほかの統計情報項目を同時に指定した場合，nothingの指定は無効になります。

トランザクションに関する統計情報を取得する場合は，次のどちらかを指定してください。

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

この定義を省略した場合は，rapリスナーサービス定義のtrn_statistics_itemオペランドの指定に従います。

dcclttroptiitem=トランザクション最適化項目〔,トランザクション最適化項目〕…

複数のユーザサーバで構成されるグローバルトランザクションの性能を向上させるための最適化項目を，次の文字列で指定します。CUPからトランザクションを開始する場合にだけ有効です。

base

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

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

• 親トランザクションブランチと，子トランザクションブランチが同一OpenTP1下にあること。
• 親トランザクションブランチが，子トランザクションブランチを同期応答型RPCで呼び出していること。
• 子トランザクションブランチでアクセスしたリソースマネジャのXAインタフェース用オブジェクトが，親トランザクションブランチにもリンケージされていること。

asyncprepare

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

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

• baseを指定した最適化ができないこと。
• 親トランザクションブランチが，子トランザクションブランチを同期応答型RPCで呼び出していること。

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

トランザクション最適化項目は，重複して指定できます。ただし，優先順位は次のようになります。

1＞2

1：base

2：asyncprepare

この指定を省略した場合は，rapリスナーサービス定義のtrn_optimum_itemオペランドの指定に従います。

dcclttrwatchtime=トランザクション同期点処理時の最大通信待ち時間

〜〈符号なし整数〉((1〜65535))（単位：秒）

トランザクションの同期点処理で，トランザクションブランチ間で行う通信（プリペア，コミット，ロールバック指示，または応答など）の受信待ち時間の最大値を指定します。CUPからトランザクションを開始する場合にだけ有効です。

指定時間を過ぎても指示または応答がない場合は，該当するトランザクションブランチが2相コミットの1相目であればロールバックさせ，1相目完了後であればトランザクションサービスのシステムプロセスでトランザクション決着処理を再試行します。

この定義を省略した場合は，rapリスナーサービス定義のtrn_watch_timeオペランドの指定に従います。

dcclttrrbinfo=no｜self｜remote｜all

トランザクションブランチがロールバックした場合に，ロールバック要因に関する情報をログに取得するかどうかを指定します。CUPからトランザクションを開始する場合にだけ有効です。

no

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

self

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

remote

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

all

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

この指定を省略した場合は，rapリスナーサービス定義のtrn_rollback_information_putオペランドの指定に従います。

dcclttrlimittime=トランザクションブランチ最大実行可能時間

〜〈符号なし整数〉((0〜65535))（単位：秒）

トランザクションブランチの最大実行可能時間を指定します。CUPからトランザクションを開始する場合だけ有効です。

トランザクションブランチを開始してから同期点処理が終了するまでの時間がこのオペランドの指定時間を超えないように，rpcCallメソッドおよび同期点処理内で行う通信のタイムアウト時間を，次のように自動設定します。

• 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オペランド指定時間）
  

上記の受信待ち以外の処理で時間が掛かった場合は，このオペランドの指定時間内にトランザクションブランチが終了しないことがあります。

同期点処理開始前にこのオペランドの指定時間が経過した場合，そのトランザクションはロールバックされます。

0を指定した場合は，時間監視を行いません。

この定義を省略した場合は，rapリスナーサービス定義のtrn_limit_timeオペランドの指定に従います。

dcclttrrbrcv=Y｜N

RPC先トランザクションブランチにロールバック指示を送信したあと，ロールバック完了通知を受信するかどうかを指定します。CUPからトランザクションを開始する場合にだけ有効です。

Y

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

N

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

Nを指定した場合，RPC先トランザクションブランチからのロールバック完了通知を受信しないで（RPC先トランザクションブランチのロールバック処理の完了を待たないで）自トランザクションブランチを終了します。

この定義を省略した場合は，rapリスナーサービス定義のtrn_rollback_response_receiveオペランドの指定に従います。

dcclttrrecoverytype=type1｜type2｜type3

UAP障害時のトランザクション同期点処理方式を指定します。CUPからトランザクションを開始する場合にだけ有効です。

RPCがタイムアウトし，RPC発行先プロセスのアドレスが未解決の場合およびトランザクション実行中のUAPがダウンした場合に，トランザクションブランチ間の連絡がスムーズにできないため，トランザクションの決着に時間が掛かることがあります。

このオペランドでは，次に示す障害が発生した場合のトランザクション同期点処理方式を，指定値に示す3つの方式から選択して指定します。

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

次に示す場合，このオペランドにtype2またはtype3を指定しても，トランザクションの決着に時間が掛かることがあります。

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

この定義を省略した場合は，rapリスナーサービス定義のtrn_partial_recovery_typeオペランドの指定に従います。

dcclttrexptm=トランザクションブランチ限界経過時間

〜〈符号なし整数〉((0〜65535))（単位：秒）

トランザクションブランチの処理時間の最大値を指定します。CUPからトランザクションを開始する場合にだけ有効です。

指定時間を超えてもトランザクションブランチが完了しないとき，そのトランザクションブランチのプロセスを異常終了させて，ロールバックします。0を指定した場合は，時間監視をしません。

この指定を省略した場合，rapリスナーサービス定義のtrn_expiration_timeオペランドの指定に従います。

なお，RPC機能を使用した場合に，他プロセスで実行するトランザクションブランチの処理時間も監視時間に含むかどうかは，TP1/Client/J環境定義のdcclttrexpspオペランドで指定してください。

dcclttrcputm=トランザクションブランチCPU監視時間

〜〈符号なし整数〉((0〜65535))（単位：秒）

トランザクションブランチが同期点処理までに使用できるCPU時間を指定します。CUPからトランザクションを開始する場合にだけ有効です。

0を指定した場合，CPU時間を監視しません。

指定時間を超えた場合は，そのトランザクションブランチのプロセスを異常終了させ，ロールバックします。

この指定を省略した場合は，rapリスナーサービス定義のtrn_cpu_timeオペランドの指定に従います。

dcclttrexpsp=Y｜N｜F

トランザクションブランチの処理を監視するとき，次の処理時間も監視時間に含むかどうかを指定します。

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

それぞれの指定値について説明します。

Y

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

N

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

F

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

この指定を省略した場合は，rapリスナーサービス定義のtrn_expiration_time_suspendオペランドの指定に従います。

dcsndrcvtype=DCCLT_ONEWAY_SND｜DCCLT_ONEWAY_RCV｜DCCLT_SNDRCV

TCP/IP通信機能の使用時に初期化する環境を指定します。

このオペランドを指定してない場合は，TCP/IP通信機能を使用できません。

DCCLT_ONEWAY_SND

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

DCCLT_ONEWAY_RCV

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

DCCLT_SNDRCV

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

dcrcvport=受信用のCUPのポート番号

〜〈符号なし整数〉((1〜65535))《11000》

MHPから送信されたメッセージを受信するCUPのポート番号を指定します。MHPがメッセージを送信するために使用するポート番号と同じ値を指定してください。同一マシン内で，複数のプロセスまたはスレッドを同時に実行する場合は，それぞれ異なるポート番号を指定してください。

指定できるポート番号でも，OSまたはほかのプログラムで使用するポート番号は指定しないでください。指定した場合，応答データを正しく受信できないことがあります。なお，OSが使用するポート番号は，OSごとに異なります。OSのマニュアルなどを参照してください。

dcsndhost=接続するMHPが存在するノードのホスト名　〜〈文字列〉

CUPからメッセージを送信する場合，コネクションを確立して接続するMHPが存在するノードのホスト名を指定します。

また，ホスト名として，10進ドット記法のIPアドレスを指定することもできます。

dcsndport=接続するMHPのポート番号

〜〈符号なし整数〉((1〜65535))《12000》

CUPからメッセージを送信する場合，コネクションを確立して接続するMHPのポート番号を指定します。dcnamportオペランドに指定するポート番号と重複しないように指定してください。

dcsockopenatrcv=Y｜N　〜《N》

TCP/IP通信機能の使用時に，1コネクションで送受信する場合の，受信用ソケットを開設する契機（送信相手からの接続を待ち受け始める契機）を指定します。

なお，このオペランドの指定を省略した場合は，rpcOpenメソッド実行時に受信用ソケットを開設します。

Y

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

N

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

dcweburl=サービス要求先のTP1/WebのURL　〜〈パス名〉

サービス要求先のTP1/WebのURLを指定します。

プロトコル，WWWサーバ，プロンプターのCGI名称，TP1/Webのサービス名などの情報をURL形式で指定します。

dchostオペランドとdcweburlオペランドの両方を指定した場合は，dcweburlオペランドの指定が有効になります。

また，TP1/Web接続機能を使用する場合は，dcscddirectオペランドおよびdcnamuseオペランドを使用できません。dcweburlオペランドを定義して，かつdcscddirect=Yおよびdcnamuse=Yの場合は，定義エラーとなります。

dccltdbgtrcfilecount=デバッグトレースファイルの最大ファイル数

〜〈符号なし整数〉((0〜256))《0》

デバッグトレースファイルの最大ファイル数を指定します。0を指定した場合，ファイル数の制限はなくなります。デバッグトレースファイルの総数が，このオペランドの指定値を超えた場合，更新日時の最も古いファイルが削除されます。

dccltdbgtrcfilecountオペランドで異なる値を指定した複数のTP1Clientインスタンスを同時に使用した場合，実際の最大ファイル数は保証できません。

rpcOpenメソッド未発行の状態でTP1Clientインスタンスを作成した場合，dccltdbgtrcfilecountオペランドは，システムプロパティとしても定義できます。この場合，TP1Clientインスタンスの作成後にrpcOpenメソッドを発行すると，rpcOpenメソッドの内容を解析した結果を上書きして動作します。rpcOpenメソッドを発行するとシステムプロパティに定義されたdccltdbgtrcfilecountオペランドの指定は無効になります。

dccltdbgtrcfilecountオペランドの指定が不正な場合，エラーは通知されません。この場合，dccltdbgtrcfilecountオペランドの指定はデフォルト値が有効になります。

dccltrpcmaxmsgsize=RPC送受信電文の最大長

〜〈符号なし整数〉((1〜8))《1》（単位：メガバイト）

RPCで受け渡しできる電文の最大長を指定します。

rpcCallメソッドで送受信できるRPC電文の最大長は，このオペランドを省略した場合，またはデフォルト値（1）を指定した場合は，1メガバイト（1048576バイト）です。このオペランドに指定できる最大値（8）を指定した場合は，8メガバイト（8388608バイト）です。このオペランドの指定よりも大きいサイズの送信メッセージ長および受信メッセージ長を，rpcCallメソッドの引数に指定することはできません。送信メッセージ長または受信メッセージ長がこのオペランドの指定値よりも大きい場合，rpcCallメソッドはErrInvalidArgsExceptionを返します。

dccltrpcmaxmsgsizeオペランドを指定した場合，次の機能は使用しないでください。通信先のTP1/Serverノードでエラーが発生します。

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

システム共通定義のrpc_max_message_sizeオペランドをサポートしているTP1/Server（バージョン06-02以降）以外のTP1/Serverにサービス要求した場合の動作については次の表を参照してください。

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

メソッド	RPCの種類を指定する定義	窓口となるTP1/Serverのバージョン	ノードのバージョン※1
			06-02より前の場合	06-02以降の場合※2
rpcCall	dcrapdirect=Y	06-02より前	×※3	×※3
		06-02以降	×※4	○
	dcnamuse=Y	06-02より前	×※4	○
		06-02以降	×※4	○

（凡例）

○：要求できます。

×：要求できません。

注※1

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

注※2

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

注※3

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

注※4

ErrNoSuchServiceGroupExceptionが発生します。

dcscdhostchange=Y｜N　〜《N》

TP1/Client/J環境定義のdchostオペランドに指定したサービス要求先スケジューラをRPCごとに分散させるかどうかを指定します。

Y

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

N

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

Yを指定した場合の処理を説明します。

RPCでのサービス要求が1度目の場合，TP1/Client/J環境定義にdchostselect=Yを指定したときは，TP1/Client/J環境定義のdchostオペランドに指定したサービス要求先スケジューラがランダムに選択されます。TP1/Client/J環境定義にdchostselect=Nを指定したときは，TP1/Client/J環境定義のdchostオペランドの先頭に指定したサービス要求先スケジューラが選択されます。

RPCでのサービス要求が2度目以降の場合，前回のサービス要求先スケジューラからdchostオペランドで指定した順にラウンドロビン方式でサービス要求先スケジューラが選択されます。

dccltloadbalance=Y｜N　〜《N》

ネームサーバから得た複数のサービス要求先スケジューラの情報から，負荷レベルが最も低いサービス要求先スケジューラの情報をキャッシュに格納するかどうかを指定します。

Y

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

N

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

Yを指定した場合の処理を説明します。

キャッシュに格納されたサービス要求先スケジューラが複数ある場合，最初のサービス要求先スケジューラは，ランダムに選択されます。RPCでのサービス要求が2度目以降の場合，キャッシュに格納されたサービス要求先スケジューラが，ラウンドロビン方式で選択されます。

負荷レベルの詳細については，マニュアル「OpenTP1 解説」を参照してください。

dccltcachetim=キャッシュの有効期限

〜〈符号なし整数〉((0〜65535))《30》（単位：秒）

サービス要求先スケジューラの情報をキャッシュに格納した時点からの，キャッシュの有効期限を指定します。キャッシュの有効期限を満了したサービス要求先スケジューラの情報は，キャッシュから削除されます。その後，サービス要求先スケジューラの情報を再度取得して，その情報をキャッシュに格納することで，キャッシュを更新します。

このオペランドは，TP1/Client/J環境定義にdccltloadbalance=Yを指定したときだけ有効です。

dccltconnecttimeout=コネクション確立最大監視時間

〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

データ送信時のコネクション確立処理に対する最大監視時間を指定します。

このオペランドで指定する値は，java.net.Socket.connectメソッド（以降「connectメソッド」と呼びます）の処理時間ではなく，connectメソッドで実行されるコネクションの確立処理に掛かる最大監視時間です。

相手システムが起動していないなどの要因でコネクションを確立できない場合，このオペランドで指定した監視時間が経過する前にCUPから発行したメソッドがエラーリターンすることがあります。これは，このオペランドで指定した最大監視時間よりも，OSによるコネクション確立処理の監視時間が優先されるためです。OSによるコネクション確立処理の監視時間，コネクション確立要求の再送回数および再送処理の間隔は，プラットフォームによって異なります。また，使用するメソッドや機能によっては，connectメソッドの処理時間がこのオペランドで指定した値よりも大きくなる場合があります。

0を指定した場合，またはこのオペランドの指定を省略した場合は，OSがコネクションの確立処理を監視します。

dccltprftrace=Y｜N　〜《Y》

TP1/Client/Jをサービスプラットフォーム上で動作させた場合に，サービスプラットフォームの性能解析トレースを取得するかどうかを指定します。

Y

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

N

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

dccltprfinfosend=Y｜N　〜《Y》

TP1/Serverに対して，ネームサービスを使用したRPC，およびスケジューラダイレクト機能を使用したRPCを行う場合に，OpenTP1の性能検証用トレースに出力する情報としてTP1/Client/J内部で識別情報（IPアドレスなど）を付加するかどうかを指定します。

Y

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

N

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

dccltnammlthost=Y｜N　〜《N》

マルチホームドホスト形態のTP1/Serverに対してネームサービスを使用したRPCを行うかどうかを指定します。

Y

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

N

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

詳細については，「●マルチホームドホスト形態のTP1/Serverに対してRPCを行う場合の定義」を参照してください。

dccltdatacomp=Y｜N　〜《N》

データ圧縮機能を使用するかどうかを指定します。

Y

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

N

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

dccltconnectinf=端末識別情報

端末識別情報として，DCCM3論理端末の論理端末名称をEBCDIKコードで指定します。端末識別情報は，先頭に0xを付け，0xの後ろに128文字までの16進数表記で指定します。先頭の0xは128文字に含まれません。2文字で1バイトの値として，64バイト（128文字）まで指定できます。ただし，DCCM3側では先頭8バイト目までに指定した値だけが有効になり，9バイト目以降に指定した値は無視されます。

このオペランドに指定した値は，setConnectInformationメソッドを呼び出すことで，動的に変更できます。このオペランドに指定した値は，setConnectInformationメソッドを呼び出したあと，再びrpcOpenメソッドを呼び出すまで無視されます。

このオペランドに指定した値は，TP1/Client/J環境定義のdchostオペランドにDCCM3論理端末のホスト名を，dchostオペランドまたはdcrapportオペランドにDCCM3論理端末のポート番号を指定し，次のどちらかの方法でDCCM3論理端末との常設コネクションを確立した場合に有効となります。

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

このオペランドの指定を省略した場合，DCCM3論理端末に端末識別情報は通知されません。ただし，setConnectInformationメソッドを呼び出した場合は，setConnectInformationメソッドに指定した端末識別情報が，DCCM3論理端末との常設コネクション確立時にDCCM3論理端末に通知されます。

dcscdmulti=Y｜N　〜《N》

マルチスケジューラ機能を使用するかどうかを指定します。

Y

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

N

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

マルチスケジューラ機能を使用すると，複数起動されたマルチスケジューラデーモンの中から，1つをランダムに選択することで，スケジューリングの負荷を軽減できます。

この定義にYを指定した場合，TP1/Client/J環境定義dchost，dcscdport，dcscdmulticountも併せて参照してください。また，この定義は，rpcCallToメソッド実行時は無効です。

dcscdmulticount=マルチスケジューラデーモンのプロセス数　〜〈符号なし整数〉((1〜4096))《1》

マルチスケジューラデーモンのプロセス数を指定します。スケジュールサービス定義scdmultiの-mオプションに指定したプロセス数か，またはそれ以下の値を指定します。

この定義は，TP1/Client/J環境定義にdcscdmulti=Yおよびdcscddirect=Yを指定した場合に有効です。なお，この場合，ポート番号は，次に示す範囲の値からランダムに選択されます。

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

このポート番号の最大値が65535を超える場合は，定義解析でErrFatalException，およびsetDchostでErrInvalidPortExceptionが発生します。

scdmultiの-mオプションに指定したプロセス数よりも大きい値を指定した場合，マルチスケジューラが起動していないポートに接続を試み，ErrNetDownAtClientExceptionが発生する場合があります。

dccltcupsndhost=送信元ホスト　〜〈文字列〉

次に示すコネクション確立要求時の，送信元ホストを指定します。

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

ホスト名として，10進ドット記法のIPアドレスを指定することもできます。

なお，次の場合は，発行したメソッドで例外が発生します。

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

この定義を省略すると，送信元ホストは任意に割り当てられます。

dccltcuprcvport=CUPの受信で使用するポート番号　〜〈符号なし整数〉((5001〜65535))

サーバからのメッセージを受信するCUPのポート番号を指定します。

この定義で指定したポート番号は，次の機能を使用する場合に有効となります。

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

この定義を省略すると，システムが任意に割り当てたポート番号を使用します。

同一マシン内で，複数のプロセス，または複数のスレッドを同時に実行する場合は，それぞれ異なるポート番号を指定してください。

指定できるポート番号でも，OSまたはほかのプログラムで使用するポート番号は指定しないでください。指定した場合，応答データを正しく受信できないことがあります。なお，OSが使用するポート番号は，OSごとに異なります。OSのマニュアルなどを参照してください。

dcclttrcmplmttm=トランザクション完了限界時間　〜〈符号なし整数〉((0〜65535))（単位：秒）

rapサーバで代理実行するトランザクションブランチの，開始から終了までの最大実行時間を指定します。この指定時間を超えた場合，rapサーバのプロセスが異常終了したあとに，トランザクションブランチが回復プロセスでコミット，またはロールバックのどちらかに決着して終了します。

0を指定した場合は，トランザクションブランチの最大実行時間を監視しません。

この指定を省略した場合は，rapリスナーサービス定義のtrn_completion_limit_timeオペランドの指定に従います。

この機能をバージョン07-01以前のTP1/Serverに対して使用した場合，機能が無効の状態で動作します。

(c)　TP1/Client/J環境定義を指定するときの注意事項

• TP1/Client/J環境定義のオペランドを記述した行に，設定値以外の文字を記述しないでください。設定値以外の文字を記述した場合，rpcOpenメソッドがErrFatalExceptionを返す場合があります。
• TP1/Client/Jは，TP1/Client/J環境定義のオペランドで始まる行（行頭の空白およびタブは無視されます）を定義解析対象とします。TP1/Client/J環境定義のオペランド以外の文字列が指定された行は，すべてコメント行と見なされます。