Generalized trace facility (GTF)
The generalized trace facility (GTF) in z/OS® allows users to write records to a trace file. These traces can then be formatted into a more easily read form.
GTF can be started by issuing the following command:
S GTFDDF.GTF
(S is the z/OS Start command
GTFDDF is the name of the GTF procedure
GTF is the name of this job. Use this name
when you want to stop GTF.)
GTF must be initialized with the USR option when you run the Db2 traces, the VTAM® buffer, or the VTAM internal trace. The USR option allows VTAM or Db2 to write user (USR) to the GTF file. When you use the VTAM IO trace, RNIO should be included among the GTF options. The RNIO parameter includes all VTAM network activity in the trace. The output data set for the GTF trace (the default is called SYS1.TRACE) must be large enough to avoid wrapping the traces. If the GTF trace data is on DASD and fills up, it wraps around to the beginning and the initial trace data is lost. In particular, the VTAM internal trace can create many records.
After the traces finish running, the GTF job should be stopped. After the traces are completed, the GTF job should be stopped, by using the z/OS STOP command, which closes the data set holding the user records. The records can then be formatted.