This directory contains the files for the sample
distributed application "picklp":

File          Description

README.TXT    Readme file for the PICKLE sample
PICKLP.IDL    Interface definition language file
PICKLP.ACF    Attribute configuration file
PICKLPC.C     Client main program
MAKEFILE      Nmake file to build for Windows NT
MAKEFILE.DOS  Nmake file to build for MS-DOS

The sample demonstrates procedure pickling to a file.
A fixed buffer and an incremental handle styles are used.
The implicit primitive handle is used as the pickling handle.

-----------------------------------------------------------------------
BUILDING THE (CLIENT) 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                                                   
For alpha, set CPU=alpha

Build the sample distributed application:
  nmake cleanall
  nmake

This builds the executable programs picklpc.exe.
There is no server side in this sample as the notion of server does not
apply to pickling.

-----------------------------------------------------------------------
BUILDING THE CLIENT APPLICATION FOR MS-DOS
-----------------------------------------------------------------------

After installing the Microsoft Visual C/C++ version 1.50 development 
environment and the Microsoft RPC version 2.0 toolkit on a Windows NT
computer, you can build the sample client application from Windows NT.

  nmake -f makefile.dos cleanall
  nmake -f makefile.dos

This builds the client application callc.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
     nmake -a -f makefile.dos picklp.h

  Step Two: Compile the C sources (stub and application) under MS-DOS.
     nmake -f makefile.dos


------------------------------------------
RUNNING THE APPLICATION
------------------------------------------

The default setting for this application is to encode data to pickle.dat file.
You enter

  picklpc

To decode data that has been encoded, enter

  picklpc -d

Several other command line switches are available to change
settings for this program. For a listing of the switches
available from the client program, enter

  picklpc -?
