7  Program TRAP : Trace Analysis Program


7.1 Introduction

The recording data entered into the archive file by the program SIMO ( see also program SIMO- Introduction : Archive file ) is in binary format and therefore not suitable for analysis. TRAP translates this binary data into formatted plaintext (see below menu command <Format>), and stores it in the TRAP-file ( ( *.TRP ).

When starting the program, TRAP displays in a small window down on the right the number of data records that have been found in the archive file and the number of the records that have matched the (pre-) trigger conditions (see program FIPP - Introduction ).

After pressing any key, the menu is activated and the archive information is displayed.

7.1.1 Archive information

The archive information displays the content of the current archive file divided up into channels. The information includes the total number of all data records, the number of occurred errors, the number of passed records referring to set filters, enabled channels and  the postfilter and -trigger settings as well as the fullfilled trigger conditions. Additionally name and position of the archive file, period of time of the recording and the current protocol type to each channel  are displayed. 

If a commentary was entered in the program SiIMO via the command arc, it is displayed as window title. 

archive name of the archive file. 
from / till time or period of time for the record
passed records total number of records read from the file
trigger-conditions number of found correspondences with the (post-) trigger conditions
protocol type protocol assignment of the channel
counted number of records on this channel
error number of transmission errors that occurred on this channel
passed number of correct records on this channel that have been read out of the archive file
Chn/Flt und Chn/Trg Filter- and trigger-configuration of the channel  ( see also program SIMO introdution: Status)

The analysis of the archive file can be influenced with regard to its representation (see below menu item <Format>) or with regard to its contents (see below menu item <Filter>).

7.2 Key assignment

[F1] Help on the current item
[Alt]-[X] Quit programm TRAP 

7.3 Menu commands

7.3.1 File

Under this menu item you can view the content of directories and quit temporarily the program.

7.3.1.1 Directory

Gives an overview of the available files in a directory. The display can be specified with the usual DOS-wildcards. If you want to view another directory than the current one, you can also put a path in front of the DOS wildcards

7.3.1.2 OS-Shell

With this function you can quit the program TRAP temporarily. Enter EXIT into the command line in order to return again.

 

7.3.2 Show

Allows viewing the translated archive file. In order to make it possible for SHOW to read this file, the archive file must be translated previously into a plaintext file ( TRP-file ) via <Run | Disk>.

It is possible to scroll in the received data up and down, find passages or print out particular pages on a printer.

As file name all usual path names can be declared. Is no valid file-name declared, one at the hard disk existing text-file can be selected via the displayed pickbox. In the file name you can use the DOS-usual wildcards (?,*). The directory of the current operation field is displayed as pickbox if no particular path is declared. Via <parent> you can switch to the next higher directory or branch into a subdirectory by selecting a displayed catalogue. If no file information is done '*.TRP' is taken as default. 

Via this menu item the program SHOW is activated without stopping the proceeding program TRAP. All previous settings are saved.

 

7.3.3 Run

With this function the archive file can be translated into a plaintext file (TRP-file). The translated file can be displayed to different media <screen>,< hard disk> or <printer>.

7.3.3.1 Screen

The loaded archive file is translated into plaintext and displayed to screen. However, it is not possible to scroll through the file in any direction. The direct screen output should therefore be replaced by the translation onto hard disk (menu item <Run | Disk> ) and by the following - more comfortable - output with SHOW ( menu item <Show> ).

7.3.3.2 Harddisk

The loaded archive file is translated into text-file and saved on the hard disk as TRP-file ( *.TRP ) in the current directory.

The menu item <Show> enables viewing the archive file.

If you enter a DOS-wildcard ('*') in connection with the corresponding extension ( default: '.TRP '),  the TRP-files of the current directory ( TRP ) are displayed.

With the  arrow  keys you  can select a certain  file and load  it with the Enter key.

If you want to view or select a  different  directory than the current one, you can also put a path in front of the file name.

7.3.3.3 Printer

The loaded archive file is translated into plaintext and output to printer.

 

7.3.4 Format

Here you can set the format of the translated output under <Run>. To which channel the format settings should refer must be set beforehand with <Comport>. The menu command <Format> is connected with the menu item of the same name in the application SIMO, i.e. the settings are always valid for both programs.

The following format options are available 

StatusHeader A status line with time of receipt is put in front of each telegram.
Hexadecimal Telegram display additionally hexadecimal.
Decimal Telegram display additionally decimal.
ASCII Telegram display additionally as ASCII characters.

 

Binary Telegram display additionally binary format.
LSB
MSB
binary display of received data ( LSB first )
binary display of received data ( MSB first )

 

Error Display of occurred errors in the following format:

HEX
DEZ
LSB
MSB

ASCII

Display of errors hexadecimal 
Display of errors decimal 
Display of errors binary  ( LSB first )
Display of errors binary  ( MSB first )
Display of errors as ASCII characters

 

Plaintext    

Display of the received data in protocol-specific format. You can distinguish between format 1-3. Only for protocols with long messages (e.g.IEC protocols.

Format 1

Display of the complete message (Header + Information ).

Format 2

Display of header only.

Format 3

Display of information only.

The various options are switched on or off by means of the Enter key.

7.3.5 Filter

With it you can define post-filters and -triggers in order to limit the analysis or translation of the coded archive file to certain received data. 

This function calls the program FIPP with the option postfilter / -trigger setting.

 

7.3.6 Options

7.3.6.1 Archive information

Displays the content of the current archive file divided up into channels; the information includes the total number of data records, the number of occured errors, the number of analysed records, the settings of the post-filters and triggers and the number of found correspondences with the trigger conditions. Additionally name and position of the archive file, period of time of the recording and the current protocol type to each channel  are displayed. 

If a commentary was entered in the program SiIMO via the command arc, it is displayed as window title. 

7.3.6.2 Notebook

The notebook is a small editor with which you can make notes of the current session. The file size is fixed at 200 lines and 76 columns. Lines cannot be added or removed. With [F10] you exit the editor and store your input on hard disk in an ASCII file with extension .pin. The notebook can be called in all program parts (in SIMO in the main menu, elsewhere under menu item <Options | Notebook>).

 

7.3.7 Quit program TRAP
Quit programm TRAP. The <Format> settings are maintained.. 

 


MAYR Software

Wuerzburger Ring 39,  D 91056 Erlangen

Manual LIAN DOS


LIAN DOS Protocol Simulator and Analyzer
© Copyright 1991, 1996, 2001, 2006-2010 by Werner Mayr. All Rights reserved.