home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / netds / rpc / pickle / picklp / readme.txt < prev   
Encoding:
Text File  |  1996-01-17  |  2.7 KB  |  96 lines
  1. PICKLEP
  2.  
  3.  
  4. The PICKLEP program demonstrates data procedure serialization. The program 
  5. demonstrates a fixed buffer style pickling and an incremental style pickling 
  6. depending on the switches being used.
  7.  
  8. The implicit_handle primitive is used as the pickling handle.
  9.  
  10. With default switches, the program encodes data to a file. To decode data 
  11. from the file, use -d switch.
  12.  
  13. FILES
  14. =====
  15.  
  16. The directory samples\rpc\pickle\picklp contains the following files for
  17. building the distributed application PICKLP:
  18.  
  19. File          Description
  20.  
  21. README.TXT    Readme file for the PICKLE sample
  22. PICKLP.IDL    Interface definition language file
  23. PICKLP.ACF    Attribute configuration file
  24. PICKLPC.C     Client main program
  25. MAKEFILE      Nmake file to build for Windows NT or Windows 95
  26. MAKEFILE.DOS  Nmake file to build for MS-DOS
  27.  
  28. -----------------------------------------------------------------------
  29. BUILDING THE (CLIENT) FOR MICROSOFT WINDOWS NT OR WINDOWS 95
  30. -----------------------------------------------------------------------
  31.  
  32. The following environment variables should already be set for you:
  33.  
  34.   set CPU=i386
  35.   set INCLUDE=%SDKROOT%\h
  36.   set LIB=%SDKROOT%\lib
  37.   set PATH=%SDKROOT%\system32;%SDKROOT%\bin
  38.  
  39. where %SDKROOT% is the root directory for the 32-bit Windows SDK.
  40.  
  41. For mips,  set CPU=mips
  42. For alpha, set CPU=alpha
  43.  
  44. Build the sample distributed application:
  45.  
  46.   nmake cleanall
  47.   nmake
  48.  
  49. This builds the executable programs picklpc.exe.
  50. There is no server side in this sample as the notion of server does not
  51. apply to pickling.
  52.  
  53. ------------------------------------------
  54. BUILDING THE CLIENT APPLICATION FOR MS-DOS
  55. ------------------------------------------
  56.  
  57. After installing the Microsoft Visual C/C++ version 1.50 development
  58. environment and the 16-bit RPC SDK on a Windows NT or Windows 95
  59. computer, you can build the sample client application from Windows NT
  60. or Windows 95:
  61.  
  62.   nmake -f makefile.dos cleanall
  63.   nmake -f makefile.dos
  64.  
  65. This builds the client application callc.exe.
  66.  
  67. You may also execute the Microsoft Visual C/C++ compiler under MS-DOS.
  68. This requires a two-step build process.
  69.  
  70.   Step One: Compile the .IDL files under Windows NT or Windows 95:
  71.  
  72.      nmake -a -f makefile.dos picklp.h
  73.  
  74.   Step Two: Compile the C sources (stub and application) under MS-DOS:
  75.  
  76.      nmake -f makefile.dos
  77.  
  78. -----------------------
  79. RUNNING THE APPLICATION
  80. -----------------------
  81.  
  82. The default setting for this application is to encode data to 
  83. pickle.dat file. Enter:
  84.  
  85.   picklpc
  86.  
  87. To decode data that has been encoded, enter:
  88.  
  89.   picklpc -d
  90.  
  91. Several other command line switches are available to change settings for 
  92. this program. For a listing of the switches available from the client 
  93. program, enter:
  94.  
  95.   picklpc -?
  96.