BusinessPhone Communication Platform 5.1
Dialogs

## Message Tracing

### General

The message tracing functionality should only be used by experienced technicians. Message Tracing enable the user to watch the BusinessPhone‘s internal system messages globally or selectively filtered.

The standard logout time of 30 minutes will not work while inside any message tracing frame. It is definitely not recommended to run over night traces. Only the last 1000 trace messages will be kept and displayed.

Note

The Message Tracing feature is only available in online mode.

If the Message Tracing dialog is displayed, the logout counter does not work. This means that you have to log off manually from the system. Alternatively, you can close the dialog to start the logout counter again.

If no tracing is performed, the Stop Message Trace button is greyed out.

### Usage

#### The Main Frame

The Main frame includes:

- the name of the system
- the current trace status
- the currently defined set of filters - called trace masks - for message tracing. The set is defined as follows:

- 3 Groups of
- 3 Masks each
- showing an action and a value for that action,

- the trace output, if tracing is activated, or a message that it is not.
- the start button.

Clicking on Start Message Trace will switch to The Mask Input Screen.

#### The Mask Input Screen

This screen is automatically displayed when the Start Message Trace -Button has been pressed. In fact, the mask input content is inserted into to main frame, so for an explanation of the contents of the lower screen halve please read this before a trace can be started, a decision about using filters has to be made.

To define a trace mask at least the 1st Group has to be activated. This will enable the input fields for the 3 masks associated with the given group. It has to be noted that the groups have to be activated incremental, i.e. having already activated the 1st and 2nd group the deactivation of the 1st group will also deactivate all higher groups. Also all definitions a group might already contain will be lost when the said group is deactivated. Having no group activated will clear all masks.

Activating a group enables 3 pairs of mask input fields. Each pair consists of a drop down chooser and an input field. Choose the type of mask needed and enter an appropriate value in hexadecimal notation (0xab or ab). Any value can be entered, there is no checking done at this point. Combinations of type and value have to be valid for the system used on, but this is the user‘s responsibility. If the mask is rejected by the BusinessPhone it will be cleared and the trace will run without filtering.

If the volatile check box is checked, default is unchecked, the trace masks will be cleared after the trace is stopped.

There are two possibilities to start message tracing. Clicking Send New Mask & Start will set the defined masks (or clear all masks if none are set) and start a message trace run, while Start with Current Settings will leave mask settings unchanged (i.e. those that are shown in the table below these buttons) and start the trace.

#### The trace display

If a trace is running the last 1000 message traces will be automatically displayed, as well as the currently active masks.

Since this screen is basically the same as The Main Frame it also shows

- the name of the system
- the current trace status
- The currently defined set of trace masks
- the trace output
- instead of the start button, a button to stop the trace as well as the possibility to prepare the output for printing (or saving).

If Prepare Printable is clicked a new browser window will be created containing an ASCII-printable which can be saved or printed from the browsers file menu.

The trace can be stopped by clicking Stop Message Trace. The display will show the last (at maximum of 1000) trace messages until another frame is selected or the Clear & Refresh button is clicked, this will return to The Main Frame. If volatile masks where used, all mask setting in the BusinessPhone will be cleared.

Revision: B © Ericsson Enterprise 2003