10  Program SHOW


10.1 Introduction

SHOW is a program for viewing text files. Apart from the usual functions of so-called viewers, SHOW allows protocol files to be viewed (see program SIMO - Introduction: Protocol file) filtered according to certain criteria (see below menu item <Display | Selection>)

10.2 Command line parameter

Apart from the keys already mentioned above (see 5.2) for colour representation, screen access mode and country-specific text output, you can also enter the file name of the file to be loaded at any place. For this you do not need a prefixed switch: 

e.g.  c:\>show -e -d -c test.pro

10.3 Assignment of keys

10.3.1 Hotkeys

[Alt]-[M] Switch on and off marking mode
[Ctrl]-[Arrow down] Continue searching
[Ctrl]-[Arrow up] Go to term last found.
[F3] Load file
[F10] Activate menu
[Alt]-[X] Quit program

10.3.2 Marking

[Alt]-[M] Marking
[Alt]-[Arrow down] Mark one line down
[Alt]-[Arrow up] Mark one line up
[Arrow down] Move Cursor down
[Arrow up] Move Cursor up

10.3.3 Search

[Ctrl]-[Arrow down] Continue searching
[Ctrl]-[Arrow up] Go to term found last

10.3.4 Scroll screen

[Ctrl]-[Pos 1] left margin
[Ctrl]-[Ende] right margin
[Home] Beginning of file
[End] File end
[PgUp] Page up
[PgDn] Page down
[Arrow down]

down

[Arrow up] up
[Arrow left] to the left 
[Arrow right] to the right

10.3.5 Entry mask

[Arrow right] Cursor to the right or next field
[Arrow left] Cursor to the left or previous field
[Arrow up] Field above
[Arrow down] Field below
[Tab] next field
[Tab]-[Shift] previous field
[Esc] Cancel entry
[Enter] Confirm entry and carry out function

10.4 Menu commands

10.4.1 File

Under this menu item you can <load> files, display <file information> and <quit> the program temporarily.

10.4.1.1 Load

Under this menu item you can load files.

If you enter a DOS-wildcard ('*') in connection with a certain extension (default: '.*') instead of a file name, the file of the current directory is displayed together with the selected extension. 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 write a path in front of the file name.

10.4.1.2 Info

Displays the file name, date and time of the last file change and the size of the loaded file in bytes.

10.4.1.3 OS Shell

Jumps to the DOS-command line without quitting the program. With the command 'EXIT' you can return to the program.

 

10.4.2 Search
Searches the loaded file for a term determined by <find>. The search for this term can be continued with <repeat>. The direction and exactness of the search can be set under <options>.

10.4.2.1 Find

Under this menu item you can enter the term to be searched for; it can be up to 30 characters long.

10.4.2.2 Repeat

Searches the next fitting term <forward>) or the one last found. <backwards>.

10.4.2.2.1 Repeat backwards

The key combination [Ctrl]-[Arrow up] corresponds to this menu item. This function is actually not a search function, but only serves for displaying again correspondences that have already been found. (compare <search | repeat | forward>)

10.4.2.2.2 Repeat forwards

The key combination [Ctrl]-[Arrow down] corresponds to this menu item. 

The positions of the terms found are recorded in a history stack, which can hold up to 500 positions. If this number is exceeded, the first entry is replaced, so that always the last 500 entries are available.

This stack is needed by the function <search | repeat | backwards>.

10.4.2.3 Options

By pressing the Enter key you can toggle between the indicated search options.

<search whole text <-> search from page>

<note spelling <-> ignore spelling>

If you leave the window via [ESC], the settings are saved.

10.4.2.5.1 Search whole text <-> Search from page

If the first option is activated the whole loaded file is searched regardless of the position indicated on screen. Otherwise the file is searched from the first character displayed on the screen. 

10.4.2.5.2 Note spelling <-> Ignore spelling

Case-sensitive search (for example "A" doesn't match "a").

 

10.4.3 Display

If you have loaded a <protocol file>, you can represent it filtered. You can give the filter conditions under the menu item <selection>. SHOW creates a special file for the selection, which is deleted when you quit the program. The selection cannot be saved. If a further selection is to follow after a completed one it can be carried out directly under <selection> without first having to recreate the original file.

10.4.3.1 All

Displays the loaded file completely. The selection carried out previously is then lost!

10.4.3.2 Selection

The loaded <protocol file> can be filtered according to the following characteristics (objects).

Channel

determines whether the respective channel is to be included in the selection (y).

Header

determines whether the lines of the respective channel identified by '-H'  are to be included in the selection. (compare <protocol file>)

Previous

determines whether the lines of the respective channel identified by '-P'  are to be included in the selection. (compare <protocol file>)

Error

determines whether the lines of the respective channel identified by '-E' and the apportioning of the respective channel started by them  are to be included in the selection. (compare <protocol file>)

Next

determines whether the lines of the respective channel identified by '-N'  are to be included in the selection. (compare <protocol file>)

Sync error

determines whether the lines of the respective channel identified by '-S'  are to be included in the selection. (compare <protocol file>)

Time

determines whether the time recorded in the headlines is to be taken into account in the selection ('y'). The time is linked with an AND-operator to the other filter conditions ('H', 'P', 'E', 'N' and 'S').

The fields following this line can only be reached, if this field has been marked with 'y'.

Time (from)

Here you can enter the time (hh/mm/ss) according to which the filtering is to take place. The time is linked with an AND- operator to the other filter conditions ('H', 'P', 'E', 'N' and 'S').If the following field (interval) has been marked with 'y', the time entered here represents the beginning of the time interval.

Intervall

If this field is marked with 'y', you can define a time interval as filter condition; then the left time field represents the beginning (time from) and the right time field the end (time to).

Time to

indicates the end of the time interval to which the selection within the respective channel is to be limited.

If single characteristics or combinations could not be found, the user is not informed about this. There is only a report if no correspondence could be found between filter and file.

 

10.4.4 Print

Facilitates the output of the loaded file to the printer.

In order to guarantee an undisturbed operation, it is necessary, to alter AUTOEXEC.BAT as follows:

              MODE  LPT1:  ,  , E    

10.4.4.1 Whole text

This option is always available if there has been no selection (menu item <display | selection>). Then the complete file is printed.

10.4.4.2 Selection

This option replaces <print | whole text> if a selection has been carried out under the menu item <display | selection>. Then the filtered file is printed.

10.4.4.3 Marking

SHOW allows the possibility to output only certain part of the loaded file to  printer. In order to mark an area, you have to switch to marking mode with the key combination [Alt]-[M]. The cursor which now appears can be moved up and down by means of the arrow keys; by simultaneously pressing the [Alt] key you can mark. The marking disappears as soon as the [Alt] key is released and one of the arrow keys is pressed. If the marking is to be preserved, you have to leave the marking mode again with [Alt]-[M]. It disappears again only when you mark again.

10.4.4.4 Connection

If the printer is not connected to LPT1 you can select a different connection by means of this function. At the present time , however , only printers at the parallel interface (LPT1 and LPT2) are supported.

10.4.4.5 Format

The standard-output format is 58 (lines) x 80 characters (columns). The settings for the spacing on the left and right, top and bottom must be set directly at the printer.

 

10.4.5 Quit program SHOW

 


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.