Learning DCOM

Accompanying Source Code

You can download the accompanying source code from the O’Reilly ftp site. This section describes two methods for doing so, regular FTP and FTPMAIL.

FTP

If you have an Internet connection (permanent or dialup), the easiest way to use FTP is via your web browser or favorite FTP client. To get the examples, simply point your browser to:

ftp://ftp.oreilly.com/published/oreilly/nutshell/dcom/DCOMcode.zip

If you don’t have a web browser, you can use the command-line FTP client included with Windows NT (or Windows 95/98).

% ftp ftp.oreilly.com
Connected to ftp.oreilly.com.
220 ftp.oreilly.com FTP server (Version 6.34 Thu Oct 22 14:32:01 EDT 1992) ready.
Name (ftp.oreilly.com:username): anonymous
331 Guest login ok, send e-mail address as password.
Password: username@hostname            Use your username and host here
230 Guest login ok, access restrictions apply.
ftp> cd /published/oreilly/nutshell/dcom
250 CWD command successful.
ftp> get README
200 PORT command successful.
150 Opening ASCII mode data connection for README (xxxx bytes).
226 Transfer complete.
local: README remote: README
xxxx bytes received in xxx seconds (xxx Kbytes/s)
ftp> binary
200 Type set to I.
ftp> get DCOMcode.zip
200 PORT command successful.
150 Opening BINARY mode data connection for DCOMcode.zip (xxxx bytes).
226 Transfer complete. local: DCOMcode.zip remote: DCOMcode.zip
xxxx bytes received in xxx seconds (xxx Kbytes/s)
ftp> quit
221 Goodbye.
%

You should unzip the DCOMCode.zip file into an empty working directory. Once you have done this, you will find a number of subdirectories, that contain the source code for all the examples discussed in this book. The following table summarizes the contents of these subdirectories:

Chapter	Directory that contains the supporting source code
Chapter 1	N/A
Chapter 2	N/A
Chapter 3	Basics
Chapter 4	Basics
Chapter 5	Infrastructure
Chapter 6	OCRServer
Chapter 7	OCRClient
Chapter 8	Cyber
Chapter 9	Security
Chapter 10	Chat

Not shown in this table are the include directory, which contains several useful, helper classes that you can use, and the Hello directory, which contains a project for a simple distributed system with a client printing the “Hello, Universe!” message to the server. The example is provided primarily to show the typical code that’s required to build a simple distributed system using COM. See Appendix D for more information. Besides these two directories, be sure to check each subdirectory for a readme.txt file, because it tells you what you need to do to get the source code to compile and run.

FTPMAIL

FTPMAIL is a mail server available to anyone who can send electronic mail to and receive electronic mail from Internet sites. Any company or service provider that allows email connections to the Internet can access FTPMAIL, as described in the following paragraph.

You send mail to [e-mail]. In the message body, give the FTP commands you want to run. The server will run anonymous FTP for you and mail the files back to you. To get a complete help file, send a message with no subject and the single word “help” in the body. The following is an example mail message that gets the examples. This command sends you a listing of the files in the selected directory and the requested example files. The listing is useful if you are interested in a later version of the examples.

Subject:
reply-to username@hostname      (Message Body) Where you want files mailed
open
cd /published/oreilly/nutshell/dcom
dir
get README
mode binary
uuencode
get DCOMcode.zip
quit
.

A signature at the end of the message is acceptable as long as it appears after “quit.”