Tracing and Logging 

The NetWeaver Business Client supports both tracing and logging. The respective files are saved in the personal files directory on the computer of the logged on user. If several users are working with one NWBC installed on the same server, files are created for each user so that any problem cases can be traced individually for each user. For a user with the user ID tester the directory would be C:\Documents and Settings\tester\My Documents.

●      Traces are written to file  NWBCClient.trc

●      Logs are written to file NWBCClient.log

A trace file contains information about errors occurring during NWBC runtime. Depending on the trace level set, the trace file also contains additional information that can help developers isolate a specific problem.

In contrast, a log file contains information about the interaction between the NWBC and the application running in the canvas area of the NWBC. This information includes object-based navigation (OBN) and eventing.

If the user does not make any extra settings explicitly, the level written in the trace is ERROR. This means that each error identified is logged together with information about the cause of the error. However, additional information is often required to trace and solve a problem. In these cases the user has to increase the level of the trace or log. The possible levels are defined in file NWBC.ini (or NWBCClient.ini). This file is also located in the personal files directory.

Example

TRACE_LEVEL=ERROR   LOG_LEVEL=ERROR

 

Supported Trace and Log Levels

Level	Description
FATAL	Only errors that cause the program to terminate
ERROR	All errors (default setting)
WARNING	Errors and warnings, whereby warnings are messages that are not necessarily problems
INFO	General Information
DEBUG	Information about internal processes and about debugging
HEX	Data transferred between client and server in the form of a hex dump