openUTM offers you comprehensive support when diagnosing and locating errors in the application.
Errors in function calls are reported by openUTM using appropriate return codes and messages. If you wish, you can request a dump in order to analyze the error situation more closely. This request is issued either event-driven or using an administration command or a call in the program. If an error causes an application process or the UTM application to crash, a process-specific dump is automatically generated.
The dump file contains all KDCS and administration calls as well as database calls made by openUTM. On BS2000 systems the dump file also contains calls to the formatting system and database calls made by the program (when using IUTMDB). This makes it easier to localize errors when working with databases, for example.
To analyze the dump file, openUTM provides a special tool (KDCDUMP) which converts the dump file to a printable format. This tool also allows you to evaluate the dump file directly from the terminal, e.g. to search for particular table entries and format these entries. Of course, you can format the entire file, and then print it.
openUTM also offers trace functions for monitoring events. For instance, the trace functions can be used to log all connection-related activities within a UTM application or all activities relating to OSI TP connections in a trace file. To analyze the trace files, you can use the special tools provided by openUTM. The trace functions can be enabled when the application is started using an administration command or via the administration program interface.
The application-specific systemlog file SYSLOG (SYStem LOGging) also contains important diagnostic information, and is created by openUTM when an application is started. The SYSLOG file contains messages, which may be useful for ongoing monitoring or subsequent analyses. You yourself can determine the selection of messages to be logged by assigning the SYSLOG message line to certain messages. UTM tools are available for formatting and analyzing the SYSLOG file.
| A detailed description of the diagnostic options available can be found in the corresponding openUTM manual ”Messages, Debugging and Diagnostics”, which also contains information on the KDCDUMP dump analysis tool and on the tools provided for analyzing the SYSLOG system log file. |
