cprfstartPRFデーモンの開始

形式

cprfstart [-h] [-PRFID <PRF識別子>]
         [-PrfTraceLevel <PRFトレース取得レベル> [,[<PRFトレース
         取得レベル>]...]]
         [-PrfTraceCount <PRFトレースファイル数>]
         [-PrfTraceFileSize <PRFトレースファイルサイズ>]
         [-PrfTraceBufferSize <PRFトレースバッファサイズ>]
         [-PrfRemakeBuffer]

機能

PRFデーモン(cprfd)を起動します。なお,PRFデーモンは,ほかのプロセスよりも先に起動してください。

PRFデーモンは開始後にカレントディレクトリを移動します。移動先は,次のディレクトリです。

引数

-h
コマンドの使用方法が表示されます。
-PRFID <PRF識別子>
PRFデーモンの識別子を1~31文字の英数字,またはアンダースコア(_)で指定します。"TSC"や"tsc",または"CTM"や"ctm"で始まる文字列は指定しないでください。省略した場合は,"PRF_ID"という文字列がPRF識別子となります。
-PrfTraceLevel <PRFトレース取得レベル> [,[<PRFトレース取得レベル>]...]
-PrfTraceLevelを省略した場合は標準レベルで情報が出力されます。
PRFトレース取得レベルを4バイトの16進数(8けたの値)で指定します。ここで4バイトの16進数の先頭に0xを付けることができますが,0xは無視されます。
各インデックス番号のレベル値をコンマ(,)区切りで左から複数指定できます。レベル値の指定を省略する場合は,値を記述しないでください。また,あるインデックス番号以降の値をすべて指定しない場合は,コンマ(,)の記述を省略してください。インデックス番号1のトレース取得レベルを(1),インデックス番号2のPRFトレース取得レベルを(2)とした場合,PRFトレース取得レベルは「(1),(2),...」と指定します。
PRFトレース取得レベルの指定例を次に示します。

表4-10 PRFトレース取得レベルの指定例(cprfstartコマンド)

PRFトレース取得レベルの指定例オプションの指定
インデックス番号1のPRFトレース取得レベルを指定する-PrfTraceLevel 0x44445555
インデックス番号1とインデックス番号2のPRFトレース取得レベルを指定する-PrfTraceLevel 0x44445555,0x55554444
インデックス番号2のPRFトレース取得レベルを指定する-PrfTraceLevel ,0x55554444
各機能レイヤでのPRFトレース取得レベルの割り当てについて説明します。
PRFトレース取得レベルは,インデックスごとに8けたの16進数で指定します。それぞれのけたには,機能レイヤが二つずつ割り当てられています。16進数を2進数にした場合の上位2ビットに割り当てられている機能レイヤを上位レイヤ,下位2ビットに割り当てられている機能レイヤを下位レイヤといいます。
けたごとの上位レイヤ,下位レイヤに割り当てられている機能レイヤについて,次の表に示します。

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

インデックスけた番号上位レイヤ下位レイヤ
インデックス11けた目リダイレクタWebコンテナ
2けた目EJBコンテナJNDI
3けた目JTAJCAコンテナ
4けた目DB ConnectorRMI
5けた目SOAP通信基盤uCosminexus TP1 Connector,
TP1/Client/J
6けた目TP1/Message Queue - AccessCosminexus RM
7けた目OTSCTM
8けた目CTMCTM
インデックス21けた目HCSCサーバ標準出力/標準エラー出力/ユーザログ
2けた目DIuCosminexus Service Coordinator Interactive Workflow
3けた目uCosminexus Service Adapter for Object AccessuCosminexus Service Adapter for Flat Files
4けた目uCosminexus Service Adapter for Message QueueCCCJPA
5けた目JAX-WSエンジンCCCJPAコンテナ
6けた目CosminexusJMSプロバイダ機能TP1インバウンドアダプタ
7けた目uCosminexus Service AdapterJavaMail
PRFトレース取得レベルを指定する場合は,けたごとの上位レイヤ,下位レイヤのPRFトレース取得レベルを「標準」「詳細」「保守」のどのレベルで取得するかを決め,それを16進数で指定します。上位レイヤと下位レイヤのPRFトレース取得レベルの組み合わせと指定値の対応を,次の表に示します。
なお,保守レベルは,障害発生時などの保守情報を取得するためのレベルです。通常は指定しないでください。

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

上位レイヤ下位レイヤ指定値
標準標準0
標準詳細1
標準保守2
詳細標準4
詳細詳細5
詳細保守6
保守標準8
保守詳細9
保守保守a
指定例を示します。

表4-13 PRFトレース取得レベルの指定例(cprfstartコマンド)

インデックス指定例説明
インデックス100000000インデックス1の各機能レイヤの標準レベルのトレース情報を取得します。
00000004CTMだけ詳細レベルのトレース情報を取得して,ほかの機能レイヤは標準レベルのトレース情報を取得します。
55555544インデックス1の各機能レイヤの詳細レベルのトレース情報を取得します。
a5565544リダイレクタ,WebコンテナおよびRMIの保守情報を取得して,ほかの機能レイヤは詳細レベルのトレース情報を取得します。
インデックス200000000インデックス2の各機能レイヤの標準レベルのトレース情報を取得します。
40000000HCSCサーバだけ詳細レベルのトレース情報を取得します。
 
また,RMIについては,抑止レベルを指定できます。
RMIに抑止レベルを指定するには,トレース取得レベルの指定値(インデックス1の4けた目)に次の値を設定してください。

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

上位レイヤ(DB Connector)下位レイヤ(RMI)指定値
標準抑止3
詳細抑止7
保守抑止b
-PrfTraceCount <PRFトレースファイル数>
PRFトレースファイルの面数を3~256の範囲で指定します。省略した場合は,4が設定されます。
正常停止中と前回強制停止後の再起動中に,PRFトレースファイルをバックアップします。PRFトレースファイルサイズの合計値が大きい場合,バックアップ処理でPRFデーモンの起動や停止に時間が掛かることがあります。そのため,Management Serverでプロセス監視する場合,デフォルトの監視時間ではタイムアウトが発生する場合があります。タイムアウトが発生した場合には,監視時間を長くしてください。
-PrfTraceFileSize <PRFトレースファイルサイズ>
PRFトレースファイルの1ファイル当たりの最大容量を1024~1048576(単位:キロバイト)の範囲で指定します。ファイル容量を1メガバイトとする場合,1024と指定します。実際のファイルサイズは,この値より多少の増減があります。増減の中で増分の幅は,最大で「-PrfTraceBufferSize指定値-32キロバイト」です。省略した場合は,8192が設定されます。
デフォルト値の8192より小さい値を指定する場合は,-PrfTraceBufferSizeもデフォルト値より小さい値を指定してください。
正常停止中と前回強制停止後の再起動中に,PRFトレースファイルをバックアップします。PRFトレースファイルサイズの合計値が大きい場合,バックアップ処理でPRFデーモンの起動や停止に時間がかかることがあります。そのため,Management Serverでプロセス監視する場合,デフォルトの監視時間ではタイムアウトが発生する場合があります。タイムアウトが発生した場合には,監視時間を長くしてください。
-PrfTraceBufferSize <PRFトレースバッファサイズ>
共用メモリに確保するバッファサイズを512~102400(単位:キロバイト)の範囲で指定します。このオプションには,-PrfTraceFileSizeで指定した値よりも大きい値は指定できません。省略した場合は,8192が設定されます。
バッファ領域が不足するとKFCT26999-Wメッセージが出力され,PRFトレースが欠落する場合があります。そのため,メッセージが出力されなくなるまでバッファ領域を拡張してください。
-PrfRemakeBuffer
共用メモリを再作成して起動します。再作成できない場合にはエラーとなります。

戻り値

0:
PRFデーモンが正常に起動しました。
1:
PRFデーモンの起動に失敗しました。PRFSPOOL環境変数が設定されていません。
上記以外:
コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと,再度コマンドを実行してください。エラーメッセージは標準エラー出力,ログファイルに出力されます。資料の取得方法については,マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守/移行/互換編」の「2.4.3 取得方法および調査方法との対応」を参照してください。

注意事項