RECTRACE command with TRACE subcommand

This section describes the RECTRACE command with the TRACE subcommand.

Usage

Use the TRACE subcommand to produce traces with an entry for every IFCID available.

Usage notes

  • Up to five traces can be requested in a job step.

Syntax of the TRACE subcommand

Read syntax diagramSkip visual syntax diagramTRACEFROM/TO blockLEVEL(SHORTSUMMARYLONGDUMP)SORTBY(TIMESTAMPLUWID)DDNAME(RTTRCDD*ddname)INCLUDE/EXCLUDE block

Subcommand options

The syntax diagram shows the options that are available with this subcommand. See Subcommand options for comprehensive descriptions of these options. The following list gives additional or specific descriptions of selected options, where appropriate.

FROM/TO
Limits the range of records included in the trace by date and time.

For details, see FROM/TO subcommand options.

LEVEL
Selects the amount of detail in the trace. You can specify one of the following keywords:
SUMMARY
Produces a trace that lists all user-selected records in the input data set.
SHORT
Produces a trace that includes all user-selected records that are used in other OMEGAMON for Db2 PE reports. This is the default.
LONG
Produces a trace that includes all user-selected records. Serviceability data is also reported.
DUMP
Produces a trace that presents all user-selected records in hexadecimal dump format. The entire record is dumped. This option is used for diagnostic purposes.
SORTBY
Sorts the events within each location. You can specify either of the following:
LUWID
Records are sorted by timestamp within thread within location.
TIMESTAMP
Records are sorted by timestamp within location. TIMESTAMP is the default.

One entry of SORTBY can be specified for each TRACE subcommand.

DDNAME
Specifies the data set where the trace is written.
INCLUDE/EXCLUDE
Includes or excludes data associated with specific OMEGAMON for Db2 PE identifiers.

For details, see INCLUDE and EXCLUDE subcommand options, which lists other identifiers allowed with this command and subcommand combination, and OMEGAMON for Db2 PE identifiers.