Cosminexus V9 アプリケーションサーバ リファレンス コマンド編

[目次][索引][前へ][次へ]

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コマンド)

インデックス けた番号 上位レイヤ 下位レイヤ
インデックス1 1けた目 リダイレクタ Webコンテナ
2けた目 EJBコンテナ JNDI
3けた目 JTA JCAコンテナ
4けた目 DB Connector RMI
5けた目 SOAP通信基盤 TP1 Connector,
TP1/Client/J
6けた目 TP1/Message Queue - Access Reliable Messaging
7けた目 OTS (なし)
8けた目 CTM (なし)
インデックス2 1けた目 HCSCサーバ 標準出力/標準エラー出力/ユーザログ
2けた目 DI Service 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 VM JSFおよびJSTL
インデックス3 1けた目 バッチアプリケーション実行基盤 (なし)
インデックス4 1けた目 CDI (なし)
インデックス9 1けた目 Elastic Application Data store (なし)
PRFトレース取得レベルを指定する場合は,けたごとの上位レイヤ,下位レイヤのPRFトレース取得レベルを「標準」「詳細」「保守」のどのレベルで取得するかを決め,それを16進数で指定します。上位レイヤと下位レイヤのPRFトレース取得レベルの組み合わせと指定値の対応を,次の表に示します。
なお,保守レベルは,障害発生時などの保守情報を取得するためのレベルです。通常は指定しないでください。

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

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

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

インデックス 指定例 説明
インデックス1 00000000 インデックス1の各機能レイヤの標準レベルのトレース情報を取得します。
00000004 CTMだけ詳細レベルのトレース情報を取得して,ほかの機能レイヤは標準レベルのトレース情報を取得します。
55555544 インデックス1の各機能レイヤの詳細レベルのトレース情報を取得します。
a5565544 リダイレクタ,WebコンテナおよびRMIの保守情報を取得して,ほかの機能レイヤは詳細レベルのトレース情報を取得します。
インデックス2 00000000 インデックス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 取得方法および調査方法との対応」を参照してください。

注意事項