README.TXT

YIELD 
 
 
The YIELD program demonstrates use of the RpcWinSetYieldInfo function to 
prevent a distributed application from blocking during lengthy remote 
procedure calls. 
 
FILES 
===== 
 
The directory samples\rpc\yield contains the following files for building 
the sample distributed application YIELD: 
 
File          Description 
 
README.TXT    Readme file for the YIELD sample 
YIELD.IDL     Interface definition language file 
YIELD.ACF     Attribute configuration file 
YIELDC.C      Client main program 
YIELDC.RC     Client resource file 
YIELDC.DLG    Client dialog box definitions 
YIELDC.DEF    Client module definition file 
YIELDS.C      Server main program 
YIELDP.C      Remote procedures 
MAKEFILE      Nmake file for Windows NT or Windows 95 
MAKEFILE.win  Nmake file for Win 3.x 
 
------------------------------------------------------------------- 
BUILDING SERVER APPLICATION 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 server executable program YIELDS.EXE. 
 
-------------------------------------------- 
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 yieldc.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 yield.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 
 
  yields 
 
On the client, choose the Run command from the File menu in the 
Microsoft Windows 3.x Program Manager and enter YIELDC.EXE. 
 
Several command line switches are available to change settings for 
the server application. For a listing of available switches, enter 
 
  yields -? 
 
Bug: If you cancel in the middle of a custom yield, you must wait 
for the number of seconds you originally set before making another 
remote procedure call.