Troubleshooting preferences
The following troubleshooting preferences can be set by the user. For more information about log and trace settings, see Administering ZIETrans rich client applications.
- Trace settings
- The following ZIETrans runtime traces can be enabled by the user:
- Enable runtime tracing
- Enables tracing for the connections in your application.
- Enable widget tracing
- Enables tracing for widgets in your application.
- Enable action tracing
- Enables tracing for event actions in your application.
- Enable HOD tracing
- Enables Host On-Demand tracing in your application.
- Enable component tracing
- Enables tracing for components in your application.
- Enable util tracing
- Enables tracing for runtime utilities in your application.
- Enable macro tracing
- Traces the playing of macros. Because of its effect on system performance, you should use this trace only for debugging macros.
- Show display terminal
- Select this box to show a view of the host application in the display terminal while the ZIETrans application is running.
- Enable host simulation recording
- Select this box to enable host simulation recording during
runtime. Recording starts the next time the rich client application
starts and ends when the host session is closed, for example when
the user clicks the disconnect item on the transformation view toolbar.
The trace file is saved in the host simulations folder in the rich client environment. For example, in the Eclipse RCP environment on Windows it is saved in, <Eclipse installation directory>\plugins\<ApplicationName_version>\profiles\hostsimulations\.
Trace files are named using the following template, ApplicationName_ConnectionName_Date(yyyymmdd)_Time(hhmmss)_Number, for example, MyApplication_main_20060101_134543_1.
- Trace output tab
- File name
- The name used as a template to generate unique sets of trace files for each runtime environment. The default is trace.txt.
- Maximum file size
- Specifies the maximum file size in KB. The default is 10240.
- Maximum number of files
- Specifies the maximum number of trace files. The default is 5.
- View button
- Click this button to cause the trace files to be opened in the default system editor. All the trace files that match the specified template file name are combined into a single file and then opened. For example, if trace.txt is the template file name, and trace1.txt, trace2.txt, and trace3.txt are present, then they are all combined into a single file, in the correct order, and opened. If no default editor is configured, an error message is displayed.
- Clear button
- Click this button to be prompted whether to clear the current trace file.
- Messages output tab
- File name
- The name used as a template to generate unique sets of log files for each runtime environment. The default is messages.txt.
- Maximum file size
- Specifies the maximum file size in KB. The default is 512.
- Maximum number of files
- Specifies the maximum number of trace files. The default is 2.
- View button
- Click this button to cause the current log file to be opened in the default system editor. All the log files that match the specified template file name are combined into a single file and then opened. For example, if messages.txt is the template file name, and messages1.txt, messages2.txt, and messages3.txt are present, then they are all combined into a single file, in the correct order, and opened. If no default editor is configured, and error message is displayed.
- Clear button
- Click this button to be prompted whether to clear the current log file.
- Simulation output tab
- Maximum number of files
- When the Enable host simulation recording check box is selected, this field specifies the maximum number of simulation output files. The default is 10. If a new simulation file exceeds the maximum setting, the oldest simulation file is deleted.
- Gather button
- Click this button to gather all the artifacts required by IBM Support to diagnose a problem.
In the Gather Problem Determination Information wizard, select the
check box for the application for which you want information gathered
and specify the destination .zip file. The following information is
collected and gathered into the destination .zip file:
- contents of every selected application
- contents of the runtime extension plug-in which includes the trace, log, and runtime.properties files
- the .log file from the current data directory
- Restore Defaults button
- Click this button to cause all settings in the panel to revert to default values.
- Apply button
- Click this button to save the settings in the runtime.properties file in the runtime extension plug-in.