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.