This profile parameter is used to profile a Natural session. The profiling data is written to a resource file you can analyze with the Natural Profiler in NaturalONE. For more information, see the NaturalONE documentation.
Possible settings | See PROFILER Parameter Syntax. | |
---|---|---|
Default setting | none | See the default settings of the subparameters in PROFILER Parameter Syntax. |
Dynamic specification | yes | |
Specification within session | no |
The PROFILER
parameter is specified as
follows:
PROFILER= {( subparameter= value[, subparameter= value]...) }
|
Important:
Blank spaces are not allowed in the syntax. Use commas to
separate the syntax elements.
Where:
Subparameter | Value | Explanation | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ACTIVE |
ACTIVE=value determines
whether the profiling infrastructure is activated.
Default: |
||||||||||||||||||||||||||||||
ON |
The profiling infrastructure is activated and events are written to the resource file. | ||||||||||||||||||||||||||||||
OFF |
The profiling infrastructure is deactivated. | ||||||||||||||||||||||||||||||
EVENT |
EVENT=value specifies
the types of events to be generated into the resource file.
The following syntax applies: event|(event[,event]...) where: Default: All event types are processed. |
||||||||||||||||||||||||||||||
event-type :
|
event-type is one of the
following:
Important: Note: |
||||||||||||||||||||||||||||||
event-group :
|
event-group is one of
the following:
|
||||||||||||||||||||||||||||||
EVENTTRACE |
EVENTTRACE=value
determines whether individual events are written to the resource file.
Default: |
||||||||||||||||||||||||||||||
ON |
Individual events are written to the
resource file. You can examine the recorded events in the NaturalONE
Event Trace page.
The generated resource file has the extension
Caution: |
||||||||||||||||||||||||||||||
OFF |
Individual events are not written to the
resource file. Only consolidated hot-spot information is recorded in the file.
This typically results in a much smaller file that is consequently much quicker
to process.
The generated resource file has the extension
|
||||||||||||||||||||||||||||||
INTERVAL |
1|2|4|5|8|10|
|
INTERVAL=value specifies
the CPU time interval (in microseconds) to be used if
SAMPLING is
active.
With sampling, only the last event of each sampling
interval is recorded. Exception: Session events (event types Larger sampling intervals result in fewer events recorded and thus smaller resource files. However, larger sampling intervals also result in less accurate values. Default: |
|||||||||||||||||||||||||||||
RESLIB |
1 – 8 characters | RESLIB=value specifies
the name of the FUSER system library that contains the resource file.
Default: |
|||||||||||||||||||||||||||||
RESNAME |
1 – 253 characters | RESNAME=value specifies
the name of the resource file (without path and extension) into which the data
is written.
Default: A file name is automatically generated containing the current user ID and timestamp. |
|||||||||||||||||||||||||||||
SAMPLING |
SAMPLING=value determines whether
sampling is activated.
The sampling method uses a statistical approach to collect data. Sampling significantly reduces the amount of data written to the resource file while approximately retaining the same CPU times as without sampling. Caution: For details on sampling, see the Sampling in the Natural Profiler Utility - Batch Mode section of the Natural for Mainframes documentation. Default: |
||||||||||||||||||||||||||||||
ON |
Sampling is activated. | ||||||||||||||||||||||||||||||
OFF |
Sampling is deactivated.
This is the default setting for this subparameter in the Natural parameter file. |
PROFILER=(ACTIVE=ON,EVENTTRACE=ON,EVENT=(S,P,D,N,I,C,E,U))
All individual events are recorded.
PROFILER=(ACTIVE=ON,EVENT=PL,RESNAME=MYAPP,RESLIB=MYLIB)
All program load events (PL
) are written to the
resource file MYAPP
in the library MYLIB
.
PROFILER=(ACTIVE=ON,EVENT=(P,NS),SAMPLING=ON,INTERVAL=1000)
All programs of the event group P
and the event
NS
are recorded using sampling with a sampling interval of 1000
microseconds.
A Natural application is profiled twice. In a first run, without sampling:
PROFILER=(ACTIVE=ON)
The Natural Profiler generates 240,086 events and shows a CPU consumption of 30.2 percent for a called subprogram.
In the second run, the same application is profiled with sampling:
PROFILER=(ACTIVE=ON,SAMPLING=ON,INTERVAL=100)
The Natural Profiler now generates only 4,100 events and shows a CPU consumption of 30.1 percent for the same subprogram.