home *** CD-ROM | disk | FTP | other *** search
- EXAMPLE DIRECTORY
-
- Description:
-
- This directory contains a variety of simple distributed
- applications that demonstrate how to use different
- features provided by NetWare RPC. Each example
- occupies its own directory and contains a README file
- that describes the nature of the example and how to build
- and run the example applications.
-
- At minimum, this directory contains the following examples:
-
- array
- This example demonstrates the use of arrays within an
- RPC specification.
-
- async
- This example demonstrates how to add custom code
- to convert the RPC code so that the client can communicate
- without being forced to synchronize with the server.
-
- async1
- This example demonstrates a second way to allow
- the client to communicate without being forced to
- synchronize with the server, and provides for multiple
- asynchronous remote procedure calls.
-
- authen
- This example demonstrates how a simple authentication
- mechanism can be added to the code generated by the RPC
- Compiler.
-
- cbak
- This example shows how a 'callback' facility can be created.
- In 'cbak', the server temporarily becomes a client and makes
- remote procedure calls back to the client (which acts as a
- server) during the processing of a remote procedure.
-
- debug
- This example demonstrates how to incorporate custom
- error-reporting instructons within the RPC code.
-
- diag
- This example is a simple diagnostic tool used for testing
- the basic integrity of the RPC Compiler.
-
- error
- This example shows how to customize the client stub so all
- RPC errors are reported in the return value of the remote
- procedure.
-
- freemem
- This example demonstrates dynamic allocation and
- deallocation of memory by the client stub code and
- by the remote procudure.
-
- link
- This example demonstrates the use of a linked list data
- structure and the memory management techniques used to
- handle this type of data structure.
-
- lostptr
- This example demonstrates the use of the _lostptr_
- memory recovery routine.
-
- macro
- This example demonstrates the use of expression
- macros with RPC Specifications.
-
- multicli
- This example demonstrates the use of the multiple-client
- server control procedure, which allows for multiple
- simultaneous client process bindings.
-
- nonper
- This example demonstrates how to build a client
- and a server that interact using non-persistent
- connections.
-
- ovrwrite
- This example shows the use of the _overwrite_ procedure.
-
- persist
- This example demonstrates a client calling multiple
- remote procedures using a single persistent connection.
-
- pointer
- This example demonstrates the use of pointers within
- an RPC Specification.
-
- pointer1
- This example demonstrates a more complex use of pointers,
- including the passing of a sequence of pointers to
- structures to a remote procedure.
-
- quick
- This example is provided as a learning tool. Refer to
- the Quick Start Manual for more extensive information.
-
- tags
- This example shows the use of tag qualifiers in an RPC
- specfication.
-
- timer
- This example demonstrates how to incorporate custom
- timeout code within a remote procedure call. This timeout
- code allows the client to detect an error if the server's
- reply is not received after a specified period of time.
-
- tutorial
- This example is provided as a learning tool. Refer to
- the tutorial section of the NetWare RPC User's Manual
- for more extensive information.
-
- union
- This example demonstrates the use of unions within an
- RPC specification.
-
-
- Building the Client and Server Applications:
-
- To build the client and server applications, follow the
- instructions in the README file included in each example
- directory.