home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c004 / 4.ddi / NETBIOS / README.NET < prev   
Encoding:
Text File  |  1989-04-18  |  8.5 KB  |  259 lines
  1. c-tree(R) V4.3 Release C
  2. February 7, 1989 17:30
  3.  
  4. ---------
  5. General
  6. ---------
  7.  
  8. Two of the c-tree netbios servers are TSR's which reside in the background
  9. on a non-dedicated node. This node may also be used for other foreground
  10. activities (but the performance of the server and the foreground
  11. task will clearly be mutually degraded).
  12.  
  13.  
  14. There are three netbios oriented servers:
  15.  
  16.     - two servers run in a naked Netbios environment and DO NOT
  17.       require any network software; except, of course, that netbios
  18.       be operational.  One of these servers (ctsrvr.exe) is a TSR which
  19.       operates as a non-dedicated server.  The other of these servers
  20.       (ctsrvrfg.exe) is a dedicated server.  It is suitable in environments
  21.       which cannot support the TSR and/or for which heavy demand on the
  22.       server necessitates improved performance.  (The dedicated server
  23.       does not perform task switching and is more efficient.)
  24.  
  25.       The netbios software (which we mentioned above and which
  26.       we DO NOT distribute) supports background message handling
  27.       between connected nodes. ARCNET cards are frequently used to
  28.       interconnect the nodes using Netbios.
  29.       
  30.       Use MAKESRV {S or C} to create two naked netbios c-tree servers in
  31.       the small or compact memory model (ctsrvr.exe & ctsrvrfg.exe).
  32.       
  33.       MAKEAPP {S or C or M or L} creates the c-tree library and
  34.       examples for use with these servers (e.g., ctexmg.exe).
  35.  
  36.       
  37.     - the third server runs in IBM PC-NET or compatible (e.g., CBIS
  38.       Network-OS) environments as a TSR non-dedicated server.
  39.       This environment places a layer above Netbios in which 
  40.       more tightly coupled communication takes place as well
  41.       as providing services such as mapping directories over the net.
  42.      
  43.       Use MAKESRVX {S or C} to create a network based c-tree server in the
  44.       small or compact memory model (ctsrvrx.exe).
  45.  
  46.       MAKEAPPX {S or C or M or L} creates the c-tree library and
  47.       examples for use with this server (e.g., ctexmgx.exe).
  48.  
  49.       NOTE: MAKEAPPX CREATES EXECUTABLE MODULES WITH NAMES THE SAME
  50.       AS MAKEAPP EXCEPT THAT AN x IS APPENDED TO THE NAME.
  51.       
  52.       When starting your network, you can specify the size of
  53.       the message buffers with the /RQB:n parameter (which may default 
  54.       to 8192 bytes).  Make sure n is at least as large as the c-tree
  55.       server message size (controlled with the Z command line
  56.       argument).  Check your network documentation if you wish to use
  57.       a value other than the system default.
  58.       
  59.       DO NOT USE /TSI:00 time slice setting when starting your
  60.       network. Other values are OK.  Check your network documentation
  61.       if you wish to use a time slice ratio different than the system
  62.       default.
  63.  
  64. Make sure that the c-tree TSR (ctsrvr.exe or ctsrvrx.exe) is the
  65. last TSR loaded if you wish to run ctstop(x).exe to stop the c-tree
  66. server and release its memory.
  67.  
  68.  
  69. ---------
  70. Novell Netbios Emulation
  71. ---------
  72.  
  73. If you use the c-tree server with Novell's Advanced Netware 2.0 (or earlier)
  74. under their Netbios emulation, you must use the c-tree (naked) Netbios
  75. server. With Advanced Netware 2.1 or later, you may c-tree as a
  76. VAP (see \ctree\novell\readme.nov); or may may use the c-tree Netbios
  77. server under Netbios emulation.
  78.  
  79. Release C corrects a problem which caused jobs running in the foreground
  80. to close files maintained by the background (TSR) c-tree server. Now you
  81. do not need to dedicate a node to the c-tree server in a Novell network
  82. using Netbios emulation.
  83.  
  84.  
  85. ---------
  86. CONTROL-C and DOS CRITICAL ERRORS
  87. ---------
  88.  
  89. The following information is important to MS-DOS developers that use special
  90. control-c (interrupt 23) or critical error (interrupt 24) handlers. 
  91. The handlers may be explicitly coded or embedded, for example, in a
  92. your console i/o library.  As shipped, c-tree installs interrupt 23 & 24
  93. handlers which cleanup the c-tree environment.  To change this default,
  94. change the contents of CTAXIT.H for CBRKmode and CERRmode as outlined
  95. in README.CUP.
  96.  
  97.  
  98. ---------
  99. Compiler
  100. ---------
  101.  
  102. The Microsoft compiler and macro assembler were chosen for this 
  103. development. Use of another compiler will require changes to the 
  104. assembly code which is compatible with the Microsoft segment 
  105. conventions.
  106.  
  107. Also, the make files are set up for the Microsoft compiler.
  108.  
  109.  
  110. ---------
  111. Tuning
  112. ---------
  113.  
  114. For the net bios version, increase SRV_RNCBS and SRV_SNCBS in ctnbcfg.h
  115. as the number of users increases.
  116.  
  117. For the network version, set /REQ:n (NET START or NWSTART switch) as high
  118. as possible or to the maximum number of users. Check your network
  119. documentation for details.
  120.  
  121.  
  122. ---------
  123. Full pathname construction
  124. ---------
  125.  
  126. When the c-tree server receives a filename from a user, a fully 
  127. qualified path is constructed as follows:
  128.  
  129.     - User name has no drive prefix and no leading slash delimiter.
  130.       The current drive/directory that the server was started in
  131.       is added to the user name.
  132.  
  133.     - User name has no drive prefix but has leading slash.
  134.       The current drive is added to the user name.
  135.  
  136.     - User name has a drive prefix but no leading slash.
  137.       If the drive is the server's startup current drive, then
  138.       the startup current directory is added to the user name
  139.       If the drive is not the server's startup drive, then a
  140.       leading slash is added.
  141.  
  142. The following examples assume the server was started in C:\CT.
  143.  
  144.     User name            Full Path
  145.     ------------------        -------------------
  146.     CUST.IDX            C:\CT\CUST.IDX
  147.     DATA/CUST.IDX            C:\CT\DATA\CUST.IDX
  148.     D:CUST.IDX            D:\CUST.IDX
  149.     D:DATA\CUST.IDX            D:\DATA\CUST.IDX
  150.     ../CUST.IDX            C:\CUST.IDX
  151.     \CT\CUST.IDX            C:\CT\CUST.IDX
  152.  
  153.  
  154. ---------
  155. Starting c-tree file server network version
  156. ---------
  157.  
  158. CTSRVRX must be run on a machine that is configured as a network server.
  159. The server must share a resource named CTREE.  For a user to access the
  160. server, network commands should be used to first establish a connection
  161. to the server (except for the user at the non-dedicated server).
  162. Following are example startups for servers.
  163.  
  164.     IBM PC Networks            CBIS Network-OS
  165.     ------------------------    ------------------------
  166.     net start srv servername    nwstart ns servername
  167.     net share ctree=c:\        nwshare ctree c:\
  168.     ctsrvrx                ctsrvrx
  169.     your-application (optional)    your-application (optional)
  170.  
  171. Example startups for workstations:
  172.  
  173.     IBM PC Networks            CBIS Network-OS
  174.     ------------------------    ------------------------
  175.     net start rdr username        nwstart ws username
  176.     net use e: \\servername\ctree    nwuse e: \\servername\ctree
  177.     your-application (optional)    your-application (optional)
  178.  
  179.  
  180. ---------
  181. Math Chip
  182. ---------
  183.  
  184. Only one process at a server should use the math chip.  Unless you modify
  185. the
  186.  
  187.     #define NO_FPLIB
  188.     
  189. in the CTCOMP.C module, the c-tree server will not use any floating point
  190. operations.
  191.  
  192.  
  193. ----------
  194. Make files
  195. ----------
  196.  
  197. The following batch files can be used to build libraries, servers and
  198. applications:
  199.  
  200.  
  201.     Network        Netbios
  202.     version        version
  203.     ------------    ------------
  204.     MAKESRVX.BAT    MAKESRV.BAT    Make c-tree server
  205.     MAKEAPPX.BAT    MAKEAPP.BAT    Make application library and examples
  206.     
  207. The syntax of the make commands, which are set up for the Microsoft C
  208. environment, are
  209.  
  210.         MAKESRV(X) {C or S}        C=compact model
  211.                         S=small model
  212.         MAKEAPP(X) {S, C, M or L}    M=medium model
  213.                         L=large
  214.  
  215. ----------
  216. Special switch in ctoptn.h
  217. ----------
  218.  
  219. For the server extension version of the c-tree server, CTS_CPLD must
  220. be defined.  For the net bios version, define either CTS_INDP or
  221. CTS_CPLD.
  222.  
  223.  
  224. ------------
  225. Special Source files
  226. ------------
  227.  
  228. Used for both versions:
  229.  
  230.     DOS     H     8086 register structures (Supplied with C Compiler)
  231.  
  232.     CTAXIT     H     configuration definitions for aborted applications
  233.     CTNBIO   H     netbios data strutures, cmd codes, etc
  234.     CTNBIOS  C     call netbios functions
  235.     CTSPRTF  C     printf for tsr program
  236.     CTFULNAM C     convert user file name to full path
  237.     ASM      INC   asm lang for c model definitions, macros, etc
  238.     CTAXIT     ASM   error handler for aborted applications
  239.  
  240. Used for Net bios version:
  241.  
  242.     CTNBCFG  H     user changable config parms
  243.     CTSMSG   C     sys-dependent for server
  244.     CTAMSG   C     sys-dependent for application
  245.     CTSFG     ASM   dedicated server front-end
  246.     CTSTSR   ASM   task-switch
  247.  
  248. Used for file server extension version:
  249.  
  250.     CTSXCFG  H     user changable config parms
  251.     CTSMSGX  C     sys-dependent for server
  252.     CTSRVX   ASM   file-server linkage, tsr support
  253.     CTAMSGX  C     sys-dependent for application
  254.     CTAMSGXA ASM   sys-dependent asm for application
  255.  
  256. ---------
  257. end
  258. ---------
  259.