TXTRACE.EXE Utility

About TXTRACE.EXE

This trace file contains entries depicting the input file, output file, and translation object files that are used by the Sterling Gentran:Server® Translator. The trace file also contains entries that show each attempt of the translator to match an input block of data (such as record, segment, XML tag, and pcdata) to a map object. The trace file is typically used by Sterling Gentran:Server support to determine whether the Translator is correctly matching data from the input file to the map objects defined in the source map and translation object.

TXTRACE.EXE is included on the installation DVD in the \i386\utils folder. Copy the TXTRACE.EXE program to your \GENSRVNT\bin folder to make this utility available for use.

Interaction with GNTXEng.EXE

GNTXEng.EXE is a Sterling Gentran:Server COM component that is responsible for the translation of inbound data. The GNTXEng.EXE program uses the same registry key that TX32.EXE (the Sterling Gentran:Server translator) uses to determine if a trace file should be created.

When TXTRACE.EXE is used to set the registry key defining the trace path and filename, the GNTXEng.EXE program modifies that filename by inserting .GNTX after the filename and before the file extension. GNTXEng.EXE then writes the trace information to that file.

If you define a trace file path and name as c:\GENSRVNT\mytrace.txt, TX32.EXE creates the file and writes to it. Then, GNTXEng.EXE creates a file named c:\GENSRVNT\mytrace.gntx.txt and writes information to this trace file in XML (eXtensible Markup Language) format.

GNTXEng.EXE does not use the *.IPC files that TX32.EXE uses, so the information that used to be written to the *.IPC file is now passed through the interface when GNTXEng.EXE is invoked by COMMPOST.EXE. Since this information is not accessible to the end user (and support), it is now written to the trace file (when tracing is activated).