home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 5 / 05.iso / a / a076 / 3.img / DCLIPDEV / RTLINK.ZIP / RTLINK.DOC < prev   
Encoding:
Text File  |  1989-08-21  |  3.0 KB  |  78 lines
  1. Creating dCLIP and dCLIPRUN executables using .RTLINK
  2. ------------------------------------------------------
  3.  
  4. You may use .RTLINK Version 2.01 or later to build dCLIP and dCLIPRUN
  5. engines rather than PLINK86.  This provides a significant advantage in
  6. that the RELOAD capability of .RTLINK can be used to create a smaller
  7. memory model of each engine.  Engines created with .RTLINK Version
  8. 2.01 will use approximately 25k-30k less memory than those created with
  9. PLINK86.
  10.  
  11. A set of files (DCLIPRTL.LNK and DCRUNRTL.LNK) have been provided to be
  12. used with .RTLINK only.  Do not use these link files with PLINK86.
  13. .RTLINK allows modules which have been compiled in C or ASM to 
  14. automatically RELOAD into memory after they have called another module in
  15. the same overlay area.  
  16.  
  17. CAUTION:  This capability works only with C or ASM code, NOT with 
  18.           Clipper-compiled code because the Clipper compiler mixes near and
  19.           far calls.  You may place your Clipper-compiled objects into
  20.           overlays, but be careful not to call a module in the same 
  21.           overlay area.
  22.  
  23. NOTE:
  24.  
  25. We have chosen modules to be placed into the overlay area which are not
  26. likely to be called recursively, i.e. into DO-WHILE or FOR-NEXT loops, 
  27. otherwise the reloading of the modules which slow down the speed of 
  28. applications.  If you experience excessive slowing in your application
  29. due to one of these modules, simply remove the module name from the
  30. overlay area so it will link into the main memory area.
  31.  
  32. We have supplied a new version of the Clipper EXTEND.LIB library for use
  33. with the .RTLINK linker.  This new library is named DCEXTEND.LIB and it 
  34. contains the exact same modules as the Clipper EXTEND.LIB except the modules
  35. have been renamed from _ASM_ASM to the actual name of the object so that
  36. .RTLINK can link them into an overlay area using the MODULE command.  You
  37. may use the DCEXTEND.LIB library in place of the EXTEND.LIB library in all
  38. your applications and place the modules into overlays with the MODULE command
  39. provided with both PLINK86 and .RTLINK.
  40.  
  41.  
  42. How to create a DCLIP Developer's Engine with .RTLINK
  43. -------------------------------------------------------
  44.  
  45. 1. Declare the EXTERNALS for the desired functions from any third party
  46.    libraries in the in the DCLIPRTL.PRG file.
  47.  
  48. 2. Compile the file DCLIPRTL.PRG as follows:
  49.  
  50.    CLIPPER DCLIPRTL -m -l
  51.  
  52. 3. Add the third party library names to the LIB list in the DCLIPRTL.LNK
  53.    file.
  54.  
  55. 4. Build the DCLIPRTL.EXE Engine as follows:
  56.  
  57.    RTLINK @DCLIPRTL.LNK
  58.  
  59.  
  60. How to create a DCLIPRUN Runtime Engine with .RTLINK
  61. ------------------------------------------------------
  62.  
  63. 1. Declare the EXTERNALS for the desired functions from any third party
  64.    libraries in the DCRUNRTL.PRG file.
  65.  
  66. 2. Compile the file DCRUNRTL.PRG as follows:
  67.  
  68.    CLIPPER DCRUNRTL -m -l
  69.  
  70. 3. Add the third party library names to the LIB list in the DCRUNRTL.LNK
  71.    file.
  72.  
  73. 4. Build the DCRUNRTL.EXE Engine as follows:
  74.  
  75.    RTLINK @DCRUNRTL.LNK
  76.  
  77.  
  78.