Smart II Software parameters: NOVAPI parameters
===============================================          
                                               LSS 5.0(0), August 1996
                                               -----------------------
1 Introduction
--------------
This document describes the parameters that affect  the  operation  of 
the  Smart  NOVAPI  host-interface  module on a particular Ringnode in 
your DOS workstation.  The  NOVAPI.SMT  module  enables  Novell's  LAN 
WorkPlace  for  DOS  and  NetWare  IP applications to access the Smart 
TCP/IP protocol suite.
                       
To  load the NOVAPI host-interface, include a [NOVAPI] section in your 
SMART.CFG file.  Do not attempt to load or configure NOVAPI  from  the 
command  line. Put any NOVAPI parameters in the NOVAPI section of your 
SMART.CFG file. No other parameters are allowed in this section.

Table 1 summarizes the parameters that are available.

--------------------------------------------------------------------
| Parameters             Range          Default       Abbreviation |
| ----------             -----          -------       ------------ |
| ENABLE.STATISTICS      YES or NO      NO            ES           |
| TUNNEL                 YES or NO      NO            T            |
| TUNNEL.BUFFERS         4 - 32         16            TB           |
| LSL.EXTENSIONS         YES or NO      NO            LE           |
| WIN.BUFFERS            0 - 32         16            WB           |
| PATH.TCP.CFG                          \NET\TCP      TPATH        |
| PATH.LWP.CFG                          \NET\HSTACC   LPATH        |
| PATH.PROFILE                          \NET\PROFILE  PPATH        |
| PATH.SCRIPT                           \NET\SCRIPT   SPATH        |
| WINSOCK.INTERFACE      MADGE or                                  |
|                        LANWorkPlace   LanWorkPlace  WI           |
| PATH.WINSOCK                          \NET\BIN      WPATH        |
| LWP.VERSION            4 or 5         5             LWPV         |
--------------------------------------------------------------------
Table 1 Summary of the NOVAPI parameters


2 NOVAPI Parameters
-------------------

This section describes the NOVAPI parameters. 


ENABLE.STATISTICS   Enables  the  MIB  information  facility. Use this 
                    parameter  in  conjunction  with  the   ENABLE.MIB 
                    parameter  described  in  the  IP  section  of the 
                    SMTTCPIP.TXT file.
                    
                    If you do not require MIB  information,  you  save 
                    about 3.2kbytes of DOS memory.

                    Example: ENABLE.STATISTICS=YES

                    Note that the Novell LWP  4.2  SNMP   application,  
                    SNMP.EXE, requires a  net.cfg  file,  even if this
                    file is empty.  

TUNNEL              Enables support for NetWare/IP and  IP  tunneling. 
                    If you enable TUNNEL, the TUNNEL.BUFFERS parameter 
                    (see  below) is activated with a default value. If 
                    you are using  NetWare/IP  or  IP  tunneling,  set 
                    TUNNEL to YES.
                    
                    Example: TUNNEL=YES             
                    
TUNNEL.BUFFERS      Defines  the  number  of  adapter buffers that the 
                    Smart II  Software  uses  for  storing  NetWare/IP 
                    frames.   If  you enable the TUNNEL parameter (see 
                    above), the TUNNEL.BUFFERS parameter is  activated 
                    with a default value.  You do not normally need to 
                    change this parameter from it's default value.
                    
                    Example: TUNNEL.BUFFERS=20

LSL.EXTENSIONS      Setting  LSL.EXTENSIONS  to  YES  tells  the  host 
                    interface  (NOVAPI.SMT)  to  provide  certain  LSL 
                    services.  Some applications will require these to 
                    enable them to access the  Smart  TCP/IP  protocol 
                    stack   properly.    Smart   TCP/IP  automatically 
                    provides these services if there is a  possibility 
                    that  they  might be needed. Therefore, you do not 
                    normally need to alter  this  parameter  from  its 
                    default value of NO.
                    
                    Example: LSL.EXTENSIONS=YES
                    
WIN.BUFFERS         Specifies the number of buffers that  NOVAPI  uses 
                    to  store  information about data transfers to and 
                    from Windows. You do not normally  need  to  alter 
                    this from the default value of 16.
                    
                    Example: WIN.BUFFERS=16

PATH.TCP.CFG        Specifies  the  location  of TCP configuration 
                    files. These files are:
                    
                    HOSTS       ... lists names and aliases for IP
                                    addresses
                    RESOLV.CFG  ... lists default domain names and
                                    name servers for DNS services
                    SERVICES    ... lists names, ports and protocols
                                    of common TCP/IP services
                    PROTOCOL    ... lists names and numbers of common
                                    TCP/IP protocols
                    NETWORKS    ... lists important networks on the
                                    Internet

                    You do not  normally  need  to  alter  this 
                    from the default value of \NET\TCP.

                    Example: PATH.TCP.CFG=D:\NET\TCP

PATH.LWP.CFG        Specifies  the  location  of  Novell configuration 
                    files. You do not  normally  need  to  alter  this 
                    parameter from it's default value of \NET\HSTACC.

                    Example: PATH.LWP.CFG=D:\NET\HSTACC 

PATH.PROFILE        Specifies  the  location  of  Novell configuration 
                    files. You do not  normally  need  to  alter  this 
                    parameter from it's default value of \NET\PROFILE.

                    Example: PATH.PROFILE=D:\NET\PROFILE        
        
PATH.SCRIPT         Specifies  the  location  of  Novell configuration 
                    files. You do not  normally  need  to  alter  this 
                    parameter from it's default value of \NET\SCRIPT.

                    Example: PATH.SCRIPT=D:\NET\SCRIPT

WINSOCK.INTERFACE   Specifies the  winsock  interface to use.   If you
                    have installed  Novell's  LAN  Work Place then you
                    will not need to change this  parameter  from  its
                    default value of LANWorkPlace.  
                    To use the  Madge  Winsock  DLL  you must set this 
                    parameter to  "Madge"   (See also the PATH.WINSOCK
                    parameter).

                    Example: WINSOCK.INTERFACE=Madge                    
        
PATH.WINSOCK        Specifies the  directory  containing  the  Winsock
                    files.  If you have installed  Novell's  LAN  Work
                    Place  then  you  will  not  need  to  change this
                    parameter from it's default value.
                    If you have set WINSOCK.INTERFACE to  "Madge" then
                    this parameter specifies the directory  containing 
                    winsock.dll and vnovapi.386.

                    Example: PATH.WINSOCK=C:\WINDOWS 

********************************************************************** 
       Note 
      
       NOVAPI.SMT will expect VNOVAPI.386/WINSOCK.DLL to be located in
       one of the following places:

       a) the  directory  provided by the  path.winsock  parameter  in
          SMART.CFG  (*Recommended*).

       b) the BIN directory associated with the  TCP_CFG  parameter in
          either NET.CFG or  SMART.CFG  (BIN is in the directory above
          that specified), eg.

               TCP_CFG set to NETWORK\CONFIG
               Files should be in NETWORK\BIN

       c) the directory \NET\BIN.

**********************************************************************


LWP.VERSION         Indicates which version of  Novell's LAN Workplace 
                    will be used.

                    Example: LWP.VERSION=4


3 Configuring NOVAPI from the NET.CFG file
------------------------------------------

This  section  describes  the  NOVAPI  parameters  you  can use in the 
"Protocol TCPIP" section of your NET.CFG file.  They are equivalent to 
some of the parameters that you can use in  your  SMART.CFG  file.  In 
each case, use one or the other parameter. 


The NOVAPI parmeters are:


PATH TCP_CFG        Specifies  the  location  of  Novell configuration 
                    files.   

                    Do  not  put  an '=' sign after PATH or TCP_CFG in 
                    NET.CFG.

                    Example: PATH TCP_CFG D:\NET\TCP

PATH LWP_CFG        Specifies the  location  of  Novell  configuration 
                    files.   

                    Do not put an '=' sign after PATH  or  LWP_CFG  in 
                    NET.CFG.

                    Example: PATH LWP_CFG D:\NET\HSTACC

PATH PROFILE        Specifies  the  location  of  Novell configuration 
                    files.   

                    Do not put an '=' sign after PATH  or  PROFILE  in 
                    NET.CFG.

                    Example: PATH PROFILE D:\NET\PROFILE

PATH SCRIPT         Specifies  the  location  of  Novell configuration 
                    files.   

                    Do not put an '=' sign after  PATH  or  SCRIPT  in 
                    NET.CFG.

                    Example: PATH SCRIPT D:\NET\SCRIPT


4 Troubleshooting with Smart TCP/IP
-----------------------------------

This section contains hints on how  to  configure  your  Smart  TCP/IP 
stack  to  work  with  different applications in various environments.

Lan Workplace 4.2 
-----------------

SNMP.EXE 

         With Smart TCP/IP you do not need to run LSL.COM in order  to 
         query  TCP/IP MIB  information  ( which  is optionally loaded
         onto your adapter).  This means that you may not have created
         a NET.CFG file.  However,  the  Novell   application SNMP.EXE
         expects to find a NET.CFG file.  So, in order to run SNMP.EXE
         successully  you must  create  a  NET.CFG  file,  even if all
         the entries are empty.
     
         Also, you must unoad SNMP.EXE before  running  Windows.    To
         query MIB information  when  Windows  is running you must run 
         SNMP.EXE in a Windows DOS box.


Lan WorkPlace 5.0 
-----------------

TNVT220 and XPC
        
        With Lan WorkPlace 5 you must ensure that lwp.ini is on
        the path and that the [Paths] section is filled out correctly.
        A typical [Paths] section is shown below


                [Paths]
                ;
                ; The path designations to the various files.
                ; 
                ; SCRIPT    paths to script files
                ; PROFILE   paths to profile files
                ; LWP_CFG   paths to configuration files
                ; SPOOL     paths to base of print spool directories
                ; XFONTS    paths to X-Server Font files
                ; 
                SCRIPT=c:\lwp5\script
                PROFILE=c:\lwp5\profile
                LWP_CFG=c:\lwp5\hstacc
                SPOOL=c:\lwp5\spool
                XFONTS=c:\lwp5\xfonts\misc;c:\lwp5\xfonts\75dpi
        
        A sample lwp.ini is provided in the install directory of  your 
        Lan Workplace 5 setup.
        If lwp.ini is not on the path,  these programs will  print the 
        message "extmap.bin not found" and will not work.
        Also,   you  should   ensure   that   these  paths  match  the
        corresponding paths in net.cfg and/or smart.cfg.

                     
                    ****** End of SMTNOVAP.TXT ******         

      
