README.TXT

WHELLO 
 
 
The WHELLO program is a client/server implementation of "Hello, World". The 
client and server applications can run on the same Windwos NT workstation. 
 
FILES 
===== 
 
The directory samples\rpc\whello contains the following files for building 
the sample distributed application WHELLO: 
 
File          Description 
 
README.TXT    Readme file for the WHELLO sample 
WHELLO.IDL    Interface definition language file 
WHELLO.ACF    Attribute configuration file 
WHELLOC.C     Client main program 
WHELLO.RC     Client resource file 
WHELLO.DLG    Client dialog box definitions 
WHELLO.DEF    Client module definition file 
WHELLOS.C     Server main program 
WHELLOP.C     Remote procedures 
MAKEFILE      Nmake file for Windows NT or Windows 95 
MAKEFILE.WIN  Nmake file for Win 3.x 
 
------------------------------------------- 
BUILDING CLIENT AND SERVER APPLICATIONS FOR 
MICROSOFT WINDOWS NT OR WINDOWS 95: 
------------------------------------------- 
 
The following environment variables should be set for you already. 
 
  set CPU=i386 
  set INCLUDE=%SDKROOT%\h 
  set LIB=%SDKROOT%\lib 
  set PATH=%SDKROOT%\system32;%SDKROOT%\bin; 
 
Where %SDKROOT% is the root directory for the 32-bit Windows SDK. 
 
For mips, set CPU=mips 
For alpha, set CPU=alpha 
 
Build the sample server application: 
 
  nmake cleanall 
  nmake 
 
These commands build the executable program whellos.exe 
and whelloc.exe for Microsoft Windows NT or Windows 95. 
 
-------------------------------------------- 
BUILDING THE CLIENT APPLICATION FOR WIN 3.X 
-------------------------------------------- 
 
After installing the Microsoft Visual C/C++ version 1.50 development 
environment and the 16-bit RPC SDK on a Windows NT or Windows 95 
computer, you can build the sample client application from Windows NT 
or Windows 95. 
 
  nmake -f makefile.win cleanall 
  nmake -f makefile.win 
 
This builds the client application whelloc.exe. 
 
You may also execute the Microsoft Visual C/C++ compiler under MS-DOS. 
This requires a two step build process. 
 
  Step One: Compile the .IDL files under Windows NT or Windows 95 
     nmake -a -f makefile.win whello.h 
 
  Step Two: Compile the C sources (stub and application) under MS-DOS. 
     nmake -f makefile.win 
 
------------------------------------------ 
RUNNING THE CLIENT AND SERVER APPLICATIONS 
------------------------------------------ 
 
On the server, enter 
 
  whellos 
 
On the client, enter 
 
  net start workstation 
  whelloc 
 
Note:  The client and server applications can run on 
the same Microsoft Windows NT or Windows 95 computer when you use 
different screen groups.  If you run the client on the 
Microsoft MS-DOS and Windows computer, choose the Run 
command from the File menu in the Microsoft Windows 3.x 
Program Manager and enter whelloc.exe. 
 
Several command line switches are available to change 
settings for the server application. For a listing of 
available switches, enter 
 
  whellos -? 
 
--------------------- 
RUNNING ON WINDOWS 95 
--------------------- 
 
If you wish to run the server on Windows 95, you will need to use 
the LRPC protocol. 
 
To start the server, enter 
 
 whellos -p ncalrpc 
 
To start the client (from the same machine), enter 
 
 whelloc 
 
Change the protocol to "ncalrpc" by selecting "Protocol sequence name" 
from the "Remote Call" menu and entering 
 
 ncalrpc