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)