TN3270 Server Manual

TN3270 Server Manual—424097-001

9-1

Trace Formatter

The section describes the Guardian TN3270 Server trace formatter. The trace formatter

prints the results of traces captured by the trace facility.

To start the trace formatter, enter the following command at a TACL prompt.

isv

is the installation volume-subvolume.

tacl-opts

IN trace-file

is the name of the trace file to be printed. It must be the name of an existing disk

file or the name of a currently executing Guardian TN3270 Server process. If it

is a disk file, the file must not be in use. If it is a process name, the formatter

must be run on the same CPU as the process being traced.

OUT list-file

is a spooler, printer, or a terminal.

[ objname ]

is an optional parameter. If specified, only trace records relevant to that object are

printed.

Each trace record has the format shown next. Part 1 contains information about an

I/O operation. Part 2 contains additional information for messages read from

$RECEIVE. Part 3 contains the contents of the buffer, shown in hexadecimal, ASCII,

and EBCDIC.

(Part 1 - information about an I/O operation)

(1) (2) (3) (4) (5) (6)

timestamp code-address operation [file-number file-name | thread-name]

(7) (8) (9)

[COUNT=count][error-text (error)][TAG=io-tag]

RUN isv.fmttrace / tacl-opts / [ objname ]

Note. When capturing the trace, EMS and SPI trace records truncated by specifying RECSIZE

are dumped in hexadecimal notation instead of interpreted.