cprfstartPRFデーモンの開始

形式

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

機能

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通信基盤TP1 Connector,
TP1/Client/J
6けた目TP1/Message Queue - AccessReliable Messaging
7けた目OTS(なし)
8けた目CTM(なし)
インデックス21けた目HCSCサーバ標準出力/標準エラー出力/ユーザログ
2けた目DIService Coordinator Interactive Workflow
3けた目HCSCサーバ(Object Accessアダプタ)HCSCサーバ(ファイルアダプタ)
4けた目HCSCサーバ(Message Queueアダプタ)JPA
5けた目JAX-WSエンジンJPAコンテナ
6けた目CJMSプロバイダ機能TP1インバウンドアダプタ
7けた目HCSCサーバ(FTPアダプタ)JavaMail
8けた目Java VMJSFおよびJSTL
インデックス31けた目バッチアプリケーション実行基盤(なし)
インデックス41けた目CDI(なし)
インデックス91けた目Elastic Application Data store(なし)
PRFトレース取得レベルを指定する場合は,けたごとの上位レイヤ,下位レイヤのPRFトレース取得レベルを「標準」「詳細」「保守」のどのレベルで取得するかを決め,それを16進数で指定します。上位レイヤと下位レイヤのPRFトレース取得レベルの組み合わせと指定値の対応を,次の表に示します。
なお,保守レベルは,障害発生時などの保守情報を取得するためのレベルです。通常は指定しないでください。

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

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

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

インデックス指定例説明
インデックス100000000​インデックス1の各機能レイヤの標準レベルのトレース情報を取得します。
00000004​CTMだけ詳細レベルのトレース情報を取得して,ほかの機能レイヤは標準レベルのトレース情報を取得します。
55555544​インデックス1の各機能レイヤの詳細レベルのトレース情報を取得します。
a5565544​リダイレクタ,WebコンテナおよびRMIの保守情報を取得して,ほかの機能レイヤは詳細レベルのトレース情報を取得します。
インデックス200000000​インデックス2の各機能レイヤの標準レベルのトレース情報を取得します。
40000000​HCSCサーバだけ詳細レベルのトレース情報を取得します。
 
また,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もデフォルト値より小さい値を指定してください。
-PrfNoBackUpオプションに0を指定した場合,正常停止中と前回強制停止後の再起動中に,PRFトレースファイルをバックアップします。PRFトレースファイルサイズの合計値が大きい場合,バックアップ処理でPRFデーモンの起動や停止に時間がかかることがあります。そのため,cprfstartコマンドに-PrfNoBackUp 0を指定する設定でManagement Serverでプロセス監視する場合,デフォルトの監視時間ではタイムアウトが発生する場合があります。タイムアウトが発生した場合には,監視時間を長くしてください。
-PrfTraceBufferSize <PRFトレースバッファサイズ>
共用メモリに確保するバッファサイズを512~102400(単位:キロバイト)の範囲で指定します。このオプションには,-PrfTraceFileSizeで指定した値よりも大きい値は指定できません。省略した場合は,8192が設定されます。
バッファ領域が不足するとKFCT26999-Wメッセージが出力され,PRFトレースが欠落する場合があります。そのため,メッセージが出力されなくなるまでバッファ領域を拡張してください。
-PrfRemakeBuffer
共用メモリを再作成して起動します。再作成できない場合にはエラーとなります。
-PrfNoBackUp [0|1]
PRFデーモンの起動時,および停止時にPRFトレースファイルをバックアップするかを指定します。値に0を指定した場合,PRFトレースファイルをバックアップします。PRFトレースファイルをコピーするため,PRFデーモンの起動,および停止に時間が掛かることがあります。障害発生後,PRFトレースがラップするまでの間にPRFトレースファイルを採取できない場合は,値に0を指定してください。なお,Management Serverを使用している時は,障害発生後にPRFトレースファイルを含むsnapshotログを自動的に収集します。
値に1を指定した場合,PRFトレースファイルをバックアップしません。値を指定しなかった場合,値に1を指定したときと同じ動作をします。
PRFトレースファイルをバックアップするタイミング,バックアップの有無,および-PRFNoBackUpオプションの関係は次のようになります。

表4-15 PRFトレースファイルをバックアップするタイミング,バックアップの有無,および-PRFNoBackUpオプションの関係

実行コマンド前回開始したPRFデーモンの終了状態PRFトレースファイルのバックアップ
-PrfNoBackUp 0-PrfNoBackUp 1(デフォルト)
cprfstart正常終了しないしない
強制終了または異常終了するしない
cprfstop終了状態に依存しないするしない
cprfstop -Force終了状態に依存しないしないしない

戻り値

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

注意事項