home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c004 / 3.ddi / NOVELL / README.NOV < prev   
Encoding:
Text File  |  1989-04-18  |  6.2 KB  |  169 lines
  1. c-tree V4.3 Release C
  2. February 7, 1989 17:30
  3.  
  4. ---------
  5. General
  6. ---------
  7.  
  8. The c-tree VAP server is designed for Advanced Netware 2.1 or later.
  9. IT WILL NOT RUN WITH EARLIER VERSIONS OF NETWARE. (USE NETBIOS EMULATION
  10. WITH EARLIER VERSIONS OF NETWARE, AND SEE THE CODE AND README IN THE
  11. NETBIOS DIRECTORY.)
  12.  
  13. A VAP is an executable module especially designed to run as an extension
  14. of the Novell kernel. As such, it sits with the dedicated 2.1 Server node.
  15.  
  16. Novell has granted permission for FairCom to distribute excerpts from
  17. their libraries used to make calls to the netware environment. These
  18. libraries are based on Microsoft C V5.
  19.  
  20.     NOV$SVAP.LIB - small memory model, VAP based calls
  21.     NOV$CVAP.LIB - compact memory model, VAP based calls
  22.     NOV$SAPP.LIB - small memory model, APPLICATION based calls
  23.     NOV$LAPP.LIB - large memory model, APPLICATION based calls
  24.     
  25. The small memory model VAP limits the file, index buffer and user memory areas.
  26. Our initial configuration is for
  27.  
  28.     - 8 users
  29.     - 100 files
  30.     - 32 index buffers (each 512 bytes)
  31.     
  32. Roughly speaking, each user requires about 1K bytes which is about as much
  33. memory as is required for 5 files (where each data file and each index counts 
  34. as one file) or 2 (512 byte) index buffers.  Note that when the same file 
  35. is opened by more than one user, only one file slot is required.
  36.  
  37. The compact memory model VAP uses a larger data area and can accommodate
  38. many more users files and file buffers.
  39.  
  40. ---------
  41. Message Size
  42. ---------
  43.  
  44. The maximum message size, which should already be set in your Novell CTCOMM.H,
  45. is 534. In CTAPPX.C, be sure that DEFASIZ and MAXSIZ are set to this value.
  46.  
  47. ---------
  48. Compiler
  49. ---------
  50.  
  51. The Microsoft compiler and macro assembler were chosen for this development. Use
  52. of another compiler will require changes to the assembly code 
  53. which is now compatible with the Microsoft segment conventions.
  54.  
  55. Also, the make files are set up for the Microsoft compiler and the Novell
  56. libraries are based on Microsoft.  (Novell will be marketing a complete
  57. Netware interface library and presumably versions for different compilers
  58. will be available.  Check with Novell for details.)
  59.  
  60. ---------
  61. Make Files
  62. ---------
  63.  
  64. Before compiling a c-tree VAP server, be sure to move the ctcomm.h provided 
  65. in the novell sub-directory to the main c-tree directory.  Use MAKESRV S
  66. to create the small model c-tree VAP server in the SSRV subdirectory
  67. (ctree\novell\ssrv\ctsrvrs.vap).  Use MAKESRV C to create the compact
  68. model VAP in the CSRV subdirectory (ctree\novell\csrv\ctsrvrc.vap).
  69. Use MAKEAPP {S or L} to create c-tree application libraries and the
  70. examples in the mAPP sub-directory where m is S or L depending on the
  71. memory model chosen.
  72.  
  73. ---------
  74. Service Advertising Protocol
  75. ---------
  76.  
  77. This c-tree VAP server does not utilize the Novell Service Advertising
  78. Protocol which allows requesters to locate servers on the internet. Instead,
  79. the module CTAMSG.C (which is linked with your applications) uses the
  80. following default network address for the c-tree server:
  81.  
  82.     Server Network Number        00 00 00 00 (all zero implies
  83.                              requester in same network
  84.                              as server)
  85.     Server Node Address      00 00 00 00 00 01
  86.     
  87. You can modify these defaults as follows:
  88.  
  89.     1) copy the four byte Network Number into the four byte global
  90.        char array netnum[].
  91.     2) copy the six byte Node Address into the six byte global char
  92.        array nodadr[].
  93.        
  94. These copy operations should be performed by your application prior to
  95. calling any c-tree functions. NOTE that these addresses are expressed
  96. as right-justified hexadecimal values. Each byte holds two hexadecimal
  97. characters. For example, a Node Address of 23A5F4E could be represented as
  98.  
  99.         TEXT nodadr[] = {0,0,0x02,0x3A,0x5F,0x4E};
  100.  
  101. ---------
  102. Disconnections
  103. ---------
  104.  
  105. Novell's message watchdog facility which detects dropped and/or bad
  106. connections is now working with the c-tree server.  A dropped and/or bad
  107. connection will now cause the application to be automatically logged off
  108. the c-tree server.  Combined with the ^C and DOS Critical Errors discussed
  109. below, c-tree can now properly log off applications which abnormally
  110. terminate.
  111.  
  112. ---------
  113. CONTROL-C and DOS CRITICAL ERRORS
  114. ---------
  115.  
  116. The following information is important to MS-DOS developers that use special
  117. control-c (interrupt 23) or critical error (interrupt 24) handlers. 
  118. The handlers may be explicitly coded or embedded, for example, in a
  119. your console i/o library.  As shipped, c-tree installs interrupt 23 & 24
  120. handlers which cleanup the c-tree environment.  To change this default,
  121. change the contents of CTAXIT.H for CBRKmode and CERRmode as outlined
  122. in README.CUP.
  123.  
  124. ---------
  125. Server Login
  126. ---------
  127.  
  128. Advanced Netware 2.1 loads a VAP at the time the network server is booted.
  129. If you have copied the c-tree executable server (CTSRVR.VAP) to the SYSTEM
  130. directory of the NOVELL server, then you will be asked if you want the
  131. VAP(s) loaded. Respond y.  You will then see the c-tree Server banner.
  132.  
  133. BEFORE ATTEMPTING TO LOAD THE c-tree VAP SERVER IN THIS MANNER, BE SURE
  134. that the system administrator has created a network user with the name
  135. CTREEV4-3, no password, and the desired file creation and update
  136. attributes.  (See the NOVELL documentation for the use of SYSCON in order
  137. to add new users).  If no such user exists, then the c-tree VAP will
  138. load without error, but it will not operate properly.  You can detect
  139. a login problem as follows:  The last line of the c-tree VAP banner
  140. will either appear as
  141.  
  142.     login:0    or login:252
  143.  
  144. A non-zero login value indicates a server login problem.  Be sure
  145. the CTREEV4-3 user is part of your network.
  146.  
  147. ---------
  148. Novell Library Function Names
  149. ---------
  150.  
  151. In the event that the Novell function names referenced by c-tree in the
  152. CTAMSG.C and CTSMSG.C modules must be changed (either because Novell
  153. has changed their naming convention or because you require the functions
  154. to have all UPPER case names), examine the CTMSSG.H module.  Beginning
  155. around line 85, there are a series of defines which you can modify to
  156. the desired function names.
  157.  
  158. For example,
  159.  
  160. #define IPXdatadr    IPXGetDataAddress
  161.  
  162. could be changed to
  163.  
  164. #define IPXdatadr    IPXGETDATAADDRESS
  165.  
  166. ---------
  167. end
  168. ---------
  169.