README.TXT

NHELLO 
 
 
FILES 
===== 
 
The directory samples\rpc\ns\nhello contains the following files for 
building the sample distributed application NHELLO: 
 
File            Description 
 
README.TXT      Readme file for the NHELLO sample 
NHELLO.IDL      Interface definition language file 
NHELLOC.C       Client main program 
NHELLOS.C       Server main program 
NHELLOP.C       Remote procedures 
NSSERV.C        NT Service program 
SERVICE.C       Service Control Manager interface 
MAKEFILE        Nmake file to build for Windows NT or Windows 95 
MAKEFILE.DOS    Nmake file to build for MS-DOS 
 
The directory samples\rpc\ns\cds contains the files that describe the 
gateway protocol to the DCE Cell Directory Service (CDS) 
 
----------------------------------------------------------------------- 
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 distributed application: 
  nmake cleanall 
  nmake 
 
This builds the executable programs nhelloc.exe 
(client), nhellos.exe (console server), and nsserv 
( NT service ). 
 
----------------------------------------------------------------------- 
BUILDING THE CLIENT APPLICATION FOR MS-DOS 
----------------------------------------------------------------------- 
 
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.dos cleanall 
  nmake -f makefile.dos 
 
This builds the client application nhelloc.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.dos nhello.h 
 
  Step Two: Compile the C sources (stub and application) under MS-DOS. 
     nmake -f makefile.dos 
 
 
----------------------------------------------------------------------- 
RUNNING THE CLIENT AND SERVER APPLICATIONS 
----------------------------------------------------------------------- 
 
-- NHELLOS -- 
On the server, enter 
 
  net start rpclocator 
  set start rpcss 
  nhellos 
 
(You can also start the RPC Locator and RPC Service by running 
the Services program in Control Panel.) 
 
 
-- NSSERV -- 
To install the service, first compile everything, and then: 
 
    nsserv -install 
 
Now all you have to do is start it, either using the 
"net start" method, the control panel Services applet, or 
the SC.EXE utilitie in the MSTOOLS\BIN directory: 
 
    sc start nshelloservice 
 
Once the service has been started, you can use the client 
program to verify that it really is working, using the syntax: 
 
    nhelloc 
 
which should cause to service to stop since it calls Shutdown() 
 
 
If, after playing with the sample you wish to remove the service, 
simply say: 
 
    nsserv -remove 
 
Other: NSSERV can be run as a console app by entering 
 
    nsserv -debug 
 
For more information on SERVICES see the SERVICE sample included 
with the Win32 SDK. 
 
 
-- NHELLOC -- 
On the client, enter 
 
  net start workstation 
  nhelloc 
 
 
Note:  The client and server applications can run on the same Microsoft 
Windows NT computer when you use different screen groups.  Also, only NSSERV 
or NHELLOS should be run at one time on the same Windows NT computer. 
 
 
Several command line switches are available to change settings for this 
program. For a listing of the switches available from the client 
program, enter: 
 
  nhelloc -? 
 
For a listing of switches available from the server program and the 
service program enter 
 
  nhellos -?