Building                                         
There should be two makefiles here: one for Linux
and one for Windows.  The Linux version is called
Makefile and the Windows version is called makefile.mcr.  
When building on Windows, you may want to delete the 
Linux version(Makefile) and rename makefile.mcr to just 
makefile.  If you're using a big-endian machine, add 
-DENDIAN_BIG to the CPPFLAGS in the makefile.

A library and two programs are built.  The programs 
are the C++ Middleware Writer Ambassador (CMWA) and 
a command line interface which is called direct.  


Accounts
An account is needed to use the C++ Middleware Writer. 
Before running the programs, you'll have to set up 
an account and modify your cmwAmbassador.cfg file to 
include your account number(s) and password(s).

When an account is created, a directory on the server 
is associated with that account.  That directory is 
reused with each request and only the input files that 
have changed since your last request will be sent.
This page is used to set up accounts -- 
http://webEbenezer.net/cgi-bin/account.cgi .


Running the CMW Ambassador:
On Linux (after installing):

cmwAmbassador cmwAmbassador.cfg

or on Windows:

.\cmwAmbassador.exe cmwAmbassador.cfg


After starting the CMW Ambassador run the direct
program like this:

direct 14 /home/brian/direct/cmw.req  127.0.0.1

or on Windows:

.\direct.exe 14 /Users/brian/direct/cmw.req 127.0.0.1

14 is an account number.  Substitute your account
number there.  

The path for a .req file is next -- req is short for request.  
Zero or more header files and one "Middle file" are listed in 
a .req file to specify a request.  There's more info on
Middle files here -- http://webEbenezer.net/middle.html.
A .req file also has the settings for various options.

The last argument, 127.0.0.1 in this case, tells 
direct where to find the ambassador.  If the 
ambassador and direct programs will run on the same 
machine, pass 127.0.0.1.  If they're on different 
machines, pass either the host name or IP address 
of that machine.

Once you have built the software, I suggest copying
cmw.req and remote.mdl to one of your directories and
then modifying the copies according to your software 
needs.


Troubleshooting
The middle tier has to be running for the front tier to work.  
If direct fails with "Connect failed," make sure the middle 
tier is running.

Another possible problem could be due to "breaking changes"
between the CMW and CMWA.  (We may have changed the protocol
between the CMW and CMWA and now your older version of the
CMWA no longer works right.)  The thing to do in this case
is to check if the checksum here --                     
http://webEbenezer.net/build_integration.html  -- 
is different from the result of running md5sum on your
copy of the archive.  If the checksums are different,
download the new version of the archive and reinstall.

Thank you for using the software.