VTAM internal trace

Under normal circumstances, the VTAM® internal trace is run at the request of IBM® service personnel. A great deal of information is available from these VTAM internal trace entries.

The VTAM internal trace (VIT) can be run internally to VTAM or externally to GTF. When VTAM is started the default is to have the trace running internal to two 4 KB pages with no options. When the trace is running internally, the only method of getting the trace records is to dump VTAM. The trace can then be viewed in the unformatted dump, or it can be formatted by using the VTAMMAP options in IPCS. Beside not having to dump VTAM, an additional advantage to running the VTAM internal trace to GTF is that GTF timestamps each entry. A VTAM internal trace run internally has no timestamps.

GTF must be started before the VTAM internal trace is started. Use the following commands to stop the VTAM internal trace running internally and to start it running to GTF.

F VTAMDDF,NOTRACE,TYPE=VTAM,OPTION=END
(F          is the z/OS modify command
 VTAMDDF    is the name of the VTAM startup procedure
 NOTRACE    indicates that the trace is being turned off
 TYPE=VTAM  indicates that this command affects the VTAM
             internal trace
 OPTION=END stops the VIT and frees the pages in storage.
 F VTAMDDF,TRACE,TYPE=VTAM,MODE=EXT
 TRACE      indicates that the trace is being turned on
         MODE=EXT   causes the VIT records to be sent to GTF.)

After the trace is running externally, the trace can be started with the options that you require:

F VTAMDDF,TRACE,TYPE=VTAM,OPTION=(APPC,PIU,API,MSG)
 OPTION=xxx indicates which record types are to be traced.

After the event is traced, you can stop the VTAM internal trace with the following command:

F VTAMDDF,NOTRACE,TYPE=VTAM,OPTION=ALL
(OPTION=ALL requests the VIT remain active, but trace
         nothing
 OPTION=END stops the VIT.)

Then, stop GTF so that the trace data can be formatted.