RDC - Configure the Natural Data Collector

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:

RDC Parameter Syntax
NTRDC Macro Syntax
Keyword Subparameters
Examples of RDC Parameter
Example of NTRDC Macro

RDC Parameter Syntax

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.

NTRDC Macro Syntax

The NTRDC macro is specified as follows:

         NTRDC ON,                                                     *
               EVENT=value,                                            *
               EXIT=value,                                             *
               FNAT=value,                                             *
               SIZE=value,                                             *
               XEVENT=value

Or:

         NTRDC OFF

See Keyword Subparameters.

For a description of the values ON and OFF, see RDC Parameter Syntax.

Keyword Subparameters

EVENT | EXIT | FNAT | SIZE | XEVENT

EVENT - Natural Data Collector Events to be Recorded

EVENT=(value) determines the Natural Data Collector events to be recorded in the Natural Data Collector buffer.

Value Explanation

Value	Explanation
`(event,event,...)`	Each `event` can be a one- or two-letter event type. Only the specified events are recorded. Notes: For information on possible event types, see Data-Collecting Events in the SYSRDC Utility documentation. When only one value is specified, the enclosing brackets can be omitted. If only one letter is specified but there are more events beginning with this letter, then all these events are recorded. For example, `EVENT=P` means that the events `PL`, `PS` and `PT` are recorded; that is, the definition is equivalent to `EVENT=(PL,PS,PT)`.
`ALL`	All events are recorded, provided that the Natural Data Collector buffer was defined properly. This is the default value.

(event,event,...)

Each event can be a one- or two-letter event type. Only the specified events are recorded.

Notes:

For information on possible event types, see Data-Collecting Events in the SYSRDC Utility documentation.
When only one value is specified, the enclosing brackets can be omitted.
If only one letter is specified but there are more events beginning with this letter, then all these events are recorded. For example, EVENT=P means that the events PL, PS and PT are recorded; that is, the definition is equivalent to EVENT=(PL,PS,PT).

ALL

All events are recorded, provided that the Natural Data Collector buffer was defined properly.

This is the default value.

Notes:

This definition can be replaced within the Profiler utility or by using CALL 'CMRDC' 'T' in any Natural program.
For further information, see Profiler Utility and Calling the CMRDC Interface in the SYSRDC Utility documentation.

EXIT - Define Natural Data Collector User Exits

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

Value	Explanation
`(name,name,...)` or `(name,size,name,size,...)`	`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: `400 - 32760`. The default size value is `400`.

(name,name,...)

(name,size,name,size,...)

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: 400 - 32760.

The default size value is 400.

Notes:

If linked, the exit gets control from the Natural Data Collector at certain points within Natural. Specific session information is passed to the exits.
If the subparameter EXIT is specified dynamically, the exits must be defined in the profile parameter CSTATIC or RCA (RCA can also be specified dynamically).
As an alternative to this keyword subparameter, you can use the equivalent Natural profile parameter RDCEXIT.
For details, refer to User Exits for External Monitoring/Accounting in the SYSRDC Utility documentation.

FNAT - Trace Recording in the Natural System File

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 - Size of the Natural Data Collector Buffer

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). To activate the Natural Data Collector (without trace recording), you specify `SIZE=2`. To also activate the trace recording, set `SIZE` to a value greater than `2`. The Profiler utility needs a buffer size greater than 2 to activate the trace recording. If the requested space is not available, the Natural Data Collector cannot be used.
`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 - Natural Data Collector Events to Call User Exits

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

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: For information on possible event types, see Data-Collecting Events in the SYSRDC Utility documentation. When only one value is specified, the enclosing brackets can be omitted. If only one letter is specified but there are more events beginning with this letter, then all these events are recorded. For example, `XEVENT=P` means that the events `PL`, `PS` and `PT` are recorded; that is, the definition is equivalent to `XEVENT=(PL,PS,PT)`.
`ALL`	All user exits are called for all events. This is the default value.

(event,event,...)

Each event can be a one- or two-letter event type. User exits are called for the specified events only.

Notes:

For information on possible event types, see Data-Collecting Events in the SYSRDC Utility documentation.
When only one value is specified, the enclosing brackets can be omitted.
If only one letter is specified but there are more events beginning with this letter, then all these events are recorded. For example, XEVENT=P means that the events PL, PS and PT are recorded; that is, the definition is equivalent to XEVENT=(PL,PS,PT).

ALL

All user exits are called for all events.

This is the default value.

Examples of RDC Parameter

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))

Example of NTRDC Macro

         NTRDC ON,                                                     *
               EVENT=(D,P,U),                                          *
               XEVENT=(P,I,A),                                         *
               SIZE=80,                                                *
               FNAT=ON,                                                *
               EXIT=(MYEXIT,2000,RDCEX1)