This file describes the different examples found in teh
two sub-directories of this directory. 

The two examples in sub-directory Sockets consist of 2 
applications (a server and a client) that communication
with each other. They do not rely on Motif. 
The example in sub-directory Sockets_Motif uses the Motif 
library. It allows a operator to play the role of the Web 
server. 


In Sockets

clienttcp, servertcp:
	This example shows how to establish a TCP connection 
        between two programs in sC++.

clientudp, serverudp:
	This example shows how to establish a UDP connection 
        (using the UDPSocket active class) between two 
        programs in sC++.

In order to run the program
     make
     ./servertcp 5000
     and in a second workstation or at least in a second window
     ./clienttcp serverHostName 5000



In Sockets_Motif

webManualServer:
        This program waits for data coming on port 8080,
        which is a port used for Web trials. Once this
        program has been started, you can open a URL on a 
        web browser:   http://hostname:8080/blabla
        with hostname being the name of the computer where the
        webManualServer has been started.
        The request of the browser will be displayed on a
        (Motif) window and if you type in text, it will be
        returned to the browser, which will display it as if
        it would come from a real browser. This program allows
        you to understand the web commands, e.g., the Form 
        commands. You can also use it as a basis to build 
        your own server.

In order to run the program, jump into Sockets_Motif
then type in the commands:

    make
    ./webManualServer
    In a web browser, open the URL:
      http://nameOfServerLocation:8080/anyThing
    You will see the command sent to the server by
    the browser.
    Type data (maybe in html) in the window and terminate 
    it with a . on a new line. 
    These data will be sent back to the browser for display.
