home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / netds / rpc / whello / readme.txt < prev    next >
Encoding:
Text File  |  1996-01-15  |  3.3 KB  |  120 lines
  1. WHELLO
  2.  
  3.  
  4. The WHELLO program is a client/server implementation of "Hello, World". The
  5. client and server applications can run on the same Windwos NT workstation.
  6.  
  7. FILES
  8. =====
  9.  
  10. The directory samples\rpc\whello contains the following files for building
  11. the sample distributed application WHELLO:
  12.  
  13. File          Description
  14.  
  15. README.TXT    Readme file for the WHELLO sample
  16. WHELLO.IDL    Interface definition language file
  17. WHELLO.ACF    Attribute configuration file
  18. WHELLOC.C     Client main program
  19. WHELLO.RC     Client resource file
  20. WHELLO.DLG    Client dialog box definitions
  21. WHELLO.DEF    Client module definition file
  22. WHELLOS.C     Server main program
  23. WHELLOP.C     Remote procedures
  24. MAKEFILE      Nmake file for Windows NT or Windows 95
  25. MAKEFILE.WIN  Nmake file for Win 3.x
  26.  
  27. -------------------------------------------
  28. BUILDING CLIENT AND SERVER APPLICATIONS FOR
  29. MICROSOFT WINDOWS NT OR WINDOWS 95:
  30. -------------------------------------------
  31.  
  32. The following environment variables should be set for you already.
  33.  
  34.   set CPU=i386
  35.   set INCLUDE=%SDKROOT%\h
  36.   set LIB=%SDKROOT%\lib
  37.   set PATH=%SDKROOT%\system32;%SDKROOT%\bin;
  38.  
  39. Where %SDKROOT% is the root directory for the 32-bit Windows SDK.
  40.  
  41. For mips, set CPU=mips
  42. For alpha, set CPU=alpha
  43.  
  44. Build the sample server application:
  45.  
  46.   nmake cleanall
  47.   nmake
  48.  
  49. These commands build the executable program whellos.exe
  50. and whelloc.exe for Microsoft Windows NT or Windows 95.
  51.  
  52. --------------------------------------------
  53. BUILDING THE CLIENT APPLICATION FOR WIN 3.X
  54. --------------------------------------------
  55.  
  56. After installing the Microsoft Visual C/C++ version 1.50 development
  57. environment and the 16-bit RPC SDK on a Windows NT or Windows 95
  58. computer, you can build the sample client application from Windows NT
  59. or Windows 95.
  60.  
  61.   nmake -f makefile.win cleanall
  62.   nmake -f makefile.win
  63.  
  64. This builds the client application whelloc.exe.
  65.  
  66. You may also execute the Microsoft Visual C/C++ compiler under MS-DOS.
  67. This requires a two step build process.
  68.  
  69.   Step One: Compile the .IDL files under Windows NT or Windows 95
  70.      nmake -a -f makefile.win whello.h
  71.  
  72.   Step Two: Compile the C sources (stub and application) under MS-DOS.
  73.      nmake -f makefile.win
  74.  
  75. ------------------------------------------
  76. RUNNING THE CLIENT AND SERVER APPLICATIONS
  77. ------------------------------------------
  78.  
  79. On the server, enter
  80.  
  81.   whellos
  82.  
  83. On the client, enter
  84.  
  85.   net start workstation
  86.   whelloc
  87.  
  88. Note:  The client and server applications can run on
  89. the same Microsoft Windows NT or Windows 95 computer when you use
  90. different screen groups.  If you run the client on the
  91. Microsoft MS-DOS and Windows computer, choose the Run
  92. command from the File menu in the Microsoft Windows 3.x
  93. Program Manager and enter whelloc.exe.
  94.  
  95. Several command line switches are available to change
  96. settings for the server application. For a listing of
  97. available switches, enter
  98.  
  99.   whellos -?
  100.  
  101. ---------------------
  102. RUNNING ON WINDOWS 95
  103. ---------------------
  104.  
  105. If you wish to run the server on Windows 95, you will need to use
  106. the LRPC protocol.
  107.  
  108. To start the server, enter
  109.  
  110.  whellos -p ncalrpc
  111.  
  112. To start the client (from the same machine), enter
  113.  
  114.  whelloc
  115.  
  116. Change the protocol to "ncalrpc" by selecting "Protocol sequence name"
  117. from the "Remote Call" menu and entering
  118.  
  119.  ncalrpc
  120.