═══ 1. About the MTrace ═══

MTrace - Trace Browser 

It's a simple Trace Browser for the TRACE macros at Visual Age C++.

The program opens the \\QUEUES\\PRINTF32 queue, then it reads all inputs in a 
second thread and inserts them to a listbox.

Featurelist:

1.  Filter threads from input.

2.  Stop/Resume input.

3.  Reset the listbox.

4.  Autoreset started by line number 0.

License Agreement 
Trademarks 


═══ 2. Installing ═══

Installation 

No installation required ! 
Just start it.


═══ 3. Using the MTrace ═══

Using the Trace Browser 

You can start a program, that puts the trace output in a queue with the 
following Cmd file.

1.  Start the MTrace.exe

2.  Set environment for traced program or create a Cmd File.

3.  Start target program 

Example for a Cmd file: 

set ICLUI_TRACE=ON
set ICLUI_TRACETO=\\QUEUES\\PRINTF32
set ICLUI_CHECKMEMORY=ON
start MScani.Exe
exit


To run with the IBM Debugger at the same time, you can set these environment 
variables in the config.sys or in the new workframe with the tool settings.


═══ 4. Trademarks ═══

Trademarks 

The following terms are trademarks of the IBM Corporation in the United States 
or other countries: 

   OS/2 
   Visual Age C++
   IBM Debugger 

Other company, product, and service names, which may be denoted by a double 
asterisk ([**]), may be trademarks or service marks of others. 


═══ 5. License Agreement ═══

License Agreement 

These programs are free in the sense that you can use and re-distribute them if 
done without any commercial fee. You can charge the media cost, however. I 
don't take any responsibility on any damage caused by usage of these programs.

Bug reports and suggestions may be sent to mutter@allgaeu.crg.de

The source code is free available.


═══ 6. Command ═══

Menu commands 

Browser/Reset:

Deletes the whole listbox.


Browser/Close:

Closes the Browser View.

Filter/Enable all threads:

All threads are enabled for the input queue.


Filter/Disable threads:

Single threads can be diasabeld for the input queue.


Queue/Suspend input:

All inputs are suspended. The Trace Browser reads strings from the input queue, 
but doesn't insert the strings into the listbox. So the queue will be empty 
after the command suspend input.


Queue/Resume input:

All inputs are resumed.