This directory contains seven examples from "Guide to Writing DCE
Applications," 2nd edition, by John Shirley, Wei Hu, and David Magid,
published by O'Reilly & Associates, Inc.

Each of the examples appears in a separate appendix in the book, and in a
compressed tar .Z file in this directory.  Each .Z file contains all the
source code and configuration information required for building its example,
including:

* A README file containing directions from the appendix for building and
  running the application.

* The .idl interface definition, and a .acf file if one if needed.

* Other .c and .h source files.

* A Makefile, which you might have to change before using.

When you run a tar command to extract files, it creates a subdirectory that
holds all the files pertaining to the example.

The files and corresponding examples are:

arithmetic.apr94.tar.Z       The arithmetic application, Appendix C.

                             This application provides a very simple,
                             basic example of RPC programming for the
                             introductory discussion in Chapter 1.

inventory.apr94.tar.Z        The inventory application, Appendix D.

                             This application offers a number of
                             examples that form the basis for
                             discussions of various topics throughout
                             the book, particularly in Chapters 2
                             through 4.

ok_banking.aug94.tar.Z       The OK banking example, Appendix E.

                             This application is the first, crude use
                             of object UUIDs in Chapter 7.

better_banking.aug94.tar.Z   The OK banking example, Appendix F.

                             This application represents a more
                             sophisticated use of object UUIDs in
                             Chapter 7.

grade_server.apr94.tar.Z     The Grade Server application, Appendix G.

                             This application shows authentication and
                             authorization and forms the basis of
                             Chapters 8 and 9.

remote_file.apr94.tar.Z      The remote_file application, Appendix H.

                             This application forms the basis for the
                             discussion of context handles in Chapter
                             10.

transfer_data.apr94.tar.Z    The transfer_data application, Appendix I.

                             This application forms the basis for the
                             discussion of pipes in Chapter 11.

The pc-dce directory contains Windows versions of the examples, which
run on PC-DCE from Gradient Technologies, Inc.  Gradient has given
O'Reilly these programs, which were written by Ray Costello.  The
files containing the programs are:

arithmet.apr94.tar.Z
better.aug94.tar.Z
grade.apr94.tar.Z
inventry.apr94.tar.Z
ok.aug94.tar.Z
remote_f.apr94.tar.Z
xferdata.apr94.tar.Z

2 August 1994

	A minor correction affects the following files:

		tar file			source code file
		-----------------------------------------------------------
		better_banking.apr94.tar.Z	better_banking/btr_client.c
		ok_banking.apr94.tar.Z		ok_banking/ok_client.c
		pc-dce/better.apr94.tar.Z	better/client/btr_cli.c
		pc-dce/ok.apr94.tar.Z		ok/client/okclient.c


	In each file, case 2 of main incorrectly passed bank_status
	twice as an error parameter to the transaction routine.  In
	the corrected files, dce_status is passed as the second error
	parameter.