home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / networks / wsdos2.zip / WSDOS2.EXE / NLS / ENGLISH / READVLM.TXT < prev   
Text File  |  1993-08-31  |  18KB  |  433 lines
  1.                   NETWARE DOS REQUESTER README (7/13/93)
  2.  
  3.              Print this file and save it for future reference.
  4.  
  5. To print this file to a local printer,
  6.  
  7.   1. Insert the INSTALL diskette into drive A: (or B:).
  8.  
  9.   2. At the DOS prompt, type "A:" (or "B:") and press <Enter>.
  10.  
  11.   3. At the DOS prompt, type "COPY READVLM.TXT PRN" and press <Enter>.
  12.  
  13.      NOTE: If you have a postscript printer, import this file into a word
  14.      processing application and print from the application.
  15.  
  16.  
  17.  
  18. CONTENTS
  19.  
  20.      1. Description of NetWare DOS Requester Modules
  21.      2. Configurable Parameters
  22.      3. Questions and Answers
  23.           Q1: Directory location of modules
  24.           Q2: VLMs load order
  25.           Q3: Disabling certain modules
  26.           Q4: NetWare protocols load order
  27.           Q5: NETX.COM with VLMs
  28.           Q6: IPXNCP.VLM and IPXODI.COM
  29.           Q7: Special considerations when running Windows
  30.      4. Caution List
  31.  
  32.  
  33. ----------------------------------------------------------------------------
  34.  1. Description of NetWare DOS Requester Modules 
  35.  
  36.     The NetWare DOS Requester consists of a number of files that provide
  37.     NetWare support for a DOS client.  Unlike previous versions of the
  38.     NetWare DOS client, the Requester is built on a number of Virtual
  39.     Loadable Modules (VLMs).  The VLM.EXE (VLM manager) is responsible for
  40.     loading the required modules.
  41.  
  42.     NOTE: The NetWare DOS Requester is NOT compatible with NETX.COM or
  43.     NETX.EXE.  Use NETX.VLM for compatibility with shell calls.
  44.  
  45.     The following table lists the current core modules in their default load
  46.     order.  The table also includes descriptions, default values, and flags
  47.     indicating whether the module is 'Required' or 'Optional' for each of
  48.     NetWare Directory Services or Bindery Services.
  49.  
  50.     MODULE          DESCRIPTION                          NDS  BIND
  51.     ======          ===========                          ===  ====
  52.  
  53.     CONN.VLM        Connection table manager              R     R 
  54.  
  55.     IPXNCP.VLM      Transport protocol                    R     R 
  56.                     implementation using IPX
  57.  
  58.     TRAN.VLM        Transport protocol multiplexor        R     R 
  59.  
  60.     SECURITY.VLM    NetWare enhanced security             O     O 
  61.  
  62.     NDS.VLM         NetWare protocol implementation       R     O 
  63.                     using Directory Services
  64.  
  65.     BIND.VLM        NetWare protocol implementation       O     R 
  66.                     using the Bindery
  67.  
  68.     NWP.VLM         NetWare protocol multiplexor          R     R 
  69.  
  70.     FIO.VLM         File Input/Output                     R     R 
  71.  
  72.     PRINT.VLM       Printer Redirection                   O     O 
  73.  
  74.     GENERAL.VLM     Miscellaneous functions for           R     R 
  75.                     NETX.VLM and REDIR.VLM 
  76.  
  77.     REDIR.VLM       DOS redirector                        R     R 
  78.  
  79.     NETX.VLM        NetWare shell compatibility           O     O 
  80.  
  81.     RSA.VLM         RSA encryption for directory          O     O 
  82.                     services reauthentication
  83.  
  84.     AUTO.VLM        Auto-reconnect/auto-retry             O     O 
  85.  
  86.     NMR.VLM         NetWare management responder          O     O 
  87.  
  88.  
  89.  
  90. ----------------------------------------------------------------------------
  91.  2. Configurable Parameters
  92.  
  93.     The following table lists the configurable parameters for the various
  94.     modules of the NetWare DOS Requester.  Options marked with * are not
  95.     required for shell compatibility.  Options marked with a ^ do not
  96.     necessarily have to be located under the NetWare DOS Requester heading.
  97.     This list is complete and any parameters which may have been used
  98.     previously by the Requester but are not listed here are considered
  99.     obsolete.
  100.  
  101.   Parameter/Default                    Minimum     Maximum     Module
  102.  
  103. ^ SET STATION TIME = ON                                        VLM.EXE
  104.  
  105.   USE DEFAULTS = ON                    --          --          VLM.EXE
  106.  
  107.   VLM = <path><vlm>                    --          50 VLMs     VLM.EXE
  108.  
  109.   MESSAGE LEVEL = 1                    0           4           VLM.EXE
  110.  
  111.      0 = V_LEVEL_STD; always display message and
  112.             critical errors
  113.      1 = V_LEVEL_WARNING; display warning type messages
  114.      2 = V_LEVEL_PROG; display the program load message
  115.      3 = V_LEVEL_CONFIG; display configuration
  116.             information
  117.      4 = V_LEVEL_DIAG; display diagnostic information
  118.  
  119.   NETWARE PROTOCOL = <NetWare protocols list>                  VLM.EXE
  120.  
  121.      Note: The <NetWare Protocols list> is the list of
  122.            protocols to be used (i.e. NDS or BIND)
  123.            by the Requester in the order of their priority.
  124.            Each protocol is separated by a comma or space
  125.            in the list.
  126.  
  127.   CONNECTIONS = 8                      2           50          CONN.VLM
  128.                                                                FIO.VLM
  129.                                                                NDS.VLM
  130.                                                                SECURITY.VLM
  131.                                                                AUTO.VLM
  132.  
  133.   AVERAGE NAME LENGTH = 48             2           48          CONN.VLM
  134.  
  135. ^*MAX TASKS = 31                       5           254         CONN.VLM
  136.  
  137.   LOAD LOW CONN = ON                   --          --          CONN.VLM
  138.  
  139.   LOAD CONN TABLE LOW = OFF            --          --          CONN.VLM
  140.  
  141. ^*CHECKSUM = 1                         0           3           IPXNCP.VLM
  142.                                                                NWP.VLM
  143.      0 = disabled
  144.      1 = enabled but not preferred
  145.      2 = enabled and preferred
  146.      3 = required     
  147.  
  148.   LARGE INTERNET PACKETS = ON          --          --          IPXNCP.VLM
  149.                                                                NWP.VLM
  150.  
  151.   LOAD LOW IPXNCP = ON                 --          --          IPXNCP.VLM
  152.  
  153.   HANDLE NET ERRORS = ON               --          --          IPXNCP.VLM
  154.  
  155. ^ PREFERRED TREE = <tree name>         --          --          NDS.VLM
  156.  
  157.   NAME CONTEXT = "<name context>"      --          --          NDS.VLM
  158.  
  159.      Note: Quotation marks are required.
  160.  
  161. ^ PREFERRED SERVER = <server name>     --          --          BIND.VLM
  162.  
  163. ^ MESSAGE TIMEOUT = 0                  0           10000       NWP.VLM
  164.  
  165. ^*SIGNATURE LEVEL = 1                  0           3           NWP.VLM
  166.                                                                SECURITY.VLM
  167.      0 = disabled
  168.      1 = enabled but not preferred
  169.      2 = preferred
  170.      3 = required
  171.  
  172.      NOTE: This parameter designates the level of enhanced security support.
  173.            Enhanced security includes the use of a message digest algorithm
  174.            and a per-connection/pre-request session state for increased
  175.            protection against intruder attacks.  When this parameter is set
  176.            to 0 (disabled), the SECURITY.VLM will not load.
  177.  
  178. ^*CACHE BUFFERS = 5                    0           64          FIO.VLM
  179.  
  180.   CACHE BUFFER SIZE = (max media size - 64>
  181.                                        64          4096        FIO.VLM
  182.  
  183.   CACHE WRITES = ON                    --          --          FIO.VLM
  184.  
  185.   TRUE COMMIT = OFF                    --          --          FIO.VLM
  186.  
  187. ^*PB BUFFERS = 3                       0           10          FIO.VLM
  188.                                                                IPXNCP.VLM
  189.      0 =       off
  190.      nonzero = on
  191.  
  192. ^ PBURST READ WINDOW SIZE = 64         2           64          FIO.VLM
  193.  
  194. ^ PBURST WRITE WINDOW SIZE = 10        2           64          FIO.VLM
  195.  
  196. ^*PRINT HEADER = 64                    0           1024        PRINT.VLM
  197.  
  198. ^*PRINT TAIL = 16                      0           1024        PRINT.VLM
  199.  
  200.   PRINT BUFFER SIZE = 64               0           256         PRINT.VLM
  201.  
  202.   NETWORK PRINTERS = 3                 0           9           PRINT.VLM
  203.  
  204.      NOTE: If set to 0, PRINT.VLM will not load.
  205.  
  206. ^*LOCAL PRINTERS = 3                   0           9           PRINT.VLM
  207.  
  208.   FIRST NETWORK DRIVE = <none>         A           Z           GENERAL.VLM
  209.                                                                NETX.VLM
  210.  
  211.      NOTE: If FIRST NETWORK DRIVE is not specified, it will default to
  212.            the first available drive letter.
  213.  
  214. ^*SEARCH MODE = 1                      0           2           GENERAL.VLM
  215.  
  216. ^*READ ONLY COMPATIBILITY = OFF        --          --          REDIR.VLM
  217.  
  218. ^*SHOW DOTS = OFF                      --          --          REDIR.VLM
  219.  
  220. ^*DOS NAME = MSDOS                     1           5 chars     NETX.VLM
  221.                                                                GENERAL.VLM
  222.  
  223. ^*LONG MACHINE TYPE = IBM_PC           1           6 chars     NETX.VLM
  224.                                                                GENERAL.VLM
  225.  
  226. ^*SHORT MACHINE TYPE = IBM             1           4 chars     NETX.VLM
  227.                                                                GENERAL.VLM
  228.  
  229.  *AUTO RECONNECT = ON                  --          --          AUTO.VLM
  230.                                                                NDS.VLM
  231.  
  232.      Note: When this parameter is OFF, the AUTO.VLM load fails at pre-init
  233.            time.
  234.  
  235.   AUTO RETRY = 0                       0          3640         AUTO.VLM
  236.  
  237.   AUTO LARGE TABLE = OFF                                       AUTO.VLM
  238.  
  239.      Note: When this parameter is OFF, the user name and password
  240.            maximum lengths are 16 chars each for auto reconnect.
  241.  
  242.   BIND RECONNECT = OFF                                         AUTO.VLM
  243.                                                                BIND.VLM
  244.  
  245.  
  246.  
  247. ----------------------------------------------------------------------------
  248.  3. Questions and Answers
  249.  
  250.     Q1. What directory do the modules get loaded from?
  251.  
  252.     A1. The current directory is used for VLMs.  If you want to load VLMs
  253.         from a specific directory, use the "VLM =" command in the
  254.         configuration file. For example:
  255.  
  256.                     VLM=C:\NWCLIENT\CONN.VLM
  257.  
  258.         To specify a path for the configuration file on the VLM command
  259.         line, type a command similar to the following:
  260.  
  261.                     VLM /C=C:\NWCLIENT\NET.CFG
  262.  
  263.     Q2. Are the VLMs load-order dependant?
  264.  
  265.     A2. Yes.  For example, NWP.VLM is a multiplexor for NetWare protocol
  266.         modules.  Thus, you should load NetWare protocols (NDS.VLM or BIND.VLM) before NWP.VLM.
  267.  
  268.     Q3. How can I disable or not load certain modules?
  269.  
  270.     A3. There are three ways:
  271.         *  Rename the module with a different extension (for example,.SAV). 
  272.            This is the easiest way.
  273.         *  Delete the module (not recommended).
  274.         *  Configure the modules to be loaded in the configuration file     
  275.            (NET.CFG). Below is the syntax that gives the modules required   
  276.            for Directory Services:
  277.  
  278.                     NETWARE DOS REQUESTER
  279.                            USE DEFAULTS = OFF
  280.                            VLM = CONN.VLM
  281.                            VLM = IPXNCP.VLM
  282.                            VLM = TRAN.VLM
  283.                            VLM = NDS.VLM
  284.                            VLM = BIND.VLM
  285.                            VLM = NWP.VLM
  286.                            VLM = FIO.VLM
  287.                            VLM = GENERAL.VLM
  288.                            VLM = REDIR.VLM
  289.  
  290.     Q4. Can I avoid loading all of the NetWare protocol modules if I don't
  291.         need them all, and is load order a consideration for those as well?
  292.  
  293.     A4. Yes.  There are two ways to address this:
  294.         * Follow the instructions in A3 for the NetWare protocol modules
  295.           that you don't need, and then specify the VLMs individually in
  296.           your configuration file as shown above, with the NetWare protocol
  297.           VLMs specified in the order you wish to load them.
  298.         * Use the NETWARE PROTOCOL configuration parameter, specifying the
  299.           NetWare protocol modules you wish to load in the order you wish
  300.           to load them:
  301.  
  302.                     NETWARE PROTOCOL = NDS,BIND
  303.  
  304.     Q5. Do I load NETX.COM with the VLMs?
  305.  
  306.     A5. NETX.COM conflicts with REDIR.VLM; REDIR.VLM won't load if NETX.COM
  307.         is loaded and vice versa.  However, NETX.VLM is designed to replace
  308.         NETX.COM and be compatible with the NetWare DOS Requester.
  309.  
  310.     Q6. Since NETX.VLM is a replacement for NETX.COM, is IPXNCP.VLM a
  311.         replacement for IPXODI.COM?
  312.  
  313.     A6. No. IPXNCP requires IPXODI.COM to be loaded.
  314.  
  315.     Q7. Are there any special considerations when I run Windows with the
  316.         NetWare DOS Requester?
  317.  
  318.     A7. Yes.  There are two considerations:
  319.         *  Do not use the expanded memory option. You can run Windows with the NetWare
  320.            DOS Requester only if you use the extended memory option (which is preferred)
  321.            or the conventional memory option. However, you can't run Windows with
  322.            the VLMs if you use the expanded memory option.
  323.         *  The Windows SYSTEM.INI must be altered.  The following parameter must be added
  324.            and/or set to a non-zero value under the [386Enh] section of the SYSTEM.INI file:
  325.            TimerCriticalSection= <milliseconds>.  For example: TimerCriticalSection=10000
  326.  
  327.  
  328.  
  329. ----------------------------------------------------------------------------
  330.  4. Caution List 
  331.  
  332. This list contains the known or suspected cautions introduced by the new
  333. architecture used in the NetWare DOS Requester versus the conventional
  334. NetWare Workstation Shell for DOS (NETX.COM v3.30).
  335.  
  336. Legend to caution list:
  337.  
  338.     USER - User must make a change to achieve same function
  339.     COMP - Compatibility issue at the API level
  340.     DIFF - API compatibility but with different results
  341.     FEAT - Noncritical feature not available at this time
  342.  
  343. USER    First available drive is different.
  344.  
  345.         The conventional NetWare Shell for DOS starts using drives after
  346.         the LASTDRIVE parameter; NetWare DOS Requester starts using the
  347.         first available drive before the LASTDRIVE parameter. 
  348.         Consequently, users often see drive D: as the first NetWare drive
  349.         rather than drive F:.
  350.  
  351.         This means batch files assuming drive F: is the first drive must be
  352.         altered, or drives D: and E: must be substituted (see DOS SUBST
  353.         command) and the LASTDRIVE parameter adjusted to something above
  354.         the default value of E:.
  355.  
  356. USER    Login drive prompt appears to be a root mapped drive.
  357.  
  358.         Because NetWare DOS Requester is a redirector on the back-end of
  359.         DOS, no directory path can be in the drive structure maintained by
  360.         DOS when the parent of the directory is unaccessible.  This is the
  361.         case with an unauthenticated connection and the drive mapped to the
  362.         SYS:LOGIN directory.  Users will see "D:\>" instead of "F:\LOGIN>"
  363.         when they first load the DOS client software.
  364.  
  365. COMP    RENDIR.EXE can rename the current directory but the DOS current
  366.         directory structures aren't updated.  NCPs that use a path won't
  367.         function properly.
  368.  
  369.         RENDIR.EXE will be changed to back up a directory before renaming
  370.         the current one and then forward to it.  This will fix the problem.
  371.  
  372. COMP    Currently there are no plans for long-term support of  OS_VERSION,
  373.         MACHINE, and SMACHINE in VLM (excluding NETX.VLM) similar to what
  374.         the Netware shell does with Int 21h function EAh.
  375.  
  376. DIFF    NetWare DOS Requester requires users with IPXODI.COM version 2.0 to
  377.         run IPXNCP.VLM.
  378.  
  379.         To support the packet burst ODI the SFT3 checksums, and the NetWare
  380.         management responder, IPXNCP.VLM requires IPXODI.COM version 2.0 to
  381.         be loaded with support for checksums and GNMA enabled (the version
  382.         and the API support level are treated separately in IPXODI).
  383.  
  384. DIFF    Portions of the current diagnostics information supported in
  385.         NETX.COM will appear to be idle in NETX.VLM.
  386.  
  387.         Because NetWare DOS Requester is responsible for much of the
  388.         diagnostics information previously maintained in the NetWare Shell
  389.         for DOS, some of the information maintained in the diagnostics
  390.         responder won't be updated.  Such information includes the
  391.         following:
  392.  
  393.                     Bad reply header (InvalidReplyHeaderCount)
  394.                     Bad slot (InvalidSlotCount)
  395.                     Bad sequence number (InvalidSequenceNumberCount)
  396.                     No router found (NoRouterFoundCount)
  397.                     Request in process (BeingProcessedCount)
  398.                     Bad server slot (InvalidSlotFromServerCount)
  399.                     Bad net address (NetworkGoneCount)
  400.                     Bad local address (BadLocalAddressCount)
  401.                     Allocate slot errors (AllocateSlotCannotFindRoute,
  402.                     AllocateNoSlotsAvailable, AllocateServerIsDown)
  403.  
  404.  
  405.         The NetWare Management Responder will return information similar to
  406.         that mentioned above.
  407.  
  408. DIFF    Search mode will use the ENVIRONMENT rather than the NETX.VLM
  409.         public search mode table.
  410.  
  411.         This has no implications as long as the user doesn't corrupt the
  412.         environment.
  413.  
  414.  
  415.  
  416. DISCLAIMER
  417.  
  418. Novell, Inc., makes no representations or warranties with respect to any
  419. NetWare software, and specifically disclaims any express or implied
  420. warranties of merchantability, title, or fitness for a particular purpose.
  421.  
  422. Distribution of any NetWare software is forbidden without the express
  423. written consent of Novell, Inc. Further, Novell reserves the right to
  424. discontinue distribution of any NetWare software.
  425.  
  426. Novell is not responsible for lost profits or revenue, loss of use of the
  427. software, loss of data, costs of recreating lost data, the cost of any
  428. substitute equipment or program, or claims by any party other than you.
  429.  
  430. Novell strongly recommends a backup be made before any software is
  431. installed. Technical support for this software may be provided at the
  432. discretion of Novell.
  433.