=====================================
PragmaDev MscTracer example directory
=====================================

In this directory, you will find three examples of client programs that
communicate with MscTracer:

- SimpleClient: sends a few pre-defined commands to the tracer
- MultiTraceClient: automatically opens several traces from the client

Please see the comment at the top of the corresponding source file for further
details.


Compiling the examples:
-----------------------

These example programs have been tested with gcc version 2.95/2.96. There is no
guarantee that they will work with any other version. If gcc is not already
installed on your workstation, gcc packages for Windows, Solaris and Linux can
be downloaded from the download pages on http://www.pragmadev.com

Once gcc is installed, the examples can be compiled with the following command:

- on Windows or Linux:
  gcc -o <example> <example>.c TracerSocketConnection.c

- on Solaris:
  gcc -lnsl -lsocket -o <example> <example>.c TracerSocketConnection.c

Launch MscTracer as described in paragraph 1.1 of the user manual. This manual
is in the "doc" sub-directory of the installation directory. Please note the
examples are written to work either with the GUI or without. Please refer to the
comment at the top of the example main source file.

Once MscTracer is launched, wait for the message telling it is ready to accept
clients, then run the example like follows:

<example> [ipAddress] portNumber

- ipAddress is the ip address of the host where MscTracer is running. If both
  client and MscTracer run on the same host, this parameter can be omitted.

- portNumber is the socket port specified in the MscTracer preferences or on the
  command line. See paragraphs 1.1 and 2.3 of the user manual for further
  information.
