home *** CD-ROM | disk | FTP | other *** search
/ PC Press 1997 July / Sezamfile97_1.iso / msdos / clipper / ct3p.a01 / README.CTP < prev    next >
Text File  |  1993-12-15  |  5KB  |  156 lines
  1. CA-Clipper Tools 
  2. Version 3.0
  3. Protected-Mode Upgrade
  4. December 1993
  5.  
  6. This file contains information about an upgrade to CA-Clipper Tools, 
  7. Version 3.0, so that it can be used with CA-Clipper/ExoSpace to create 
  8. applications that run in protected-mode.
  9.  
  10. You should have the following products installed before continuing:
  11.   * CA-Clipper Tools, Version 3.0 
  12.   * CA-Clipper, Version 5.2c or later
  13.   * CA-Clipper/ExoSpace, Version 1.0a or later
  14.  
  15. Note that any versions of CA-Clipper/ExoSpace earlier than version 1.0e 
  16. will be upgraded so that they are at the 1.0e release.  
  17.  
  18. Also note that it is highly recommended that you back up the current 
  19. versions of the above products before performing this upgrade.
  20.  
  21. This file is divided into the following sections:
  22.   * Installation Instructions
  23.   * List of Installed Files
  24.   * Linking CA-Clipper Tools Programs with CA-Clipper/ExoSpace 
  25.   * The IPXCT Package
  26.   * Special Considerations
  27.  
  28.  
  29. =============================================================================
  30. Installation Instructions
  31.    
  32. To perform this upgrade:
  33.  
  34. 1. Insert the Installation diskette in drive A (or B).
  35.  
  36. 2. Switch to the A (or B) drive.
  37.  
  38. 3. Type INSTALL.
  39.  
  40. The Installer is invoked--this component manages the installation process 
  41. from this point forward.  Follow the instructions on your screen to proceed 
  42. with the installation; the CA-Clipper Tools and CA-Clipper/ExoSpace files 
  43. will be installed in the locations you specify.  
  44.  
  45.  
  46. =============================================================================
  47. List of Installed Files
  48.  
  49. File            Contents
  50. -----------------------------------------------------------------------------   
  51. CTP.LIB         CA-Clipper Tools library that is required to link with 
  52.                 CA-Clipper/ExoSpace. 
  53.                 It is the protected-mode version of CT.LIB, and should be 
  54.                 used in the same way as CT.LIB.  
  55.  
  56. CTUSP.OBJ       CA-Clipper Tools object file that is required to link with 
  57.                 CA-Clipper/ExoSpace.   
  58.                 It is the protected-mode version of CTUS.OBJ, and should be 
  59.                 used in the same way as CTUS.OBJ. 
  60.  
  61. CTINTP.OBJ      CA-Clipper Tools object file that is required to link with 
  62.                 CA-Clipper/ExoSpace. 
  63.  
  64.                 This file MUST BE USED in order to set the proper CA-Clipper
  65.                 Tools environment.  Failure to link in CTINTP.OBJ may cause 
  66.                 unpredictable results.
  67.  
  68. EXOSPACE.EXE    Updated CA-Clipper/ExoSpace program.
  69.  
  70. EXOSPACE.NG     Updated CA-Clipper/ExoSpace Norton Guide file.
  71.  
  72. NBDCHAT.PRG     Updated CA-Clipper Tools sample NETBIOS chatting program.
  73.  
  74.  
  75. =============================================================================
  76. Linking CA-Clipper Tools Programs with CA-Clipper/ExoSpace 
  77.  
  78. Getting your CA-Clipper Tools applications up and running with 
  79. CA-Clipper/ExoSpace is really very simple.  You just need to change your
  80. link command line and then relink your CA-Clipper Tools program using 
  81. CA-Clipper/ExoSpace.  
  82.  
  83.  
  84. Real-Mode Applications
  85. ----------------------
  86.  
  87. To create a real-mode Tools application, you typically link a CA-Clipper 
  88. Tools program with a real-mode linker (be sure to include CT.LIB and, 
  89. optionally, CTUS.OBJ).  
  90.  
  91. For example:
  92.  
  93. CLIPPER test 
  94. RTLINK FILE test,ctus LIBRARY ct
  95.  
  96.  
  97. Protected-Mode Applications
  98. ---------------------------
  99.  
  100. To create a protected-mode Tools application with CA-Clipper/ExoSpace, 
  101. you need to:
  102.  
  103. 1. Use the EXOSPACE linker instead of a real-mode linker (i.e., RTLINK).
  104.  
  105. 2. Include CTINTP.OBJ (and optionally CTUSP.OBJ) in the FILE command.
  106.  
  107. 3. Include CTP.LIB in the LIBRARY command.
  108.  
  109. 4. Include the DOS25 package in the EXOSPACE PACKAGE command.
  110.  
  111. For example:
  112.  
  113. CLIPPER test 
  114. EXOSPACE EXOSPACE PACKAGE DOS25 FILE test,ctusp,ctintp LIBRARY ctp
  115.  
  116.  
  117. Once your CA-Clipper Tools application has been linked with 
  118. CA-Clipper/ExoSpace, you should then be able to run the resulting .EXE as
  119. easily as a CA-Clipper Tools real-mode application.  (You must run the 
  120. application in a system which meets the minimum system requirements for 
  121. CA-Clipper/ExoSpace.)
  122.  
  123. Please refer to your CA-Clipper/ExoSpace documentation for complete details
  124. on linking, command syntax, and using script files.
  125.  
  126.  
  127. =============================================================================
  128. The IPXCT Package
  129.  
  130. The new version of EXOSPACE.EXE installed with this upgrade includes a new
  131. package: IPXCT.  
  132.  
  133. IPXCT should only be used with protected-mode CA-Clipper Tools applications.
  134.  
  135. It allows you to utilize the point-to-point communications and 
  136. print server functions.  It must be specified in the EXOSPACE PACKAGE script
  137. command when linking an application that calls any point-to-point 
  138. communication function (see Chapter 31) or Print Server Access function 
  139. (see Chapter 27).
  140.  
  141. For example:
  142.  
  143. CLIPPER test
  144. EXOSPACE EXOSPACE PACKAGE DOS25,IPXCT FILE test,ctusp,ctintp LIBRARY ctp
  145.  
  146.  
  147. =============================================================================
  148. Special Considerations
  149.  
  150. Communication functions may have problems if COM2 is used and you 
  151. are not under DPMI (this may occur in the MINITERM sample program when 
  152. using COM2).  In such a case, the package NOVM should be used.
  153.  
  154.  
  155.                                   ***
  156.