Return to readme.txt CVS log

Up to [WindowsNT SDKs] / mstools / samples / rpc / hello3

Annotation of mstools/samples/rpc/hello3/readme.txt, revision 1.1.1.1

1.1       root        1: File:  hello3\readme.txt
                      2: Date:  October 1991
                      3: 
                      4: The hello3 application demonstrates a very simple
                      5: distributed application.  The client prompts the user for a
                      6: string, then calls a remote procedure that displays the
                      7: specified string to the display of the remote server.
                      8: 
                      9: BUILDING THE SAMPLE PROGRAM
                     10: 
                     11: You can build the distributed application executables from
                     12: their source files using the nmake utility. A makefile for
                     13: the application is provided with the hello program. Type
                     14: 
                     15: >nmake cleanall
                     16: >nmake
                     17: 
                     18: If you have difficulty building the application, it may be
                     19: that some files are in different directories than expected.
                     20: You may need to set the PATH and INCLUDE environment
                     21: variables.
                     22: 
                     23: RUNNING THE DISTRIBUTED APPLICATION
                     24: 
                     25: To run the hello application, start the Microsoft NT
                     26: Operating System server service and start the server side of
                     27: the distributed application:
                     28: 
                     29: >net start server
                     30: >server
                     31: 
                     32: The server program starts and waits for client requests. You
                     33: need to know the name of the server in order to start the
                     34: client application. If you do not know the name, type the
                     35: following command on the server:
                     36: 
                     37: >net config rdr
                     38: 
                     39: The net config rdr command lists the computername.
                     40: 
                     41: To start the client application, start another screen group
                     42: and type the name of the executable program followed by the
                     43: name of the server on which the server application is
                     44: running. For example, if the name of your server is RPCTEST,
                     45: type:
                     46: 
                     47: >client RPCTEST
                     48: 
                     49: If the client successfully binds to the server, the client
                     50: application prompts you for the string to display on the
                     51: remote server:
                     52: 
                     53: >Enter a string to send to the server:
                     54: 
                     55: Enter the message that you want to see displayed on the
                     56: server. The client calls the remote application on the
                     57: server computer and causes the server side of the
                     58: distributed application to display your text.
                     59: 
                     60: If the client is unable to bind to the server, the client
                     61: displays a status code.  For example, if a call to the RPC
                     62: API function fails, the client application may display the
                     63: text:
                     64: 
                     65: > RpcBindToInterface: yyyyzzzz
                     66: 
                     67: where yyyyzzzz is an 8-digit hexadecimal status code. The
                     68: RPC status code is in the least significant 16 bits (the
                     69: "zzzz" portion) of the 32-bit status code.  RPC status codes
                     70: are documented in the RPC runtime documentation.
                     71: 
                     72: /* end hello3\readme.txt */

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.