cprflevel [-PRFID <PRF識別子>] [ -h ]
          [-PrfChangeLevel <PRFトレース取得レベル>[,[<PRFトレース
          取得レベル>]...]]
          [-PrfLevelIndex <インデックス番号>] [-PrfLevelAll]

PRFトレース取得レベルを表示または変更します。

-PrfChangeLevelオプションを省略した場合は，指定したPRF識別子に指定されているPRFトレース取得レベルを表示します。-PrfChangeLevelオプションを指定した場合は，指定したPRF識別子に指定されているPRFトレース取得レベルを指定値に変更します。

-PrfLevelIndexオプションを指定した場合は，指定したインデックスのPRFトレース取得レベルの一覧が表示されます。-PrfLevelAllオプションを指定した場合は，すべてのインデックスに対応するPRFトレース取得レベルが表示されます。

-PRFID <PRF識別子>

PRFデーモンの識別子を1〜31文字の英数字，またはアンダースコア（_）で指定します。"TSC"や"tsc"，または"CTM"や"ctm"で始まる文字列は指定しないでください。省略した場合は，"PRF_ID"という文字列がPRF識別子となります。

-h

コマンドの使用方法が表示されます。

-PrfChangeLevel <PRFトレース取得レベル> [,[<PRFトレース取得レベル>]...]

PRFトレース取得レベルを4バイトの16進数（8けたの値）で指定します。各インデックス番号に対応するレベル値をコンマ（,）区切りで左から複数指定できます。該当するインデックスのレベル値を変更しない場合は，値を指定しないでください。また，あるインデックス番号以降の値をすべて指定しない場合は，コンマ（,）の記述を省略してください。インデックス番号1のトレース取得レベルを（1），インデックス番号2のPRFトレース取得レベルを（2）とした場合，PRFトレース取得レベルは「（1）,（2）,...」と指定します。

PRFトレース取得レベルの指定例を次に示します。

表4-3　PRFトレース取得レベルの指定例（cprflevelコマンド）

PRFトレース取得レベルの指定例	オプションの指定
インデックス番号1のPRFトレース取得レベルを指定する	-PrfChangeLevel 0x44445555
インデックス番号1とインデックス番号2のPRFトレース取得レベルを指定する	-PrfChangeLevel 0x44445555,0x55554444
インデックス番号2のPRFトレース取得レベルを指定する	-PrfChangeLevel ,0x55554444

各機能レイヤでのPRFトレース取得レベルの割り当てについて説明します。

PRFトレース取得レベルは，インデックスごとに8けたの16進数で指定します。それぞれのけたには，機能レイヤが二つずつ割り当てられています。16進数を2進数にした場合の上位2ビットに割り当てられている機能レイヤを上位レイヤ，下位2ビットに割り当てられている機能レイヤを下位レイヤといいます。

けたごとの上位レイヤ，下位レイヤに割り当てられている機能レイヤについて，次の表に示します。

表4-4　詳細レベルのトレース情報を取得する場合の指定値（cprflevelコマンド）

インデックス	けた番号	上位レイヤ	下位レイヤ
インデックス1	1けた目	リダイレクタ	Webコンテナ
	2けた目	EJBコンテナ	JNDI
	3けた目	JTA	JCAコンテナ
	4けた目	DB Connector	RMI
	5けた目	SOAP通信基盤	uCosminexus TP1 Connector， TP1/Client/J
	6けた目	TP1/Message Queue - Access	Cosminexus RM
	7けた目	OTS	CTM
	8けた目	CTM	CTM
インデックス2	1けた目	HCSCサーバ	標準出力/標準エラー出力/ユーザログ
	2けた目	DI	uCosminexus Service Coordinator Interactive Workflow
	3けた目	uCosminexus Service Adapter for Object Access	uCosminexus Service Adapter for Flat Files
	4けた目	uCosminexus Service Adapter for Message Queue	CCCJPA
	5けた目	JAX-WSエンジン	CCCJPAコンテナ
	6けた目	CosminexusJMSプロバイダ機能	TP1インバウンドアダプタ

PRFトレース取得レベルを指定する場合は，けたごとの上位レイヤ，下位レイヤのPRFトレース取得レベルを「標準」「詳細」「保守」のどのレベルで取得するかを決め，それを16進数で指定します。上位レイヤと下位レイヤのPRFトレース取得レベルの組み合わせと指定値の対応を，次の表に示します。

なお，保守レベルは，障害発生時などの保守情報を取得するためのレベルです。通常は指定しないでください。

表4-5　詳細レベルまたは保守レベルのトレース情報を取得する場合の指定値（cprflevelコマンド）

上位レイヤ	下位レイヤ	指定値
標準	標準	0
標準	詳細	1
標準	保守	2
詳細	標準	4
詳細	詳細	5
詳細	保守	6
保守	標準	8
保守	詳細	9
保守	保守	a

指定例を示します。

表4-6　PRFトレース取得レベルの指定例（cprflevelコマンド）

インデックス	指定例	説明
インデックス1	00000000	インデックス1の各機能レイヤの標準レベルのトレース情報を取得します。
	00000004	CTMだけ詳細レベルのトレース情報を取得して，ほかの機能レイヤは標準レベルのトレース情報を取得します。
	55555544	インデックス1の各機能レイヤの詳細レベルのトレース情報を取得します。
	a5565544	リダイレクタ，WebコンテナおよびRMIの保守情報を取得して，ほかの機能レイヤは詳細レベルのトレース情報を取得します。
インデックス2	00000000	インデックス2の各機能レイヤの標準レベルのトレース情報を取得します。
	40000000	HCSCサーバだけ詳細レベルのトレース情報を取得します。

　

また，RMIについては，抑止レベルを指定できます。

RMIに抑止レベルを指定するには，トレース取得レベルの指定値（インデックス1の4けた目）に次の値を設定してください。

表4-7　RMIの抑止レベルの指定値

上位レイヤ（DB Connector）	下位レイヤ（RMI）	指定値
標準	抑止	3
詳細	抑止	7
保守	抑止	b

-PrfLevelIndex <インデックス番号>

変更または参照するPRFトレース取得レベルのインデックス番号を1〜16の整数で指定します。デフォルト値は1です。この引数と一緒に-PrfChangeLevelを指定した場合は，指定したインデックス番号のPRFトレース取得レベルのレベル値を-PrfChangeLevelで指定した値に変更します。

この引数と一緒に-PrfChangeLevelを指定しなかった場合は，指定したインデックス番号のPRFトレース取得レベルのレベル値が表示されます。この引数と一緒に-PrfChangeLevelを指定する場合は，-PrfChangeLevelには必ず一つの値だけを指定してください。

（例）インデックス番号2番目の値を，0x55554444に変更する場合

cprflevel -PrfChangeLevel 0x55554444 -PrfLevelIndex 2
 

-PrfChangeLevelに複数の値を指定した場合は，オプションエラーとなります。

（例）-PrfChangeLevelに複数の値を指定した場合

cprflevel -PrfChangeLevel ,0x55554444,0x55554444 -PrfLevelIndex 2

-PrfLevelIndexで2を指定しているにもかかわらず，-PrfChangeLevelで複数の値を指定しているためです。なお，-PrfLevelIndexの指定を省略した場合は，1が設定されます。

-PrfLevelAll

すべてのレベル値を表示します。-PrfChangeLevelまたは-PrfLevelIndexと組み合わせた指定はできません。このオプションと-PrfLevelIndexの組み合わせを，次に示します。

表4-8　-PrfLevelAllと-PrfLevelIndexの組み合わせ一覧

cprflevel現在のレベル値の 表示方法		-PrfLevelIndex
		指定	未指定
-PrfLevelAll	指定	オプションエラー	すべてのレベル値を表示
	未指定	指定されたインデックス番号のレベル値だけを表示	インデックス1のレベル値だけを表示

指定できるコマンドオプションの組み合わせの一覧を次に示します。

表4-9　引数（コマンドオプション）の組み合わせ一覧（cprflevelコマンド）

コマンド オプション	-h	-PRFID	-PrfChangeLevel	-PrfLevelIndex	-PrfLevelAll
-h	−	△-h	△-h	△-h	△-h
-PRFID	△-h	−	○	○	○
-PrfChangeLevel	△-h	○	−	○	×
-PrfLevelIndex	△-h	○	○	−	×
-PrfLevelAll	△-h	○	×	×	−

（凡例）

○：同時に指定できます。

△：△のあとに続くオプション名のオプションが有効になります。

×：同時に指定できません。

−：該当しません。

0：

正常終了しました。

1：

PRFデーモンが起動していません。PRFSPOOL環境変数が異なっている，または-PRFIDの値が誤っているおそれがあります。

2：

PRFSPOOL環境変数が設定されていません。

上記以外：

コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと，再度コマンドを実行してください。エラーメッセージは標準エラー出力，ログファイルに出力されます。資料の取得方法については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」を参照してください。

• 入力例1
  

  cprflevel

• 出力例1
  

  KFCT73415-I 2661 1: prf trace level is 0x12345678

• 入力例2
  

  cprflevel -PrfLevelAll

• 出力例2
  

  KFCT73418-I 2661 1: all prf trace levels are:
  [ 1]=0x12345678 [ 2]=0x00000000 [ 3]=0x00000000 [ 4]=0x00000000 
  [ 5]=0x00000000 [ 6]=0x00000000 [ 7]=0x00000000 [ 8]=0x00000000 
  [ 9]=0x00000000 [10]=0x00000000 [11]=0x00000000 [12]=0x00000000 
  [13]=0x00000000 [14]=0x00000000 [15]=0x00000000 [16]=0x00000000 

• 入力例3
  

  cprflevel -PrfLevelIndex 5

• 出力例3
  

  KFCT73419-I 2661 1: prf trace level of [5] is 0x00000000.

• 入力例4
  

  cprflevel -PrfChangeLevel 000000001

• 出力例4
  

  KFCT73416-I 2661 1: prf trace level was changed from 0x00000000 to 0x00000001.

• 入力例5
  

  cprflevel -PrfChangeLevel 0x00000055,0x55554444

• 出力例5
  

  KFCT73420-I 2661 1: prf trace level was changed:
  [ 1]=0x00000000 -> [ 1]=0x00000055
  [ 2]=0x00000000 -> [ 2]=0x55554444

• 入力例6
  

  cprflevel -PrfChangeLevel 0x44445555 -PrfLevelIndex 2

• 出力例6
  

  KFCT73420-I 2661 1: prf trace level was changed:
  [ 2]=0x00000000 -> [ 2]=0x44445555

• 現在のPRFトレース取得レベルを表示する場合，-PrfLevelIndexと-PrfLevelAllの組み合わせで，出力されるメッセージIDは，「KFCT73415-I」，「KFCT73418-I」，「KFCT73419-I」のどれか一つとなっています。PRFトレース取得レベルを表示する場合の出力されるメッセージIDの対応は，次のとおりです。
  

  PRFトレース取得レベルを表示する場合のメッセージID		-PrfLevelAll
  		指定	未指定
  -PrfLevelIndex	指定	−	KAFCT73419-I
  	未指定	KAFCT73418-I	KAFCT73415-I

• PRFトレース取得レベルを変更する場合，-PrfChangeLevelの指定方法で出力されるメッセージIDは，「KFCT73416-I」または「KFCT73420-I」のどちらかになります。次の条件をすべて満たした場合，「KFCT73416-I」が出力されます。それ以外は，「KFCT73420-I」が出力されます。
  
  • -PrfChangeLevel 0x44445555のように値を一つだけ指定し，コンマ（,）を使用していない。
  • -PrfLevelIndexを指定していない。
• このコマンドは，PRFデーモンの起動中に実行してください。PRFデーモンが起動していないときにコマンドを実行した場合，エラーメッセージを出力します。
• 変更するPRFデーモンと同じPRFSPOOL環境変数が設定されている必要があります。
• このコマンドでレベル変更した場合，次のリクエストから変更が有効になります。