TRACEDEST—Set trace destination

When the TRACE command is used, this command identifies or sets the destinations of CDC Replication trace information.

Trace information can be directed to the IBM® Generalized Trace Facility (GTF) or a SPOOL data set.

CAUTION:
Tracing of CDC Replication tasks should only be performed when requested by IBM Technical Support.

Syntax

Read syntax diagramSkip visual syntax diagramFMODIFYprocname.identifier,TRACEDEST=BOTHGTFSYSOUT
GTF
Identifies the destinations where CDC Replication trace information is placed. This option directs trace information to the IBM Generalized Trace Facility (GTF).
When CDC Replication tracing information is directed to GTF, log records are stamped with a GTF user event identifier (EID) of 300. For GTF to accept CDC Replication tracing information, the GTF TRACE and USR parameters must be set in the following manner:
  • TRACE = USRP
  • USR = (300)

GTF can be configured and activated before running the TRACE command. If GTF is not active when the command is invoked, a message is issued to indicate that gathering of data on trace events begins when GTF is started. For more information about GTF, consult the appropriate IBM publication.

SYSOUT
Identifies the destinations where CDC Replication trace information is placed.

This option directs trace information to a SPOOL data set.

Note: Tracing can produce a substantial amount of output very quickly. When directing trace information to SYSOUT, ensure that enough SPOOL space is available to contain the trace information.
BOTH
Identifies the destinations where CDC Replication trace information is placed.

This option directs trace information to both GTF and a SPOOL data set.

If this setting is omitted, the current destinations where trace information is being placed is identified (GTF, SYSOUT, or BOTH).

Note: The syntactical requirements for the z/OS® START and MODIFY commands and explanations of the procname and identifier elements can be found in the IBM console commands manual that contains information about operator commands.

This command can be issued on source environments and target environments.

Examples

MODIFY CHCAS,TRACEDEST

Identifies the current destinations where CDC Replication trace information is being placed. GTF, SYSOUT, or BOTH is returned by this command.

MODIFY CHCAS,TRACEDEST=GTF

Directs CDC Replication trace information to the IBM Generalized Trace Facility (GTF).

F CHCAS,TRACEDEST=BOTH

Directs CDC Replication trace information to the IBM Generalized Trace Facility (GTF) and a SPOOL data set.