--- mstools/samples/rpc/mandel/readme.txt 2018/08/09 18:20:01 1.1 +++ mstools/samples/rpc/mandel/readme.txt 2018/08/09 18:24:14 1.1.1.2 @@ -1,88 +1,79 @@ -File: mandel\readme.txt -Date: November 1991 +This directory contains the files for the sample +distributed application "mandel": -The mandel application demonstrates a sample Windows client -distributed application. The client calls a remote -procedure that performs the intensive calculations needed -for the image. +File Description -BUILDING THE SAMPLE PROGRAM +README.TXT Readme file for the MANDEL sample +MDLRPC.IDL Interface definition language file +MDLRPC.ACF Attribute configuration file +MANDEL.C Client main program +MANDEL.H Client global data +REMOTE.C Client code that calls remote procedures +RPC.ICO Client icon +MANDEL.DEF Client module definition file +MANDEL.RC Client resource script file +SERVER.C Server main program +CALC.C Remote procedures +MAKEFILE nmake utility for Windows NT +MAKEFILE.WIN nmake utility for Win 3.x + +------------------------------------------- +BUILDING CLIENT AND SERVER APPLICATIONS FOR +MICROSOFT WINDOWS NT: +------------------------------------------- + +The following environment variables should be set for you already. + set CPU=i386 + set INCLUDE=c:\mstools\h + set LIB=c:\mstools\lib + set PATH=c:\winnt\system32;c:\mstools\bin; + +For mips, set CPU=mips + +Build the sample distributed application: + nmake cleanall + nmake + +This builds the executable programs client.exe and +server.exe for Microsoft Windows NT. + +-------------------------------------------- +BUILDING THE CLIENT APPLICATION FOR WIN 3.X +-------------------------------------------- + +After you install the Microsoft C/C++ version 7.0 +development environment and the Microsoft RPC version +1.0 toolkit on a Microsoft MS-DOS and Windows computer, +you can build the sample client application for Win 3.x. +Enter: + + nmake -f makefile.win cleanall + nmake -f makefile.win + +This builds the client application client.exe. + +------------------------------------------ +RUNNING THE CLIENT AND SERVER APPLICATIONS +------------------------------------------ + +On the server, enter + + server + +On the client, enter + + net start workstation + client + +Note: The client and server applications can run on +the same Microsoft Windows NT 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 client.exe. + +Several command line switches are available to change +settings for the server program. For a listing of switches +available from the server program, enter -You can build the application from its source files using -the nmake utility. The makefile allows you to build a -standalone version (without RPC) or a version that uses -remote procedure call over local named pipes on the NT -server (with RPC). The makefile also supports both i386 and -MIPS computers. - -To build the application for the i386 environment, set the -CPU environment variable to "i386": - ->set CPU=i386 - -To build the application for the MIPS environment, set the -CPU environment variable to "MIPS": - ->set CPU=MIPS - -To build and run a standalone version of the application -called mandel.exe, use the following commands so that the -RPC environment variable is undefined: - ->set RPC= ->nmake cleanall ->nmake - -To build the RPC version of the application, client.exe and -server.exe, use the following commands: - ->set RPC=1 ->nmake cleanall ->nmake - -If you have difficulty building the application, it may be -that some files are in different directories than expected. -You may need to set the LIB, PATH and INCLUDE environment -variables. - -RUNNING THE DISTRIBUTED APPLICATION - -To run the standalone version of the mandel application, -type - ->mandel - -To run the RPC version of the mandel application, start the -server side of the distributed application: - ->net start server ->server - -The server program starts and waits for client requests. To -start the client application, start another screen group and -type the name of the executable program. - ->client - -The client application calls the server application in the -server screen group to calculate the data for the picture. - -If the client is unable to bind to the server, the client -displays a status code. For example, if a call to the RPC -API function fails, the client application may display the -text: - -> RpcBindToInterface: yyyyzzzz - -where yyyyzzzz is an 8-digit hexadecimal status code. The -RPC status code is in the least significant 16 bits (the -"zzzz" portion) of the 32-bit status code. RPC status codes -are documented in the RPC runtime documentation. - -The "continuous" option indicates whether the program will -continuously draw images. - -The "zoom in" option is effective only after you have -selected a region using the left mouse button. - -/* end mandel\readme.txt */ + server -?