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 / yield / readme.txt < prev    next >
Text File  |  1996-01-15  |  3KB  |  93 lines
  1. YIELD
  2.  
  3.  
  4. The YIELD program demonstrates use of the RpcWinSetYieldInfo function to
  5. prevent a distributed application from blocking during lengthy remote
  6. procedure calls.
  7.  
  8. FILES
  9. =====
  10.  
  11. The directory samples\rpc\yield contains the following files for building
  12. the sample distributed application YIELD:
  13.  
  14. File          Description
  15.  
  16. README.TXT    Readme file for the YIELD sample
  17. YIELD.IDL     Interface definition language file
  18. YIELD.ACF     Attribute configuration file
  19. YIELDC.C      Client main program
  20. YIELDC.RC     Client resource file
  21. YIELDC.DLG    Client dialog box definitions
  22. YIELDC.DEF    Client module definition file
  23. YIELDS.C      Server main program
  24. YIELDP.C      Remote procedures
  25. MAKEFILE      Nmake file for Windows NT or Windows 95
  26. MAKEFILE.win  Nmake file for Win 3.x
  27.  
  28. -------------------------------------------------------------------
  29. BUILDING SERVER APPLICATION FOR 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 server executable program YIELDS.EXE.
  50.  
  51. --------------------------------------------
  52. BUILDING THE CLIENT APPLICATION FOR WIN 3.X
  53. --------------------------------------------
  54.  
  55. After installing the Microsoft Visual C/C++ version 1.50 development
  56. environment and the 16-bit RPC SDK on a Windows NT or Windows 95
  57. computer, you can build the sample client application from Windows NT
  58. or Windows 95.
  59.  
  60.   nmake -f makefile.win cleanall
  61.   nmake -f makefile.win
  62.  
  63. This builds the client application yieldc.exe.
  64.  
  65. You may also execute the Microsoft Visual C/C++ compiler under MS-DOS.
  66. This requires a two step build process.
  67.  
  68.   Step One: Compile the .IDL files under Windows NT or Windows 95.
  69.      nmake -a -f makefile.win yield.h
  70.  
  71.   Step Two: Compile the C sources (stub and application) under MS-DOS.
  72.      nmake -f makefile.win
  73.  
  74. ------------------------------------------
  75. RUNNING THE CLIENT AND SERVER APPLICATIONS
  76. ------------------------------------------
  77.  
  78. On the server, enter
  79.  
  80.   yields
  81.  
  82. On the client, choose the Run command from the File menu in the
  83. Microsoft Windows 3.x Program Manager and enter YIELDC.EXE.
  84.  
  85. Several command line switches are available to change settings for
  86. the server application. For a listing of available switches, enter
  87.  
  88.   yields -?
  89.  
  90. Bug: If you cancel in the middle of a custom yield, you must wait
  91. for the number of seconds you originally set before making another
  92. remote procedure call.
  93.