このプロファイルパラメータは、Natural セッションをプロファイルするために使用します。プロファイリングデータは、NaturalONE で Natural Profiler を使用して解析できるリソースファイルに書き込まれます。詳細については、『NaturalONE』ドキュメントを参照してください。

可能な設定	「PROFILER パラメータの構文」を参照してください。
デフォルト設定	なし	「PROFILER パラメータの構文」のサブパラメータのデフォルト設定を参照してください。
ダイナミックな指定	○
セッション内の指定	×

---

PROFILER パラメータの構文

PROFILER パラメータは次のように指定します。

PROFILER={(subparameter=value[,subparameter=value]...)}

上記の意味は次に示すとおりです。

サブパラメータ	Value	説明
ACTIVE		ACTIVE=value はプロファイリングインフラストラクチャがアクティブになるかどうかを決定します。 デフォルト値：OFF
	ON	プロファイリングインフラがアクティブで、イベントがリソースファイルに書き込まれます。
	OFF	プロファイリングインフラストラクチャは非アクティブです。
EVENT		EVENT=value はリソースファイルに生成されるイベントのタイプを指定します。 次の構文が適用されます。 event|(event[,event]...) プレースホルダの意味は以下のとおりです。event は、イベントのタイプ（event-type）またはイベントのタイプのグループ（event-group）のいずれかです。 デフォルト値：すべてのイベントタイプが処理されます。
	event-type： SI|ST|PL|PS| PT|PR|DA|DB|IA| IB|CA|CB|NS|E|U	event-type は次のいずれかになります。 SI セッション初期化イベント ST セッション終了イベント PL プログラムロードイベント PS プログラム開始イベント PT プログラム終了イベント PR プログラム再開イベント DA データベースコールイベントの後 DB データベースコールイベントの前 IA 端末 I/O イベントの後 IB 端末 I/O イベントの前 CA 外部プログラム呼び出しイベントの後 CB 外部プログラム呼び出しイベントの前 NS Natural ステートメントイベント E ランタイムエラーイベント U ユーザー定義イベント 重要: Natural ステートメントイベント（NS）は、対応する Natural オブジェクトが GPGEN=(PROFILER=ON) でコンパイルされた場合にのみ生成されます（GPGEN プロファイルパラメータを参照）。 注意: 上記のイベントに加えて、Natural Profiler は、データ収集が一時停止されたときに、モニタ一時停止イベント（MP）を収集します。一時停止の時間は、アプリケーションパフォーマンス解析では考慮されません。
	event-group： S|P|D|I|C|N	event-group は次のいずれかになります。 S セッションイベントグループ（SI、ST） P プログラムイベントグループ（PL、PSPT、PR） D データベースコールイベントグループ（DB、DA） I 端末 I/O イベントグループ（IB、IA） C 外部プログラム呼び出しイベントグループ（CB、CA） N Natural イベントグループ（NS）
EVENTTRACE		EVENTTRACE=value は個々のイベントがリソースファイルに書き込まれるかどうかを決定します。 デフォルト値：OFF
	ON	個々のイベントがリソースファイルに書き込まれます。NaturalONE Event Trace ページで記録されたイベントを調べることができます。 生成されたリソースファイルには拡張子 .nprf（Natural Profiler リソースファイル）があります。 注意: 結果ファイルは、特にステートメントイベントが記録された場合、非常に大きくなる可能性があります。
	OFF	個々のイベントはリソースファイルに書き込まれません。ファイルには、統合ホットスポット情報のみが記録されます。これにより、通常、ファイルが大幅に小さくなり、処理が速くなります。 生成されたリソースファイルには拡張子 .nprc（統合された Natural Profiler リソース）があります。
INTERVAL	1|2|4|5|8|10| 16|20|25|40|50| 80|100|125|200| 250|400|500|625| 1000|1250|2000| 2500|5000|10000	INTERVAL=value は SAMPLING がアクティブな場合に使用する CPU 時間（マイクロ秒単位）を指定します。 サンプリングを使用すると、各サンプリング間隔の最後のイベントのみが記録されます。例外：セッションイベント（イベントタイプ SI および ST）は常に記録されます。 サンプリング間隔を長くすると、記録されるイベントが少なくなり、リソースファイルが小さくなります。ただし、サンプリング間隔を長くすると、精度の低い値になります。 デフォルト値：100
RESLIB	1～8 文字	RESLIB=value はリソースファイルを含む FUSER システムライブラリの名前を指定します。 デフォルト値：SYSTEM
RESNAME	1～253 文字	RESNAME=value は、データが書き込まれるリソースファイルの名前（パスおよび拡張子なし）を指定します。 デフォルト値：現在の ID とタイムスタンプを含んでいるファイル名が自動的に生成されます。
SAMPLING		SAMPLING=value はサンプリングをアクティブにするかどうかを決定します。 サンプリングメソッドでは、統計的アプローチを使用してデータを収集します。サンプリングでは、リソースファイルに書き込まれるデータの量が大幅に削減される一方で、サンプリングしない場合とほぼ同じ CPU 時間が保持されます。 注意: サンプリングにより、消費された CPU 時間が推定されます。サンプリングを使用した場合、経過時間やヒット数など、他の値は信頼できません。 サンプリングの詳細については、『Natural for Mainframes』ドキュメントの「Natural プロファイルユーティリティ - バッチモード」セクションにある「サンプリング」を参照してください。 デフォルト値：OFF
	ON	サンプリングがアクティブになります。
	OFF	サンプリングが非アクティブになります。 これは、Natural パラメータファイル内のこのサブパラメータのデフォルト設定です。

PROFILER パラメータの例

例 1すべてのイベントを含むプロファイル

PROFILER=(ACTIVE=ON,EVENTTRACE=ON,EVENT=(S,P,D,N,I,C,E,U))

個々のイベントはすべて記録されます。

例 2プログラムロードイベントのあるプロファイル

PROFILER=(ACTIVE=ON,EVENT=PL,RESNAME=MYAPP,RESLIB=MYLIB)

すべてのプログラムロードイベント（PL）は、ライブラリ MYLIB 内のリソースファイル MYAPP に書き込まれます。

例 3：サンプリングによるプロファイル

PROFILER=(ACTIVE=ON,EVENT=(P,NS),SAMPLING=ON,INTERVAL=1000)

イベントグループ P とイベント NS のすべてのプログラムは、サンプリング間隔 1000 マイクロ秒で記録されます。

例 4サンプリングと非サンプリングの比較

Natural アプリケーションは 2 回プロファイルされます。最初の実行、サンプリングなし：

PROFILER=(ACTIVE=ON)

Natural Profiler は、240,086 個のイベントを生成し、呼び出されたサブプログラムの CPU 消費量として 30.2% を表示します。

2 回目の実行では、サンプリングを使用して同じアプリケーションがプロファイルされます。

PROFILER=(ACTIVE=ON,SAMPLING=ON,INTERVAL=100)

Natural Profiler は、4,100 個のイベントのみを生成するようになり、同じサブプログラムの CPU 消費量として 30.1% を表示します。