home *** CD-ROM | disk | FTP | other *** search
/ Datatid 1999 #6 / Datatid_1999-06.iso / internet / Tango352Promo / P.SQL / PTKPKG.1 / README.TXT < prev    next >
Encoding:
Text File  |  1999-02-03  |  27.7 KB  |  771 lines
  1.  
  2. +--------------------------------------------------------------+
  3. |         **** README FOR THE DOS TCP REQUESTER ****           | 
  4. |                                                              |
  5. |  Configuring the Btrieve DOS Requester for TCP/IP - BREQTCP  |
  6. |                                                              |
  7. |               Pervasive Software, Inc.                       |
  8. |               12365 Riata Trace Parkway, Bldg. II            |
  9. |               Austin, Texas  78727                           |
  10. |               (800) 287-4383                                 |
  11. |                                                              |
  12. +--------------------------------------------------------------+
  13.  
  14. BREQTCP is a TCP/IP Btrieve Requester for DOS and DOS boxes
  15. on Windows 95 and NT. You must load the Btrieve DOS
  16. Requester at a workstation running DOS before that
  17. workstation can access network data files.
  18.  
  19. This document contains the following sections:
  20.  
  21.     *    Components of the Btrieve TCP/IP Requester
  22.     *    System requirements to install the Btrieve TCP/IP Requester
  23.     *    About the Btrieve TCP/IP Requester
  24.     *    Installation instructions for the BREQTCP
  25.             - Windows NT
  26.             - Windows 95
  27.             - DOS/Windows 3.x
  28.     *    Loading the Btrieve DOS Requesters
  29.     *    Unloading the Btrieve DOS Requesters
  30.     *    Accessing Btrieve for NetWare servers
  31.     *    Known Issues
  32.     *    Btrieve DOS Requester Options
  33.     *    Disclaimer    
  34.  
  35. **********************************************************************
  36. **********************************************************************
  37.  
  38. *** COMPONENTS OF THE BTRIEVE TCP/IP REQUESTER  ***
  39.  
  40. These components reside in C:\PVSW\Clients\Dos\TCP:
  41.  
  42.    - DOS TCP/IP Requesters - BREQTCP.EXE, BREQTCP.MSG
  43.    - VSL DOS components - M3OPEN.EXE, MNOVLWP.EXE, MFTP22.EXE
  44.    - VSL Windows 95 Components - JSBDOSWS.VXD
  45.    - VSL Windows NT Components - JSBDOSWS.EXE, JSBDOSWS.DLL
  46.    - VSL Platform specific configuration files - VSLDOS.WNT, 
  47.      VSLDOS.W95, VSLDOS.M3, VSLDOS.LWP, VSLDOS.FTP
  48.    - VSL Multiplatform resource file - MSOCKLIB.RC
  49.    - This file (README.TXT)
  50.  
  51. **********************************************************************
  52. **********************************************************************
  53.  
  54. *** SYSTEM REQUIREMENTS FOR Btrieve TCP/IP Requester ***
  55.  
  56. Server software requirements
  57.   - Pervasive.SQL 7.0
  58.   - TCP/IP configured correctly at server
  59.   - refer to Getting Started for more information about software
  60.     requirements
  61.  
  62. You must have one of the following operating systems:
  63.   - Windows NT 4.0 or greater
  64.   - Windows 95
  65.   - DOS 5.0 or greater
  66.   - Windows 3.1 or Windows For Workgroups
  67.  
  68. For DOS, you must have one of the following TCP/IP stacks:
  69.   - Microsoft LAN Manager
  70.   - Novell LAN Workplace
  71.   - FTP Software 2.2 or greater
  72.  
  73. **********************************************************************
  74. **********************************************************************
  75.  
  76. *** ABOUT BREQTCP: BTRIEVE TCP/IP REQUESTER ***
  77.  
  78.  
  79. BREQTCP.EXE is a new DOS executable that runs on various DOS and Windows
  80. platforms. It is built using JSB Corporation's Virtual Socket
  81. Library (VSL). VSL implements an API based on the Berkeley 4.3
  82. sockets standard that enables development of platform-independent
  83. and transport-independent network applications. For information about
  84. JSB Corporation, visit their site at http://www.jsb.com.
  85.  
  86.  
  87. BREQTCP Specifications at a Glance:
  88. -----------------------------------
  89. * Used to access files on these servers
  90.          - Windows NT
  91.          - NetWare
  92.  
  93. * Requester can be run on the following operating systems
  94.          - Windows 95/NT DOS Box
  95.          - DOS 5.0 or greater
  96.          - Windows 3.1 or Windows For Workgroups
  97.  
  98. * Conventional memory required to load with defaults
  99.          - Windows NT
  100.            - BREQTCP.EXE   81984 
  101.            - JSBDOSWS.EXE  30400 (Upper memory)
  102.          - Windows 95
  103.            - BREQTCP.EXE   85792
  104.            - JSBDOSWS.VXD      0 (No conventional memory used)
  105.          - DOS 5.0 or greater
  106.            - BREQTCP.EXE   81456
  107.            - M3OPEN.EXE    43280 (Microsoft Lan Manager)
  108.            - MNOVLWP.EXE   66880 (Novell Lan Workplace)
  109.            - MFTP22.EXE    69424 (FTP Software PC/TCP) 
  110.          
  111.  
  112. **********************************************************************
  113. **********************************************************************
  114.  
  115.  
  116. *** WINDOWS NT:  CONFIGURATION OF THE BREQTCP REQUESTER ***
  117.     (see following procedures for Windows 95 or DOS instructions)
  118.  
  119.  
  120. To Configure BREQTCP for the first time under Windows NT:
  121. ---------------------------------------------------------------------
  122.  
  123. 1.The files that are relevant to Windows NT are the following
  124.   (in \PVSW\Clients\Dos\TCP):
  125.  
  126.    JSBDOSWS.EXE
  127.    JSBDOSWS.DLL
  128.    MSOCKLIB.RC
  129.    VSLDOS.WNT
  130.    BREQTCP.EXE
  131.    BREQTCP.MSG
  132.    README.TXT
  133.  
  134. 2. Copy BREQTCP.EXE, BREQTCP.MSG, JSBDOSWS.EXE, JSBDOSWS.DLL, 
  135.    MSOCKLIB.RC, and VSLDOS.WNT into your %SystemRoot%\SYSTEM 
  136.    directory. %SystemRoot% refers to your Windows directory, 
  137.    typically C:\WINNT.  You can determine the value for 
  138.    %SystemRoot% by opening a DOS box and entering the SET command.  
  139.    
  140. 3. Rename VSLDOS.WNT to VSLDOS.INI in your %SystemRoot%\SYSTEM
  141.    directory.
  142.  
  143. 4. Click Start, point to Settings, and Select Control Panel.
  144.  
  145. 5. Double-click System and click the Environment tab.
  146.  
  147. 6. Add the following environment variable:
  148.  
  149.        VSL=%SystemRoot%\SYSTEM
  150.  
  151.    Note: There must NOT be a trailing semicolon in this statement.
  152.  
  153.  
  154. 7.  Installation is now complete. Skip to "Running your BREQTCP
  155.     requester after installation."
  156.  
  157. **********************************************************************
  158. **********************************************************************
  159.  
  160.  
  161. *** WINDOWS 95:  CONFIGURATION OF THE BREQTCP REQUESTER ***
  162.     (for Windows NT, see preceding procedure)
  163.     (for DOS, see following procedure)
  164.  
  165.  
  166. 1.The files that are relevant to Windows 95 are the following 
  167.   (in \PVSW\Clients\Dos\TCP):
  168.  
  169.      JSBDOSWS.VXD
  170.      MSOCKLIB.RC
  171.      VSLDOS.W95
  172.      BREQTCP.EXE
  173.      BREQTCP.MSG
  174.      README.TXT 
  175.  
  176. 2. Copy BREQTCP.EXE, BREQTCP.MSG, JSBDOSWS.VXD, MSOCKLIB.RC, 
  177.    and VSLDOS.W95 into your %windir%\SYSTEM directory. Rename 
  178.    VSLDOS.W95 to VSLDOS.INI.  %windir% refers to your Windows 
  179.    directory, typically C:\WINDOWS.  You can determine the value 
  180.    for %windir% by opening a DOS box and entering the SET command.  
  181.  
  182. 3. Rename VSLDOS.W95 to VSLDOS.INI in your %windir%\SYSTEM
  183.    directory.
  184.  
  185. 4. Use a text editor such as Notepad to edit your AUTOEXEC.BAT file
  186.    located in your root directory.
  187.  
  188.    Add the following line to the end of the file.
  189.  
  190.           SET VSL=%windir%\SYSTEM
  191.  
  192.    Note: Replace %windir% with your actual Windows directory.  
  193.          For example, SET VSL=C:\WINDOWS\SYSTEM
  194.  
  195. 5. Edit your SYSTEM.INI file with a text editor such as
  196.    Notepad. SYSTEM.INI is a Windows system file that is
  197.    located in your Windows directory (for example, C:\WINDOWS).
  198.    In the section [386enh], add a new line:
  199.  
  200.       DEVICE=JSBDOSWS.VXD
  201.  
  202. 6. Restart Windows 95 to register your changes.
  203.  
  204. 7. Installation is now complete. Skip to "Running your BREQTCP
  205.    requester after installation."
  206.  
  207. **********************************************************************
  208. **********************************************************************
  209.  
  210.  
  211. *** DOS 5.0 or greater:  CONFIGURATION OF THE BREQTCP REQUESTER ***
  212.     (for Windows NT or Windows 95, see preceding procedures)
  213.  
  214.  
  215. 1. The files that are relevant to DOS are the following 
  216.    (in \PVSW\Clients\Dos\TCP):
  217.  
  218.    M3OPEN.EXE
  219.    MNOVLWP.EXE
  220.    MFTP22.EXE
  221.    MSOCKLIB.RC
  222.    VSLDOS.M3
  223.    VSLDOS.LWP
  224.    VSLDOS.FTP
  225.    BREQTCP.EXE
  226.    BREQTCP.MSG
  227.  
  228. 2. Copy BREQTCP.EXE, BREQTCP.MSG, M3OPEN.EXE, MNOVLWP.EXE, 
  229.    MFTP22.EXE, MSOCKLIB.RC, and VSLDOS.* into the target
  230.    directory.  
  231.    
  232.    a. If you are running Windows 3.x, the target directory is 
  233.       the %windir%\SYSTEM directory.  
  234.       
  235.    b. If you are running DOS only, the target directory is the
  236.       directory where you installed the Pervasive.SQL DOS client
  237.       software.  
  238.       
  239. 3. Rename your VSLDOS file to VSLDOS.INI in your target directory.
  240.  
  241.    If your TCP stack is            Rename this file to VSLDOS.INI
  242.    -----------------------         ------------------------------
  243.    Microsoft LAN Manager           VSLDOS.M3
  244.    Novell LAN Workplace            VSLDOS.LWP
  245.    FTP Software                    VSLDOS.FTP
  246.  
  247.  
  248. 4. Edit your AUTOEXEC.BAT file located in your root directory.
  249.  
  250.       Add the following line to the file:
  251.  
  252.           SET VSL=[jsb-location]
  253.  
  254.       where [jsb-location] is the fully-qualified path
  255.       of the directory where you placed the VSLDOS.INI file.
  256.       For example, C:\WINDOWS\SYSTEM if you use Windows 3.x or
  257.       C:\PVSW\BIN for DOS.
  258.  
  259. 5.  Restart your computer to register the AUTOEXEC.BAT changes.
  260.  
  261. 6.  Installation is now complete. Skip to "Running your BREQTCP
  262.     requester after installation."
  263.  
  264. **********************************************************************
  265. **********************************************************************
  266.  
  267.  
  268. *** RUNNING YOUR BREQTCP REQUESTER AFTER CONFIGURATION ***
  269.  
  270. WINDOWS NT
  271. ----------
  272. *  In Windows NT, first run JSBDOSWS.EXE. Then load BREQTCP and
  273.    then finally your application in the SAME DOS box.
  274.    You can make a batch file to accomplish this.
  275.  
  276. *  For example: (sample batch file)
  277.  
  278.    %SystemRoot%\SYSTEM\JSBDOSWS
  279.    %SystemRoot%\SYSTEM\BREQTCP
  280.    YourApp.exe
  281.    
  282. *  You may be able to save conventional memory by loading JSBDOSWS.EXE
  283.    in upper memory by using the "load high" command lh in the 
  284.    %SystemRoot%\SYSTEM32\AUTOEXEC.NT batch file.  Loading JSBDOSWS.EXE from
  285.    the AUTOEXEC.NT batch file ensures that the JSB VSL is loaded when
  286.    you start a DOS command.  For example:
  287.    
  288.    lh %SystemRoot%\SYSTEM\JSBDOSWS
  289.  
  290. *  You may verify that JSBDOSWS.EXE and BREQTCP.EXE are loaded 
  291.    by using the MEM /c utility from a command prompt.
  292.  
  293. WINDOWS 95
  294. -------------
  295.  
  296.    Note:   Under Windows 95, only one DOS box at a time
  297.            can be used as a Btrieve requester. You must terminate
  298.            the first DOS box before another DOS box can use the
  299.            BREQTCP requester. This restriction is not present
  300.            in Windows NT.
  301.  
  302. *  In Window 95, first load BREQTCP and then load your Btrieve
  303.    application in the DOS box.
  304.  
  305. *  For example: (sample batch file)
  306.  
  307.    BREQTCP
  308.    YourApp.exe
  309.  
  310. *  You may verify that BREQTCP.EXE is loaded by using the 
  311.    MEM /c utility from a command prompt.  Note that you will
  312.    not see the JSBDOSWS.EXE listed.
  313.  
  314.  
  315. DOS 5.0 or greater
  316. ------------------
  317.  
  318.    1. Make sure your TCP/IP components are loaded, as described
  319.       by your TCP/IP stack provider.
  320.    2. Run your JSB executable (see below).
  321.    3. Load the BREQTCP requester software.
  322.    4. Run your application.
  323.  
  324.    You can make a batch file to accomplish this.
  325.  
  326. *  The correct JSB EXE file depends on your TCP stack:
  327.  
  328.     - M3OPEN.EXE  (Microsoft)
  329.     - MNOVLWP.EXE (Novell)
  330.     - MFTP22.EXE  (FTP)
  331.  
  332. *  For example: (sample batch file for each TCP/IP stack)
  333.  
  334.   Microsoft               Novell                    FTP
  335.   ---------               ------                    ---------
  336.    SOCKETS.EXE            MNOVLWP.EXE               MFTP22.EXE
  337.    M3OPEN.EXE             BREQTCP.EXE               BREQTCP.EXE
  338.    BREQTCP.EXE            YourApp.EXE               YourApp.EXE
  339.    YourApp.exe
  340.  
  341. *  You may verify that BREQTCP.EXE and the correct JSB components
  342.    are loaded by using the MEM /c utility from a command prompt.
  343.  
  344. ** VENDOR-SPECIFIC NOTES **
  345.  
  346.  - MICROSOFT LAN MANAGER
  347.     1. Ensure that the NUMSOCKETS parameter in the [SOCKETS]
  348.        section of TCPUTILS.INI is set to the maximum concurrent
  349.        number of connections required.
  350.  
  351.     2. SOCKETS.EXE is a Terminate and Stay Resident (TSR) program
  352.        that allows applications to use the Microsoft Lan Manager 
  353.        TCP/IP stack.  SOCKETS.EXE should be located in the same
  354.        directory as the other Microsoft Lan Manager TCP/IP 
  355.        executables.
  356.  
  357.  -  NOVELL LAN WORKPLACE
  358.       Using Novell's LAN Workplace for DOS with BREQTCP.EXE
  359.       requires that the environment variable EXCELAN be set to
  360.       the Novell base directory.  For example, if you installed
  361.       LAN Workplace in the C:\NET directory, do a
  362.       SET EXCELAN=C:\NET prior to loading MNOVLWP.EXE and BREQTCP.EXE.
  363.  
  364.  -  FTP SOFTWARE
  365.      1. Ensure that you allocate enough TCP and packet buffers for
  366.         your application within the FTP kernel.
  367.  
  368.         e.g. 'kernel-name' -t 16 -p 20   allocates 16 TCP
  369.              connections and 20 packet buffers.
  370.  
  371.      2. Once the maximum number of connections has been reached, it
  372.         may prove difficult to effect any connection thereafter
  373.         until all, or almost all, connections have been closed.  You
  374.         are therefore recommended to set the maximum number of
  375.         connections to a high number.
  376.  
  377.  
  378.  
  379. SPECIFYING OPTIONS WHEN LOADING (all versions)
  380. ----------------------------------------------
  381.  
  382. Load the DOS Requester at the workstation by entering the
  383. following command:
  384.  
  385. [path]  BREQTCP [options]
  386.  
  387. path       The path to the directory where the DOS Requester is
  388.            stored. You can omit the path name if the DOS Requester is
  389.            stored on the default drive or if it is located in a
  390.            directory in your search path.
  391.  
  392. option     Any of the configuration options described in "Btrieve DOS
  393.            Requester Options" (follows this text).  For example,
  394.            if the Requester is on the default drive and you
  395.            want to specify a 2,048 byte data message
  396.            length, enter BREQTCP /D:2048.  The forward slash (/) before
  397.            the configuration option  is the only valid character you
  398.            can use. If you specify a dash (-) or a backslash (\), the
  399.            Requester may load improperly.
  400.  
  401. **********************************************************************
  402. **********************************************************************
  403.  
  404.  
  405. *** UNLOADING THE BTRIEVE DOS REQUESTERS ***
  406.  
  407. Unloading the Pervasive requester components
  408. --------------------------------------------
  409. To unload the DOS Requester, use the /U parameter of the DOS
  410. Requester  as described in "Unload Requester (/U)" option later
  411. in this document.
  412.  
  413.  
  414. Unloading the JSB components on Windows NT and DOS
  415. --------------------------------------------------
  416.  Windows NT:   JSBDOSWS /U
  417.  DOS:          [JSB executable] /U
  418.  
  419.                where [JSB executable] is one of the following that
  420.                depends on your TCP stack:
  421.                - M3OPEN.EXE  (Microsoft)
  422.                - MNOVLWP.EXE (Novell)
  423.                - MFTP22.EXE  (FTP)
  424.  
  425.  Windows 95:   There are no JSB components to unload in Windows 95.
  426.  
  427. **********************************************************************
  428. **********************************************************************
  429.  
  430.  
  431. *** ACCESSING NETWARE SERVERS ***
  432.  
  433.  
  434. You must have your Pervasive.SQL server IP address
  435. configured properly on your clients in order for
  436. Pervasive.SQL to function. There are two ways to do this.
  437.  
  438. To configure your clients to use the server's IP address, do
  439. one of the following:
  440.  
  441. *   1. In Windows 95 or NT, click Start and point to Control Panel.
  442.     2. Select Network.
  443.     3. Select TCP/IP and click Properties.
  444.     4. Click the DNS tab.
  445.     5. Enable DNS and enter the appropriate server information.
  446.  
  447. *   Enter your Server IP address/name in the \ETC\HOSTS file.
  448.  
  449. *   Verify correct configuration using the TCP/IP 'ping' to 
  450.     ping the server by name.  
  451.     
  452. *   Note that BREQTCP will return Btrieve status 20 if it is 
  453.     unable to resolve the server name into an IP address, or
  454.     if the IP address is incorrect or unreachable.
  455.     
  456.  
  457.  
  458. **********************************************************************
  459. **********************************************************************
  460.  
  461.  
  462. *** VERIFYING INSTALLATION ***
  463.  
  464.  
  465. You may use the DOS version of BUTIL.EXE located in \PVSW\BIN\DOS.
  466.  
  467. Do a BUTIL -stat on a Btrieve file on your target server.  For 
  468. example:
  469.  
  470.    BUTIL -STAT H:\PVSW\SAMPLES\SAMPLE.BTR
  471.     
  472. where H: is mapped to a NetWare or Windows NT server.  The Butil
  473. command should complete successfully.
  474.  
  475. **********************************************************************
  476. **********************************************************************
  477.  
  478. *** KNOWN ISSUES ***
  479.  
  480. This section contains notes on technical issues.
  481.  
  482. Multiple DOS Boxes
  483. ------------------
  484. When running BREQTCP on Windows 95, only one DOS box is
  485. supported.  Unloading BREQTCP is not sufficient to release the
  486. JSB VxD.  The DOS box must be closed before another DOS box can
  487. load BREQTCP.
  488.  
  489. On Windows NT, there is no restriction on the
  490. number of DOS boxes that can be invoked.
  491.  
  492. Use of DOS Requesters on the Windows NT platform
  493. ------------------------------------------------
  494. There are some configuration
  495. requirements when you use the DOS Requester with Windows NT.
  496.  
  497. *  To run a DOS application using the DOS requester in
  498.    an NT DOS box to access a NetWare server, NW16.EXE must be loaded
  499.    prior to loading BREQTCP.  Pervasive Software
  500.    recommends you load it from AUTOEXEC.NT.
  501.    If the NWLink IPX/SPX compatible transport is installed, these files are
  502.    located in the WINNT\SYSTEM32 directory.
  503.  
  504. *  DOS applications are not supported when running on
  505.    the NT server where the data files you are trying to access
  506.    reside.
  507.  
  508. How the Requesters Load
  509. -----------------------
  510.  
  511. The DOS Requesters load into a DOS workstation's memory as a
  512. Terminate and Stay Resident (TSR) program.  You can access
  513. local as well as remote files by running both the single-user
  514. version of the MicroKernel and the Requester at your
  515. workstation.  The workgroup version of the MicroKernel is
  516. not part of the client/server package and must be purchased
  517. separately through your Pervasive sales representative.
  518.  
  519. IP Address caching in Windows 95
  520. --------------------------------
  521.  
  522. After adding a target IP address for a NetWare server in the 
  523. local Windows 95 hosts file, BREQTCP must be unloaded and 
  524. reloaded.
  525.  
  526. After correcting a target IP address for a NetWare server in the 
  527. local Windows 95 hosts file, the Win95 system may need to be 
  528. restarted to restart the JSB VxD.
  529.  
  530. BREQTCP caches both valid and invalid IP addresses 
  531. while the JSB VSL VxD caches valid IP addresses.  The result is 
  532. that modifications to the hosts file will not affect BREQTCP and 
  533. may not affect the JSB VSL VxD depending upon prior attempts 
  534. cached.  This can be confusing when you are trying to modify a 
  535. target IP address in the local hosts file or on a DNS server.  
  536. Note that the Windows 95 'ping' utility does exhibit this 
  537. behaviour, so ping may work while BREQTCP requires that 
  538. Windows 95 be restarted.
  539.  
  540. Diagnosing BREQTCP.EXE initialization failures
  541. ----------------------------------------------
  542.  
  543. There are several reasons you may receive the following error
  544. message when loading BREQTCP:
  545.  
  546. BREQTCP-10: The function InitSocketLibrary returned an error.
  547.  
  548. If you see this message, you can determine the cause by using 
  549. this checklist:
  550.  
  551. 1) Verify that the JSB VSL components appropriate to your 
  552.    workstation are loaded.  Refer to the "*** RUNNING YOUR 
  553.    BREQTCP REQUESTER AFTER INSTALLATION ***" section for 
  554.    instructions on loading the JSB VSL components.  
  555.    
  556. 2) Verify that you set the VSL environment variable to the 
  557.    directory where you placed the VSLDOS.INI file.
  558.    
  559. 3) Verify that the VSLDOS.INI you are using is correct.  You
  560.    should copied the appropriate VSL platform specific 
  561.    configuration file into your installation directory and
  562.    renamed it VSLDOS.INI.  It is not necessary to modify the
  563.    VSLDOS.INI file.  Refer to the "*** RUNNING YOUR 
  564.    BREQTCP REQUESTER AFTER INSTALLATION ***" section to find the
  565.    correct version of the configuration file for your platform.
  566.    
  567. 4) On Windows 95, another DOS box is open that is using or had 
  568.    been using BREQTCP.  This is the multiple DOS box condition
  569.    described above.
  570.    
  571.  
  572. **********************************************************************
  573. **********************************************************************
  574.  
  575.  
  576. *** BTRIEVE DOS REQUESTER OPTIONS ***
  577.  
  578. There are several configuration options for the Btrieve DOS Requesters.
  579.  
  580. NetWare Runtime Server Support (/C)
  581. -----------------------------------
  582. Range:           /C:0 | /C:1  | /C:1,username,password
  583. Default:         /C:1
  584. Memory Required: Not applicable
  585.  
  586. Runtime Server Support allows access to the MicroKernel
  587. running on a NetWare Server that the user is not attached
  588. to. The workstation must have a network connection to one or
  589. more servers, but not necessarily the target Btrieve server.
  590. Using this option, you can enable or disable NetWare Runtime
  591. server support.
  592.  
  593. /C:0 Disables NetWare
  594. Runtime Server support.
  595.  
  596. /C:1 Enables NetWare Runtime server support.
  597. The MicroKernel looks at the username for the drive (current
  598. server) on which you are presently running.  If the username
  599. is SUPERVISOR or ADMIN, the MicroKernel searches for another
  600. username in the table of usernames for the servers to which
  601. you have a network connection.  If the username is not
  602. SUPERVISOR or ADMIN, the MicroKernel searches for that
  603. username on the NetWare Runtime server. If it is not a valid
  604. username, the MicroKernel returns Status Code 94, Permission
  605. Error, at the time of the Open or Create request on the
  606. NetWare Runtime server.
  607.  
  608. /C:1,  username, password
  609. Enables NetWare Runtime server support. The MicroKernel
  610. Database Engine verifies the specified username and password
  611. for the NetWare Runtime server. The MicroKernel returns an
  612. error if the specified username is not found or the password
  613. is invalid.  username Preferred login name on the NetWare
  614. runtime server. If you specify SUPERVISOR for the username,
  615. the MicroKernel returns status 99 at the time of the Open or
  616. Create.  password Login password for the specified user.
  617.  
  618. Data Message Length (/D)
  619. ------------------------
  620. Range           :  532 - 50,000 bytes
  621. Default         :  4096 bytes
  622. Memory Required :  355 bytes + data message length
  623.  
  624. This option specifies the length of the largest record (or
  625. the largest portion or chunk of a record) you want to access
  626. through the MicroKernel. (If you omit this option, the
  627. Requester uses the default value, 4096). The Requester uses
  628. this value to calculate the length of the data message
  629. buffer reserved for passing records between the MicroKernel
  630. and your applications. The requester maintains one copy of
  631. the data message buffer.  The value you enter here should
  632. not exceed the largest communication buffer size you
  633. configure for the MicroKernel through the Configuration
  634. utility since that is the maximum message that the server
  635. communication agent can receive.  Specify the data message
  636. length in bytes.
  637.  
  638. For example, if the largest record your
  639. application uses is 3,000 bytes, specify the /D option as
  640. follows:
  641.  
  642.     /d:3000
  643.  
  644. Specifying a higher value than you need
  645. for the /D option does not improve performance and may waste
  646. workstation memory.
  647.  
  648. DOS Session Load (/L)
  649. ---------------------
  650. Range           :  Not applicable
  651. Default         :  Not applicable
  652. Memory Required :  Not applicable
  653.  
  654. To run a DOS-based Btrieve application in a Windows DOS box,
  655. you must have the DOS Requester loaded in each DOS session.
  656. However, if you have already loaded the DOS Requester before
  657. loading Windows, you cannot load the DOS Requester in any
  658. subsequent DOS session. Consequently, you cannot run the
  659. DOS-based Btrieve application in the DOS box.  In each
  660. Windows DOS session that will be running a Btrieve-based
  661. application, load the DOS Requester with the /L option.
  662. Doing so loads another instance of the DOS Requester that is
  663. available only to the DOS session. This operation provides
  664. the DOS session with its own copy of the DOS Requester that
  665. is available only to the DOS session, and prevents the DOS
  666. session from using the instance of the DOS Requester than
  667. you loaded before starting Windows.  Versions of Btrieve for
  668. NetWare prior to 6.15 required the DOS requesters to be
  669. loaded before Windows in order to run Win16 applications.
  670. This is not necessary in versions 6.15 and later.
  671.  
  672. Receive Packet Size (/M)
  673. ------------------------
  674. Range           :  532-4,096
  675. Default         :  532  (BREQUEST) or
  676.                    1514 (BREQNT, BREQTCP, or BRQMSTCP)
  677. Memory Required :  3 * Receive Packet Size
  678.  
  679. This option serves the same function as the Receive Packet
  680. Size setting for the NetWare Btrieve Communications Manager
  681. server setting (described in Pervasive.SQL User's Guide). It
  682. has the same range as the server parameter but has different
  683. default that is optimized for the DOS requester.
  684.  
  685. Real-Time Data Compression (/O)
  686. -------------------------------
  687. Range           :  Not applicable
  688. Default         :  Not applicable
  689. Memory Required :  Not applicable
  690.  
  691. This option is accepted but otherwise ignored by BREQTCP.EXE.
  692.  
  693. Number of Servers (/S)
  694. ----------------------
  695. Range           :  1 through 8, or more if memory permits
  696. Default         :  8
  697. Memory Required :  27 bytes per server
  698.  
  699. The /S option specifies the number of MicroKernel Database
  700. Engines with which the requester can simultaneously
  701. communicate.
  702.  
  703. Number of Tasks (/T)
  704. --------------------
  705. Range           :  1 through 32,000
  706. Default         :  0
  707. Memory Required :  9 bytes per task
  708.  
  709. The /T option specifies the maximum number of workstation
  710. tasks that can access the server engine at one time using
  711. the BTRVID function. Applications that use the BTRV function
  712. are not affected by this option. For more information about
  713. whether you should set this option, refer to the
  714. documentation for your Btrieve application.
  715.  
  716. Unload Requester (/U)
  717. ---------------------
  718. Range            :  Not applicable
  719. Default          :  Not applicable
  720. Memory Required  :  Not applicable
  721.  
  722. This option unloads the Btrieve requester from memory. It
  723. performs the same function as a BREQUTIL -STOP command.
  724.  
  725. If files have been left open (as happens, for
  726. example, when an application does not issue a Close
  727. operation for each open file, or does not issue a Reset),
  728. simply logging out of one or more servers from a workstation
  729. does not close data files or terminate the Btrieve
  730. communications connection to the server. To close data files
  731. and terminate the connection, you must unload the Btrieve
  732. requester.
  733.  
  734. In summary, the difference between Reset and /U is:
  735.  
  736. Btrieve RESET operation:
  737.   - closes all files and closes the connection but
  738.     leaves requester loaded
  739.  
  740. /U command line option:
  741.   - closes all files, closes the connection, AND unloads requester
  742.  
  743.  
  744. Help (/?)
  745. ---------
  746. The /? option lists the options that are available.
  747.  
  748.  
  749. **********************************************************************
  750. **********************************************************************
  751.  
  752.  
  753. *** DISCLAIMER ***
  754.  
  755. PERVASIVE SOFTWARE INC. LICENSES THE SOFTWARE AND DOCUMENTATION 
  756. PRODUCT TO YOU OR YOUR COMPANY SOLELY ON AN "AS IS" BASIS AND SOLELY 
  757. IN ACCORDANCE WITH THE TERMS AND CONDITIONS OF THE ACCOMPANYING 
  758. LICENSE AGREEMENT.  PERVASIVE SOFTWARE INC. MAKES NO OTHER WARRANTIES 
  759. WHATSOEVER, EITHER EXPRESS OR IMPLIED, REGARDING THE SOFTWARE OR THE 
  760. CONTENT OF THE DOCUMENTATION; PERVASIVE SOFTWARE INC. HEREBY EXPRESSLY 
  761. STATES AND YOU OR YOUR COMPANY ACKNOWLEDGES THAT PERVASIVE SOFTWARE INC. 
  762. DOES NOT MAKE ANY WARRANTIES, INCLUDING, FOR EXAMPLE, WITH RESPECT TO 
  763. MERCHANTABILITY, TITLE, OR FITNESS FOR ANY PARTICULAR PURPOSE OR 
  764. ARISING FROM COURSE OF DEALING OR USAGE OF TRADE, AMONG OTHERS.
  765.  
  766. (C) Copyright 1998 Pervasive Software Inc.
  767. All Rights Reserved.
  768.  
  769.  
  770. ********************** END OF README.TXT *******************
  771.