Return to readme.txt CVS log

Up to [WindowsNT SDKs] / mstools / samples / rpc / adder1

Microsoft Windows NT Pre-Release 11-19-1991

File:  adder1\readme.txt
Date:  October 1991

The adder1 application demonstrates a very simple
distributed application.  The client calls a remote
procedure to add two short integers.  The remote
procedure adds the numbers and returns them to the server.

BUILDING THE SAMPLE PROGRAM

You can build the distributed application executables from
their source files using the nmake utility. A makefile for
the application is provided with the adder program. Type

>nmake cleanall
>nmake

If you have difficulty building the application, it may be
that some files are in different directories than expected.
You may need to set the PATH and INCLUDE environment
variables.

RUNNING THE DISTRIBUTED APPLICATION

To run the adder application, start the Microsoft NT
Operating System server service and start the server side of
the distributed application:

>net start server
>server

The server program starts and waits for client requests. You
need to know the name of the server in order to start the
client application. If you do not know the name, type the
following command on the server:

>net config rdr

The net config rdr command lists the computername.

To start the client application, start another screen group
and type the name of the executable program followed by the
name of the server on which the server application is
running. For example, if the name of your server is RPCTEST,
type:

>client RPCTEST

The client calls the remote application on the
server computer and causes the server side of the
distributed application to add the short integers 
1 and 2.  The server displays the simple calculation:

>1 + 2 = 3

The client displays the result returned 
from the remote procedure:

>result from remote procedure = 3

If the client is unable to bind to the server, the client
displays a status code.  For example, if a call to the RPC
API function fails, the client application may display the
text:

> RpcBindToInterface: yyyyzzzz

where yyyyzzzz is an 8-digit hexadecimal status code. The
RPC status code is in the least significant 16 bits (the
"zzzz" portion) of the 32-bit status code.  RPC status codes
are documented in the RPC runtime documentation.

/* end adder1\readme.txt */

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.