This Natural profile parameter can be used to configure the Natural
Data Collector and its trace recording function, which is used by the
SYSRDC utility and the
Profiler utility.
It corresponds to the NTRDC
macro
in the Natural parameter module.
Possible settings | See RDC Parameter Syntax. | |
---|---|---|
Default setting | OFF |
See RDC Parameter Syntax and Keyword Subparameters. |
Dynamic specification | yes | The parameter RDC can be specified
dynamically only. In the
Natural
parameter module, use the macro
NTRDC .
|
Specification within session | yes | See
Calling the
CMRDC Interface to start or stop the trace recording and
to select the events (see also the keyword subparameter
EVENT ).
|
The following topics are covered below:
The RDC
parameter is specified as
follows:
RDC=(ON,keyword-subparameter=value,keyword-subparameter=value,...) |
Or:
RDC=OFF |
Where:
Value | Explanation |
---|---|
ON |
The trace recording is started automatically during Natural session start. |
OFF |
The user must start trace recording by
one of the means described in
Activating the Natural Data
Collector in the SYSRDC Utility
documentation or in the Profiler Utility documentation.
This is the default value. |
keyword-subparameter |
See Keyword Subparameters. |
Note:
If specified, ON
or OFF
must be the
first value.
The NTRDC
macro is specified as follows:
NTRDC ON, * EVENT=value, * EXIT=value, * FNAT=value, * SIZE=value, * XEVENT=value
Or:
NTRDC OFF
For a description of the values ON
and
OFF
, see RDC
Parameter Syntax.
EVENT
|
EXIT
|
FNAT
|
SIZE
|
XEVENT
EVENT=(value)
determines
the Natural Data Collector events to be recorded in the Natural Data Collector
buffer.
Value | Explanation |
---|---|
(event,event,...) |
Each
event can be a one- or two-letter event
type. Only the specified events are recorded.
Notes:
|
ALL |
All events are recorded, provided that
the Natural Data Collector buffer was defined properly.
This is the default value. |
Notes:
CALL 'CMRDC' 'T'
in any Natural program.
EXIT=(value)
is used to
define user exits for the Natural Data Collector of the
SYSRDC utility and,
optionally, a work area size for each user exit.
Value | Explanation |
---|---|
(name,name,...)
or
|
name is the
name of the user exit.
There is no default. |
Optionally, the
size of the exit work area can be specified after
the exit name.
Possible size values: The default size value is |
Notes:
EXIT
is specified
dynamically, the exits must be defined in the profile parameter
CSTATIC
or
RCA
(RCA
can also be specified dynamically).
RDCEXIT
.
FNAT=value
controls the
trace recording while Natural system file programs are executing.
Value | Explanation |
---|---|
ON |
Trace recording when running in the Natural system file. |
OFF |
No trace recording in the Natural
system file.
This is the default value. |
SIZE=value
specifies the
size of the Natural Data Collector buffer, which is used by the
SYSRDC utility and the
Profiler utility,
and it controls the trace recording function of the Natural Data Collector.
Value | Explanation |
---|---|
0 or 2 -
128 |
Buffer size (in KB).
|
0 |
Deactivates the Natural Data Collector.
This is the default value. |
Note:
As an alternative to this keyword subparameter, you can use the
equivalent Natural profile parameter RDCSIZE
.
XEVENT=(value)
determines
the Natural Data Collector events for which user exits are called. This can
help to reduce the CPU consumption and the number of TCB/SRB switches if a
Natural for zIIP
add-on product is installed.
Value | Explanation |
---|---|
(event,event,...) |
Each
event can be a one- or two-letter event
type. User exits are called for the specified events only.
Notes:
|
ALL |
All user exits are called for all
events.
This is the default value. |
RDC=(ON,EVENT=(D,P,U),XEVENT=(P,I,A),SIZE=80,FNAT=ON)
RDC=(ON,EVENT=(PS),SIZE=80,FNAT=ON,EXIT=(MYEXIT,2000,RDCEX1))
NTRDC ON, * EVENT=(D,P,U), * XEVENT=(P,I,A), * SIZE=80, * FNAT=ON, * EXIT=(MYEXIT,2000,RDCEX1)