README.txt
1Documentation of the tie examples
2=================================
3
4metakit.tcl
5 This is the implementation of a data source storing the array
6 in a metakit database.
7
8server.tcl
9sending_client.tcl
10receiving_client.tcl
11
12 These three scripts belong together. They demonstrate how to
13 sharing an array across processes. It uses the package "comm"
14 and the data source "remotearray".
15
16 server.tcl
17
18 is invoked without arguments. It will print the id of
19 the TCP server port it is listening on. It has a
20 single array 'server'. Changes to the array are
21 reported on stdout.
22
23 sending_client.tcl
24
25 is invoked with the id of the server as its only
26 argument. It has a local array 'sender'. Changes to
27 'sender' are exported to the server vie tie,
28 remotearray, and comm. The changes made are hardwired
29 into the script and executed with a delay of 1/10th of
30 a second between them, after a 2 second startup delay.
31
32 receiving_client.tcl
33
34 is invoked with the id of the server as its only
35 argument. It has a local array 'receiver'. Changes to
36 receiver are reported to stdout. The script imports
37 the server array, and any changes on the server are
38 mirrored in the receiver.
39
40 Open three xterm and start the three scripts in them, in the
41 order
42 server.tcl
43 receiving_client.tcl
44 sending_client.tcl
45
46 Two seconds after the sending client has started both server
47 and receiver start to report the changes made by the sender to
48 its array and broadcast to server and then the receiver.
49
50transceiver.tcl
51
52 A combination of both sending_client.tcl and
53 receiving_client.tcl. Exports the local array to the server,
54 and imports the server array to the local one. Performs
55 changes both local and on the server, showing that both
56 changes get distributed to both partners, independent where
57 the change was made.
58