In order to analyze a GuiXT problem, it may be necessary to generate a "GuiXT system trace" for Synactive. This trace contains the complete information necessary to duplicate the problem; without the trace this can be difficult since the screen layout and application steps depend on the SAP release, application configuration and application data.

You proceed as follows: Activate the trace, perform the application steps that lead to the error, deactivate the trace, save and email the trace file, preferably as .zip file if it is more than one or two megabyte of data.

If you use a guixt.ini file, please read these instructions (end of this page).
1 Activate the Trace Option Choose Edit->Profile in the GuiXT window or click on

Click on the "On" button in the "System Trace" box

You may enter a trace output filename here, e.g. C:\temp\guixt.trace.txt. The trace will then be written into this file. If you leave the field blank, the trace is generated temporarily and you need to save it later on via Tools->Download trace, see below.

Click on the "OK" button in the Profile window.
2 Produce the error Perform the SAP transaction in which your GuiXT script does not work correctly
3 Save the trace file

Necessary if you did not specify a trace output file.

 Click on Tools->Download Trace File

You then get a popup message
4 Send us the trace file via email Attach the file to your email and send it to support@synactive.com
5 Deactivate the trace

Click on the "Off" button in the "System Trace" box

Click on the "OK" button in the Profile window.
Resetting the trace

Click on the "Reset Trace" if you want to reset the file because of some mistakes during the recording. You can now start your recording again.

 
Generating the system trace if you use a guixt.ini file
 

If you use a guixt.ini file for the GuiXT profile parameters, you cannot apply the instructions below that refer to the registry profile settings. Moreover, the GuiXT window might be hidden due to the guixt.ini parameter "StartHidden".

It is possible to parameterize the system trace within the guixt.ini file using the options  "Trace" and "TraceFile". But often you do not want to change the guixt.ini file, since it is stored in a central location and you do not want to activate the trace for all users. In addition, setting up the trace in guixt.ini means that all steps, starting with the login and ending with the logout, will be traced.

For these reasons we suggest you use the following Windows console commands that allow you to switch the trace on and off dynamically.

Activating the system trace  Enter the following Windows console command:

guixt.exe  -traceon  file=C:\temp\guixttrace.txt

You can replace C:\temp\guixttrace.txt with an appropriate filename
Deactivating the system trace Enter the following Windows console command:

guixt.exe  -traceoff