home *** CD-ROM | disk | FTP | other *** search
/ Enter 1998 December / ENTER12_2.iso / stomper / STOMPER.DOC < prev    next >
Encoding:
Text File  |  1997-10-14  |  42.0 KB  |  1,185 lines
  1.       For ordering see ORDER.EXE in the Stomper-Directory or order online
  2.       on our web-page with your Mastercard
  3.  
  4.  
  5.                         Stomper  3.41        10/14/97
  6.  
  7.  
  8. Modem and ISDN Sharing-Software for Novell or Netbios Based Networks
  9.  
  10. DOS/Windows/Netware
  11.  
  12. ╕ 1994/1997 Pflug Datentechnik.
  13.  
  14.  
  15. Hardware and software requirements for installation:
  16.  
  17. -       network, preferably NetWare or WfW-Network
  18. -    minimum DOS 3.3
  19. -    Windows 3.x  / 95 / NT
  20. -       1 serial interface per modem server, FIFO buffered (UART 16550)
  21. -    Processor depending on number of modem servers on one computer,
  22.         minimum AT (80386)
  23.  
  24.  
  25.  
  26. 1 INTRODUCTION  
  27. 2 THE CONCEPT   
  28. 2.1 WHAT IS A MODEM-/ISDN-SERVER?       
  29. 2.2 SERVER-CLIENT OPERATION     
  30. 3 INSTALLATION  
  31. 3.1 GENERAL (VERY IMPORTANT!)   
  32. 3.2 INSTALLING A MODEM / ISDN SERVER    
  33. 3.2.1 Installation under Windows 3.x and Windows 95     
  34. 3.2.2 Installation on the Netware Fileserver (Modem Server Only)        
  35. 3.2.3 Installation under DOS    
  36. 3.2.3.1 Modemserver     
  37. 3.2.3.2 The ISDN Server 
  38. 3.3 INSTALLING A  MODEM / ISDN CLIENT   
  39. 3.3.1 Installation under Windows 3.x and Windows 95     
  40. 3.3.2 Installation under DOS    
  41. 3.3.2.1 Modem-Client    
  42. 3.3.2.2 ISDN-Client     
  43. 4 SELECT SPECIFIC MODEM SERVERS BY DIFFERENT PORTS      
  44. 5 THE COOPERATIVE MODE  
  45. 6 QUEUE MANAGEMENT      
  46. 7 THE MONITOR   
  47. 8 PROGRAMS USING INT 14 (BIOS)  
  48. 9 APPLYING ACCESS RIGHTS        
  49. Appendix A Suitable Programs    
  50. Appendix B NETINFO.EXE  
  51. Appendix C Tips 
  52. 1. Telemate     
  53. 2. Terminate    
  54. 3. Telix For Windows    
  55. 4. Crosspoint   
  56. 5. pcAnywhere   
  57. 6. CFOS 
  58. 7. Tobit FaxWare        
  59. Appendix D Troubleshooting      
  60. Appendix E Performance  
  61. Appendix F What is a FOSSIL driver?     
  62. Appendix G What is a network fossil driver?     
  63. Appendix H Support      
  64.  
  65.  
  66. 1 Introduction
  67.  
  68. Included in this new version 3.30 of Stomper is a complete Windows setup
  69. program. Furthermore, the following improvements vs. version 3.21 have
  70. been incorporated:
  71.  
  72.     - CAPI 1.1 Windows-Server (WIN3.x/95/NT)
  73.     - CAPI.DLL 1.1 Client (WIN3.x/95/NT)
  74.     - INT14/Fossil support in WIN95-DOS-Box using
  75.       STCLNT.VXD. This supports simple FOSSIL programs like Telemate 
  76.       or Terminate.
  77.  
  78. In case you already have installed the free TEST/DEMO version of Stomper:
  79. Then you just have to enter the registration key and name to extend your
  80. license (refer to the accompanying diskette for registration key and name).
  81. Under Windows, you register by activating the icon "Registration" in the
  82. Stomper program group.
  83. Registration under DOS is done by entering the command line: register 
  84. Registration_Key Name in the Stomper directory (refer to the accompanying 
  85. diskette for registration key and name).
  86.  
  87. If you have not yet installed Stomper on your system, please proceed reading
  88. this manual.
  89.  
  90.  
  91.  
  92. 2 The Concept
  93. 2.1 What is a modem-/ISDN-server?
  94.  
  95. The modemserver is a program, that accesses the device directly, that should #
  96. be made available throughout the network.
  97. There may be more than one modem server (or ISDN-server) on one computer or 
  98. there may be several servers spread over the whole network.
  99. When a client accesses a modem server, all communication between
  100. communication software (terminal, fax, ...) and the modem is directed through
  101. the network.
  102. Stomper is responsible for repacking the data suitable for the network, to
  103. send it and to convert it back. It appears to the user as if the modem was
  104. attached directly to his local workstation.
  105. Often the modem server is compared to a printer server. This is not quite
  106. correct.
  107. The main difference is, that the printer server is "batch-driven". This means,
  108. that a print job is placed into a temporary file, which is read by the printer
  109. server whenever it is ready and the contents then are sent to the printer.
  110. A modem server works online. All data is sent to the device immediately. 
  111. Additionally all line-control information is passed on.
  112.  
  113.  
  114.  
  115. 2.2 Server-Client Operation
  116.  
  117. As soon as a client requests an available modem or an ISDN-adapter (this
  118. happens
  119. automatically, when your communications software is started), the client-
  120. program (NETFOS, NFCAPI, ...) searches for a modemserver and initiates a
  121. session.
  122. From this moment on, the server is not available for other stations. It
  123. is reserved for this one client.
  124. At the end of the session, the server will get released.
  125.  
  126.  
  127.  
  128. 3 Installation
  129.  
  130. 3.1 General (very important!)
  131.  
  132. Note the following key issues prior to installation:
  133.  
  134.   If you want to run Stomper on a Netware 3.11 (or higher) network 
  135. You must load the file STMGR.NLM (included on the diskette) on the file
  136. server prior to the installation.
  137. Make sure that the settings for "IPX Sockets" and "SPX Connections" are at
  138. least 30-60 on all the stations. The default settings are too small in any
  139. case.
  140.  
  141.   If you want to run Stomper on a Windows for Workgroups network
  142. In the Windows network setup, set NetBEUI as the standard protocol 
  143. (important!).
  144. Make sure that the settings for "Max. connections" is at least 30 and the
  145. setting for "NCBs" is at least 80. The default settings are too small in
  146. any case.
  147.  
  148. Note: Troubleshooting is greatly simplified if you first install the modem
  149. and ISDN server and the client software thereafter.
  150.  
  151.  
  152.  
  153. 3.2 Installing a Modem / ISDN Server
  154.  
  155. 3.2.1 Installation under Windows 3.x and Windows 95
  156.  
  157.   Insert the installation disk into your diskette drive and run SETUP.EXE.
  158.   After you have entered the destination path for the installation, you are
  159.   asked to choose between modem server and client. Select "Modem-/ISDN Server 
  160.   Installation" (Note: The setup program allows either to install a server or
  161.   a client at one time).
  162.   Next, select the desired network protocol.
  163.   Only select the IPX/SPX protocol if you are using a Novell Netware network.
  164.  
  165.   After you have finished your selections, the setup program will copy all 
  166.   necessary files. You can then enter your registration information (if you
  167.   own a valid Stomper-license).
  168.                               
  169.  
  170.   This registration information is then incorporated firmly in NETFOS.COM, 
  171.   NFCAPI.COM, STOMPER.COM, STOMPERF.COM, STISDN.COM and 
  172.   STOMPER.NLM.
  173.   STWIN.EXE, CAPI.DLL and STCLNT.VXD however, will read the registration
  174.   information from the [Stomper] section in SYSTEM.INI.
  175.  
  176.   The installation will be completed and finally, a "Stomper" program group
  177.   will be created.
  178.  
  179.  
  180.  
  181. 3.2.2 Installation on the Netware Fileserver (Modem Server Only)
  182.  
  183.   Copy STMGR.NLM and STOMPER.NLM preferrably to the directory
  184.   SYS:SYSTEM.
  185.  
  186.   3 components have to be loaded:
  187.  
  188.   the Stomper queue manager STMGR.NLM
  189.   an AIO driver
  190.   the modem server STOMPER.NLM
  191.  
  192.   1. The Stomper Queue Manager
  193.  
  194.   The queue manager performs the following tasks:
  195.  
  196.   1. "Tracker", observes the status of all modem servers installed in the
  197.   network, containing the following information: Status of the modem server 
  198.   (busy/free), the Client (Netfos) which is presently served, number of bytes 
  199.   transmitted in a session.
  200.   This information is analysed and displayed for example by STMON, the 
  201.   monitor program. 
  202.   This part of STMGR can exist several times in the network.
  203.  
  204.   2. "Queue manager", allocates free modem servers to the clients. In order to 
  205.   avoid chaos, the queue manager can only exist once in the network.
  206.  
  207.   3. IPX routing. The transmitter must always know the destination network in 
  208.   order to transport IPX packets over several network segments. STMGR 
  209.   therefore gives his address to all routers in the network (the file server
  210.   can also work as a router and therefore adds this address to its bindary). 
  211.   Stomper identifies this address by ordering it from the nearest router. When 
  212.   the queue manager allocates a modem server to a client, the network 
  213.   address of Stomper is supplied to the client. 
  214.  
  215.   4. Logging. If the option /L is specified, a log file will be generated, that logs 
  216.   all actions.
  217.  
  218.   5. Station restrictions (only STMGR.NLM) See Chapter Applying access 
  219.   rights.
  220.  
  221.  
  222.   1. In order to install STMGR.NLM on the file server, enter the following 
  223.   command at the console 
  224.  
  225.   load STMGR
  226.   
  227.   STMGR will display all installed modem servers of the network on the 
  228.   screen. At this point of the installation you will usually not have installed any 
  229.   modem servers. However, as soon as you start any modem or ISDN server in 
  230.   the network it will be displayed on the STMGR screen.
  231.   
  232.   Command line options for STMGR.NLM:
  233.   
  234.   /L...   If you specifiy this parameter, the queue manager will create a log 
  235.           file. In this file, every access to any modem server in the network 
  236.           will be logged (time of access, numbers dialed, etc.).
  237.           You can specify the name of the log file, e.g.:
  238.  
  239.     /LSYS:SYSTEM\ST.LOG
  240.  
  241.   If you only specify /L STMGR.NLM will create a log file with the 
  242.   default name STOMPER.LOG in the executable's directory.
  243.  
  244.   /A      Use this parameter to allow "autoattach" (ref. NETFOS /A)
  245.  
  246.   2.      The AIO Driver (Asynchronous I/O)
  247.  
  248.   The standard AIO driver for conventional serial ports is included with
  249.   Netware 3.12 and higher. However, up to Netware 4.x Novell is distributing
  250.   outdated versions of this driver. Therefore, you must install a newer
  251.   version of this driver. You can download the updated files e.g. from our
  252.   support BBS.
  253.   We suggest that you use at least AIOCOMX Version 2.11 and the 
  254.   corresponding AIO.NLM version 6.01a.
  255.   There are also other AIO drivers for various multiport extension boards
  256.   available (e.g. Digiboard), that are usually distributed by the board's
  257.   manufacturer.
  258.   Here are typical command lines for various COM ports:
  259.  
  260.   COM1
  261.   load aiocomx port=3f8 int=4 maxrate=115200
  262.   COM2
  263.   load aiocomx port=2f8 int=3 maxrate=115200
  264.   COM3
  265.   load aiocomx port=3e8 int=4 maxrate=115200
  266.   COM4
  267.   load aiocomx port=2e8 int=4 maxrate=115200
  268.  
  269.   If you want to install more than one modem server, accordingly load 
  270.   AIOCOMX.NLM multiple times.
  271.  
  272.  
  273. 3. The Modem Server STOMPER.NLM:
  274.  
  275. On the first installation, load STOMPER.NLM without command line 
  276. parameters:
  277.  
  278. load stomper
  279.  
  280. Stomper will thus display a list of all the installed AIO serial ports.
  281. You can then select the desired serial port. Subsequently, the modem server
  282. is started and shows the command line that you have to enter for future
  283. starts of STOMPER.NLM (i.e. the command line that should be included in your 
  284. AUTOEXEC.NCF), like:
  285.  
  286. Command Line:
  287. load stomper /p1,0,0
  288.  
  289.  
  290.  
  291. Additional command line options for STOMPER.NLM:
  292.  
  293. /Na    This is used to give the modem server an individual identification. 
  294.         'a' is replaced by an arbitrary digit or character. If you want to 
  295.         install more than one modem server, each one has to have a unique 
  296.         identification, e.g. /N1, /N2, /Ni, ...
  297. /R    Forces STOMPER.NLM to always use the hardware handshake 
  298.         (RTS/CTS). In particular, set this option when you intend using a 
  299.         fax software.
  300. /Lxxxxx    "Lock Baud". Using this option, you can force STOMPER.NLM to 
  301.         use a fixed bps rate (e.g. /L38400). For this to work, your 
  302.         application must access the modem via NETFOS and INT14 or 
  303.         FOSSIL. 
  304.         Windows applications will not be affected by this option.
  305.  
  306. You are able to install multiple modem servers (provided you purchased a 
  307. license for multiple modem servers) by loading STOMPER.NLM more than 
  308. once. (Please note that you have to use the /N command line option if you are 
  309. installing multiple modem servers).
  310.  
  311. With
  312.  
  313. unload stomper
  314.  
  315. ALL modem servers loaded on the file server will be removed.
  316.  
  317. Caution !!
  318.  
  319.   Netware 3.x - 4.x have a bug in the SPX-Protokoll. This bug known to 
  320. STOMPER.NLM and Stomper tries hard to avoid problems that might arise.
  321. But we do strongly advise you to install the following Novell patches:
  322.  
  323. PATCHMAN.NLM
  324. SPXDDFIX.NLM
  325. SPXFIX2.NLM
  326.  
  327. These three modules are contained in the archive STRTL3.EXE, that can be 
  328. downloaded free from Compuserve NOVLIB or from our support BBS.
  329.  
  330.   If you have problems loading AIO.NLM, STOMPER.NLM and 
  331. STMGR.NLM, and you get a message like 
  332.  
  333. "Public symbol IsColorMonitor not found",
  334.  
  335. then you have an old version of CLIB.NLM (Netware 3.11). Just install an 
  336. updated version, that is part of the archive LIBUP4.EXE (Compuserve 
  337. NOVLIB or our support BBS)
  338.  
  339.   Never ever enter IRQ 2 for a hardware driver (e.g. when loading 
  340. AIOCOMX). Netware uses this IRQ internally and "misusing" it will 
  341. generally destroy the file allocation table of the server's drives and you will 
  342. completely loose all data.
  343.  
  344.  
  345. 3.2.3 Installation under DOS
  346.  
  347. If you intend to run Stomper in a Novell Netware 3.11 or higher network, we 
  348. strongly recommend to install STMGR.NLM on the fileserver rather than
  349. installing the queue manager on a DOS station.
  350. Besides, STMGR.COM has the same command line options as STMGR.NLM.
  351.  
  352.  
  353. 3.2.3.1 Modemserver
  354.  
  355. (Most simple example:   STOMPER /P2)
  356.  
  357. The modem server accesses the modem (or another device), that is connected to 
  358. the RS-232 port. Apart from the application data, the line condition will be 
  359. updated whenever necessary. This condition includes DCD (Data Carrier Detect), 
  360. DTR (Data Terminal Ready), RI (Ring Indicator), DSR (Data Set Ready), RTS 
  361. (Ready To Send) and CTS (Clear To Send).
  362.  
  363. For DOS there are 2 variants of the modemserver:
  364.  
  365.   STOMPER.COM    accesses the serial port directly
  366.   STOMPERF.COM    uses a FOSSIL driver to 
  367.                 communicate with the hardware
  368.  
  369. Using STOMPERF.COM it is possible to share any communications hardware in 
  370. the network, as long as there is an apropriate FOSSIL driver available (like 
  371. CFOS for ISDN or Digiboard).
  372.  
  373. Command line parameters
  374.  
  375. STOMPER [/Px] [/Na] [/Lxxxx] [/U] [/F] [/Qxx] [/Bxxxx] [/Caaa...] [/R]
  376.  
  377. /P    selects the COM port for the modem, for example /P2 for COM2. If 
  378.         omitted, COM1 is selected automatically.
  379.  
  380. /U    is given to remove any already installed STOMPER from memory. 
  381.         This is only possible while Stomper is not in use.
  382.  
  383. /F    STOMPER is forced to use Netbios exclusively (even if IPX is 
  384.         loaded)
  385.  
  386. /Q     for unconventional IRQs. /Q7 => IRQ7
  387.  
  388. /B1    for unconventional ports. /B3E8  => Port 3E8
  389.  
  390. /C    Cooperative mode: refer to chapter "Cooperative Mode"
  391.  
  392. /L1    Lock Baud. Independent of the bps rate chosen by the application 
  393.         (terminal program,...), Stomper always selects automatically the bps 
  394.         rate of this parameter, for example /L57600 (locked).
  395.     Note: Windows applications ignore this parameter!
  396.  
  397. /N    one single character is added to this option (for example one character 
  398.         or one digit), giving the modem server an individual identification. 
  399.         Each modem server has to be identified individually (several modem 
  400.         servers on one computer each have a unique character or digit).
  401.  
  402. /R    forces RTS/CTS data flow control. This is very helpful, e.g. if you 
  403.         encounter problems when sending with Winfax. Normally this option 
  404.         does not affect any other applications, therefore you may always set it.
  405.  
  406. /Z     16550 FIFO buffer control
  407. /Z0    FIFO off
  408. /Z1    FIFO on 1 byte threshold
  409. /Z4    FIFO on 4 byte threshold
  410. /Z8    FIFO on 8 byte threshold (default)
  411. /Z14    FIFO on 14 byte threshold
  412.  
  413. It is not recommended to use this parameter! Stomper normally selects an
  414. 8 byte threshold for the FIFO buffer as the most sensible value to avoid
  415. errors.
  416. However, on very slow PCs (286 - 6 MHz), it may be necessary to use /Z1.
  417.  
  418.  
  419. 3.2.3.2 The ISDN Server
  420.  
  421. The ISDN server (STISDN.COM) makes a CAPI 1.1 (not 2.0) accessible to the
  422. clients on the network.
  423. One ISDN server can only serve one client at a time. To let more than one
  424. client access the CAPI at the same time, multiple ISDN servers have to be
  425. loaded. These can use the same CAPI, depending on how many simultaneous 
  426. applications this particular CAPI can support (usually 2 to 4).
  427.  
  428.  
  429. (Most simple example:  STISDN   - without any parameters)
  430.  
  431. Please note that command line parameter /M is usually necessary!
  432.  
  433. Command line parameters
  434.  
  435. STISDN [/Na] [/U] [/F] [/M...] [/Kn]
  436.  
  437.  
  438. /U    is used to remove any already installed STISDN from memory. This is 
  439.         only possible while STISDN is not in use.
  440.  
  441. /F    STISDN is forced to use Netbios exclusively (even if IPX is loaded)
  442.  
  443. /N    one single character is added to this option (for example one character 
  444.         or one digit), giving the modem server an individual identification. 
  445.         Each ISDN server has to be identified uniquely (several ISDN servers 
  446.         on one computer each have a unique character or digit).
  447.  
  448. /Kn    If you have multiple ISDN-adapters installed, you can tell STISDN to 
  449.         use the specified adapter (/K0 for adapter number 1). If you don't 
  450.         specifiy this parameter, the application will determine which adapter is 
  451.         used.
  452.  
  453. /M...    defines, how much memory is reserved for communications. The 
  454.         default is 16384 Bytes. Values may range from 4000 to 65500 Bytes.
  455.         The necessary value strongly depends on the application:
  456.  
  457. Example:
  458.  
  459. On the client station, the CAPI should be made accessible for CFOS:
  460.  
  461. CFOS i
  462.  
  463. The necessary memory can then be calculated from:
  464.  
  465. - B2 frame length    2048 Bytes
  466. - Windowsize    2
  467. - Max. Messages    20
  468.  
  469. 2048 Bytes * 2 + 20*180 = 7696 Bytes
  470.  
  471. CFOS i -w3 -a0
  472.  
  473. - B2 frame length    2048 Bytes
  474. - Windowsize    3
  475. - Max. Messages    20
  476. - Max B-Channels    2
  477.  
  478. 2048 Bytes * 3 * 2 + 20 * 180 = 15888 Bytes
  479.  
  480. The optimum really depends on the software you will be using and the 
  481. number of concurrent ISDN connections. The default value usually is 
  482. enough for one application. If you want to use two applications at the 
  483. same time, you should increase the value accordingly. ISDN programs 
  484. like Eurofile transfer or ISDN fax will usually need a setting of 
  485. /M65000.
  486.  
  487.  
  488. 3.3 Installing a  Modem / ISDN Client
  489.  
  490. 3.3.1 Installation under Windows 3.x and Windows 95
  491.  
  492.   Note that the CAPI 2.0 client is only available under Windows 95
  493.  
  494.   Insert the Installation disk into your diskette drive and run SETUP.EXE.
  495.   After you have entered the destination path for the installation, you are
  496.   asked to choose between modem server and client. Select "Client
  497.   Installation" (Note: The setup program allows either to install a server
  498.   or a client at one time).
  499.   
  500.   Next, select the desired network protocol.
  501.   Only select the IPX/SPX protocol if you are using a Novell Netware network.
  502.  
  503.   After you have finished your selections, the setup program will copy all 
  504.   necessary files. You can then enter your registration information, in case
  505.   you own a valid Stomper license.
  506.  
  507. This registration information (key) is then incorporated firmly in NETFOS.COM, 
  508. NFCAPI.COM, STOMPER.COM, STOMPERF.COM, STISDN.COM and 
  509. STOMPER.NLM.
  510. STWIN.EXE, CAPI.DLL and STCLNT.VXD however, will read the registration
  511. information from the [Stomper] section in SYSTEM.INI.
  512.  
  513.   The installation will be completed and finally, a "Stomper" program
  514.   group will be created.
  515.  
  516.  
  517. 3.3.2 Installation under DOS
  518.  
  519. 3.3.2.1 Modem Client
  520.  
  521. The modem client provides access to a modem server. All applications that
  522. use a FOSSIL driver or BIOS-INT14 (option /I) for communication can use
  523. it to access a network modem.
  524.  
  525. Command line parameters
  526.  
  527. NETFOS [/Px] [/U] [/I] [/F] [/Naaa...] [/A|/A+]
  528.  
  529. /P     specifies which COM port will be redirected. E.g. /P2 for COM2. 
  530.         COM1 is chosen automatically when this parameter is not used.
  531.  
  532. /U    removes an installed NETFOS from memory.
  533.  
  534. /I    This parameter is mandatory to redirect programs which communicate 
  535.         using the BIOS-INT-14. With this setting, Netfos finds out if an 
  536.         application is able to serve a fossil interface, and reacts accordingly.
  537.     
  538.     Without this setting, Netfos can only serve Windows programs or 
  539.         programs which support a fossil driver.
  540.  
  541. /F    Netfos uses Netbios (even if IPX is loaded)
  542.  
  543. /N1    All modem servers wanted in the network are listed here. When for 
  544.         example. /N123 is given, the queuemanager selects the first available 
  545.         modem server from the list. The priority is from left to right, so
  546.         that the queuemanager selects STOMPER /N2 when STOMPER /N1 is
  547.         occupied.
  548.         This option is invalid (and meaningless) in the 1-server version.
  549.  
  550. /A    "Autoattach"-mode. When a modemserver is assigned to a user after he 
  551.         was placed in the queue (waiting for a modemserver to become 
  552.         available), this option suppresses the message "Connected to 
  553.         modemserver". So the connection will be established without 
  554.         interaction. For both /A and /A+ STMGR must have been loaded with 
  555.         the option /A as well!
  556.  
  557. /A+    Same as /A, but additionally the user will be placed into the waiting 
  558.         queue automatically, in case there is no modemserver available. This 
  559.         mode runs completely unattended.
  560.  
  561. Note: /A and /A+ are only supported in the commercial version.
  562.  
  563. Note that the parameter /Px does NOT have to be identical for the two
  564. drivers. For STOMPER /Px defines the interface which is physically connected
  565. to the modem. Whereas NETFOS /Px defines only the interface which is
  566. addressed by the terminal program.
  567.  
  568.  
  569. 3.3.2.2 ISDN Client (CAPI 1.1 only)
  570.  
  571. The ISDN lient (NFCAPI) provides applications with a virtual CAPI v1.1-
  572. interface. Up to 4 applications can be serviced by the same NFCAPI.
  573.  
  574. Command line parameters
  575.  
  576. NFCAPI [/U] [/F] [/Naaa...] [/A[+]]
  577.  
  578. /U    removes an installed NFCAPI from memory.
  579.  
  580. /F    NFCAPI is forced to use Netbios (even if IPX is loaded)
  581.  
  582. /N    All ISDN servers wanted in the network are listed here. E.g. if /N123 is 
  583.         given, the queue manager selects the first available ISDN server from 
  584.         the list. The priority is from left to right, so the queue manager selects 
  585.         STISDN /N2 when STISDN /N1 is occupied.
  586.         This option is invalid (and meaningless) in the 1-server version.
  587.  
  588. /A    "Autoattach"-mode. When a ISDN server is assigned to a user after he 
  589.         was placed in the queue (waiting for a ISDN server to become 
  590.         available), this option suppresses the message "Connected to ISDN 
  591.         server". So the connection will be established without interaction. For 
  592.         both /A and /A+ STMGR must have been loaded with the option /A as 
  593.         well!
  594.  
  595. /A+    Same as /A, but additionally the user will be placed into the waiting 
  596.         queue automatically, in case there is no ISDN server available. This 
  597.         mode runs completely unattended.
  598.  
  599. Note: /A and /A+ are only supported in the commercial version.
  600.  
  601. If your ISDN adapter comes with the Windows CAPI driver CAPI.DLL, it can 
  602. run on top of NFCAPI to enable ISDN applications to access the ISDN server. 
  603. However, a prerequisite is that CAPI.DLL works with any DOS CAPI drivers 
  604. (e.g. Teles).
  605.  
  606.  
  607.  
  608. 4 Select specific modem servers by different ports
  609.  
  610. Example:
  611.  
  612. You have 5 modem / ISDN servers installed in your network:
  613.  
  614.   three modems with IDs '1', '2' and '3'
  615.   two ISDN-lines via CFOS with IDs '4' and '5'
  616.  
  617. Of course, you will want to use an ISDN-line, when you need an ISDN-line
  618. and a modem line, when you need a modem line. You can do this by simply
  619. entering the following command line:
  620.  
  621. NETFOS /P1(123) /P2(45)
  622.  
  623. When your Application addresses COM1, you will get connected to modemserver 1, 
  624. 2 or 3, whichever is available. When your application uses COM2, one of the
  625. ISDN lines will be selected.
  626.  
  627. Note that there is no option /N specified, since this is completely replaced
  628. by the values in brackets.
  629. You can specify up to 4 ports.
  630.  
  631. Only one of these ports may be used at one time.
  632.  
  633. Of course you can use this method to distinguish different modem types as
  634. well - ISDN was chosen as a typical example of different transport media.
  635.  
  636.  
  637. 5 The Cooperative Mode
  638.  
  639.  
  640. This mode - under certain circumstances - enables the use of another
  641. software (e.g. a mailbox) on the modem server - sharing the port
  642. cooperatively with Stomper. It should be used with caution, as it is no
  643. "well behaving" method.
  644. Regarding the ISDN server, this is not a problem, since CAPI supports
  645. cooperative applications anyway.
  646. Currently, the cooperative mode is not ready for Windows.
  647.  
  648. Parameter: /Cxxxxx
  649.  
  650. xxxxx stands for any modem command. At the end of a session this command is
  651. sent to the modem in order to re-initialize it. CR/LF is added to this
  652. string (for example ATZ), automatically. 
  653.  
  654. Thus the modem server can run a mailbox, which will be stopped automatically 
  655. when a client in the network demands the modem.
  656. While a caller is logged into the mailbox, Stomper is inactive.
  657.  
  658. In order to avoid fatal failures on the computer, please read the following
  659. lines even if this sounds a bit technical:
  660.  
  661. For safety reasons a network-modem demand is rejected, when the CD signal is 
  662. active, for example, when someone is logged into the mailbox. Stomper will
  663. also be blocked for another 60 seconds after the last ring. 
  664. This mode has to be handled with care, as it is quite rude to block an
  665. application just like that, but this can be done for example with FrontDoor
  666. and Remote Access.
  667.  
  668. As during the blocking of the modem the bps- rate could be changed, at the
  669. end of such a session Stomper sends an optional command (see above, "/Caaa")
  670. to the modem in order to set the correct bps rate. For this reason, the modem
  671. must have an automatic baudrate identification.
  672.  
  673. In the cooperative mode Stomper MUST NOT BE LOADED in the high memory 
  674. area (UMB), due to the following:
  675.  
  676. The computer will be stopped at an appropriate time, that is in the moment
  677. of a timer interrupt (produced by the computer 18 times per second). 
  678.  
  679. "Appropriate" means:
  680.  
  681. 1.    there is no hard disk or disk access 
  682. 2.    Windows is inactive
  683. 3.    The program interrupted is placed in the memory above stomper and
  684.         under the high memory area from A000:0000 on.
  685.  
  686. No. 3 ensures that no IPX routine has been interrupted.
  687. As Stomper depends on IPX, it would not dare to touch this without being
  688. affected personally. As Stomper needs the IPX (or Netbios) drivers, they
  689. are normally placed in a lower memory section or in an UMB. But if Stomper
  690. has also been loaded in the high memory area, there is no certainty where
  691. the network drivers are placed related to Stomper.
  692.  
  693. It is possible that the interrupt does not appear. This happens for example.
  694. when the command line in DOS is used, which is mainly executed in
  695. COMMAND.COM (below Stomper) or in BIOS (>A000). The use of the interface
  696. is not affected in this case.
  697.  
  698.  
  699.  
  700.  
  701. 6 Queue Management
  702.  
  703.  
  704. In order to enable a precise access to one or several modem servers in the
  705. network, the program
  706.  
  707. STMGR.COM
  708.  
  709. has to be loaded on one computer (any) in the network. STMGR.COM should 
  710. already be active in the network, before a Client (Netfos) or modem server 
  711. (Stomper) is loaded. Preferably this program should be installed on a modem
  712. server.
  713. If you are using Netware 3.11 or higher, it is strongly advised to run
  714. STMGR.NLM on the file server rather than using STMGR.COM on a DOS station.
  715.  
  716. This program operates completely in the background and does not require much 
  717. memory.
  718.  
  719.  
  720. The queue manager's strategies
  721.  
  722. When a client demands a modem server, the queue manager tries to allocate a
  723. free modem server which is selected by NETFOS /Naaa...(from left to right).
  724. In case all modem servers are busy, the client computer receives the
  725. following message:
  726.  
  727. No modemserver available. Queue in?       Y/N
  728.  
  729. After confirming Y, the following message appears:
  730.  
  731. Queued in. Wait in foreground?         Y/N
  732.  
  733. Now there are two possibilities:
  734.  
  735. 1.    "Wait in the background" (N) tells the application that no fossil
  736.         driver is installed (not recommended for pure BIOS INT14
  737.         applications). The computer can be used and as soon as a modem
  738.         server is free, the following message appears:
  739.  
  740.     Connected to modem server            (ENTER)
  741.  
  742. The queue manager marks the modem server as "reserved". The user has
  743. 1.5 minutes to start his application and to use the modem server.
  744.  
  745.  
  746. 2.    While waiting in the foreground, the following message appears
  747.  
  748. Waiting for modem server...            (ESC)
  749.  
  750. In the meantime the computer cannot be used for other applications.
  751.  
  752. Under windows this process is executed accordingly, but only the application
  753. in use is paused. Other applications may be used - as far as multitasking is
  754. possible.
  755.  
  756. 7 The Monitor
  757.  
  758. The monitor (STMON.EXE) provides an overview over the modem servers installed 
  759. in the network and the proceedings can be observed. The monitor is started by 
  760. loading
  761.  
  762. STMON
  763.  
  764. As STMON displays the information obtained from the tracker, it depends on 
  765. STMGR.COM being loaded. If STMGR is not already in memory, the monitor will 
  766. load it automatically. For this, however, STMGR.COM must be either
  767.  
  768.     -    in the same directory as STMON.EXE or
  769.     -    in the DOS path.
  770.  
  771. Attention: The monitor must not be started in a DOS box under windows!
  772.  
  773. The monitor displays ten sections on the screen, each containing information
  774. of an individual modem server.
  775.  
  776. Field identifications:
  777.  
  778.   Network address - individual address in the network which is preset by the 
  779. network adaptor. In order to obtain a better overview, a file called
  780.  
  781. NODES.LST
  782.  
  783. can be created, in which names are allocated to the network addresses. An 
  784. example for such a file:
  785.  
  786. 924e32a     John's abacus
  787. 80ca23e5     venus
  788.  
  789. ... allocating the names "John's abacus" and "venus" to the according 
  790. network addresses. John's abacus and venus will replace the cryptic address 
  791. names on the monitor.
  792.  
  793.   Served interface - the serial interface served by the modem server or CAPI 
  794. in case of an ISDN adapter.
  795.  
  796.   Status - status of the modem server. Possible states:
  797.  
  798. - free           the modem server is available at the moment
  799. - Ser. <Client>  the modem server is just serving the client named 
  800.                  <Client>
  801. - Res. <Client>  the modem server is presently reserved for the client 
  802.                  <Client>.
  803. - locally in use The modem server is presently used locally in the /"C" 
  804.                  mode (for example for a user in the mailbox)
  805.  
  806.   Sent / received bytes - number of bytes transmitted in the current session. 
  807. This information will be held until the start of a new session.
  808.  
  809.   Identification - the identification of the modem server (/Na).
  810.  
  811.   connected with - The number dialed will be displayed here as soon as a 
  812. Carrier Detect (CD) has been encountered.
  813.  
  814.  
  815. 8 Programs Using INT 14 (BIOS)
  816.  
  817.  
  818. The fossil driver is to be understood as an extension to the BIOS-INT 14
  819. interrupt.
  820. However, Stomper expects that the software used initializes the fossil
  821. driver (not necessary with BIOS routines).
  822. For programs only using BIOS-INT 14, NETFOS has to be loaded with the 
  823. parameter /I. 
  824. With pure INT 14 applications, Stomper always switches to RTS/CTS data flow 
  825. control.
  826.  
  827. Approximately 20 seconds after the end of an "INT-14 program" the modem
  828. server becomes available for others again.
  829.  
  830. When using fax software, which communicates via INT 14, it is absolutely
  831. necessary to lock Stomper on an appropriate rate. The ideal bps rate
  832. depends on the modem used. 
  833. Standard modems transmit faxes with a rate of up to 14400 bps, or
  834. 19200 bps on the phone line. In this case the bps rate has to be locked
  835. on 19200 bps. Most modems accept a higher rate, for example 57600 bps, when
  836. transmitting faxes.
  837.  
  838. For modems with a maximum baud rate of 9600 bps, Stomper should be locked on 
  839. 9600 bps (see parameter /L on page 6). 
  840.  
  841.  
  842.  
  843. 9 Applying access rights
  844.  
  845. STMGR.NLM provides a mechanism to refuse access to all or specific 
  846. modemservers by username, stationaddress and/or network.
  847.  
  848. This mechanism is activated, as soon as STMGR.NLM finds a file named 
  849. QMREST.LST in the same directory, STMGR.NLM is contained in (the activation 
  850. of the access rights happens during startup of STMGR). If this file is not
  851. present, no restrictions apply.
  852.  
  853. The contents of the file QMREST.LST could look like this:
  854.  
  855. [stations]
  856. 928485
  857. 80A23E42       12Q
  858.  
  859. [nets]
  860. 1000002
  861. 1000003        1
  862.  
  863. [names]
  864. supervisor
  865. Peter       24
  866.  
  867. This file is shown on the next page with comments included.
  868.  
  869. Rules:
  870.  
  871.   there are 3 possible sections: [stations], [nets] and [names]
  872.   you can omit particular sections. There will be no restrictions for these
  873.   sections. If a section is present, it defines objects (stationaddresses,
  874.   usernames or networkaddresses), that have access to modemservers. All
  875.   objects of this sectiontype, that are not defined, will not have access to
  876.   any modemserver.
  877.   if only the object is entered in a line, it receives access rights to all
  878.   modemservers throughout the network. If you additionally enter a list of
  879.   modemserver-ids -separated by spaces or tabs from the objects designation
  880.   - the object will only have access to the specified modemservers.
  881.   access rights are combined by logical and, which means, the user must
  882.   qualify by station, network and username (in case restrictions apply
  883.   respectively)
  884.  
  885. Typically the file QMREST.LST will only contain a [names] or [nets] section.
  886. Example for QMREST.LST with comments
  887.  
  888. ; Lines beginning with a semicolon are treated as comments and are 
  889. ; ignored
  890.  
  891. ; There are 3 sections in this file:
  892. ; [stations]
  893. ; [nets]
  894. ; [names]
  895. ;
  896. ; Sections can be omitted. If there is no section named [stations], 
  897. ; then there will be no station restrictions.
  898.  
  899. ; The section [stations] lists all stations, that have access to 
  900. ; modemservers
  901.  
  902. [stations]
  903. ; Station 928485 has access to all modemservers:
  904. 928485
  905.  
  906. ; Station 80A23E42 has access to modemservers 1, 2 and Q:
  907. 80A23E42       12Q
  908.  
  909. ; All other stations have no access rights to any modemservers!
  910.  
  911. [nets]
  912. ; All stations in net 1000002 may use all modemservers, if they are 
  913. ; not restricted by username or network number
  914. 1000002
  915.  
  916. ; The stations in network number 1000003 only have access to 
  917. ; modemserver 1
  918. 1000003        1
  919.  
  920. ; All other networks have no access to any modemserver!
  921.  
  922. [names]
  923. ; Supervisor has access to all modemservers, as long as no 
  924. ; station/network restrictions apply:
  925. supervisor
  926. ; Peter may only use modemserver 2 and 4
  927. Peter       24
  928.  
  929. ; If there is no section [names], you can even use modemservers
  930. ; without logging in.
  931.  
  932. ; Note! Even though the supervisor is generally given access to all 
  933. ; modemservers, station- and network-restrictions still are active!
  934.  
  935. ; Example: Peter is logged in on station 80A23E42 in Network number
  936. ; 1000002. Therefore he can only use the modemserver with ID '2
  937.  
  938. Appendix A Suitable Programs
  939.  
  940. All windows programs, using the functions (API) provided by windows 
  941. COMM.DRV for the interface addressing, are suitable.
  942.  
  943. DOS:
  944.  
  945. Not every terminal program supports a fossil driver. An example for a program
  946. with FOSSIL support is Telemate (In Options / Terminal, FOSSIL can be
  947. selected)
  948.  
  949. For the use of Telemate note the following: in order to work with the dial
  950. list, for each listing the fossil driver has to be selected individually.
  951. To select the fossil support in Telemate, first the baud rate has to be set
  952. to a maximum of 38400bps. Otherwise fossil will be ignored!
  953.  
  954. BinkleyTerm, FrontDoor (mailer systems) and RemoteAccess (a mailbox system) 
  955. have no problems working with Stomper.
  956.  
  957.  
  958. Appendix B NETINFO.EXE
  959.  
  960. This a small diagnostic tool added to the packet, giving some information of the 
  961. network environment (received from netbios), for example 
  962.  
  963.  
  964. Permanent name:                 0000C0039A79  ; network address
  965.  
  966. Jumper:                         40
  967. POST result:                    00
  968. Version:                        0.1
  969. Minutes up:                     0
  970. Number of CRC errors:           0
  971. Number of alignment errors:     0
  972. Number of collisions:           0
  973. Number of aborts:               1
  974. Number of transmitted packets:    6
  975. Number of received packets:     10
  976. Number of retransmits:          4
  977. Number of out-of-buffer-counts:    0
  978. Free NCBs:                      10
  979. Max. NCBs:                      12
  980. Active sessions:                32
  981. Max. packet size:               1024
  982. Names:                          1
  983. NFOSMPX1                        0
  984.  
  985.  
  986. Attention! This tool can only be useful when Netbios is actually installed.
  987. Otherwise no useful information will be displayed here! This information
  988. is of no use for IPX.
  989.  
  990.  
  991. Appendix C Tips
  992.  
  993. 1. Telemate
  994.  
  995. Before you select FOSSIL, be careful to set the speed to not more than
  996. 38400 bps.
  997. Otherwise Telemate will reject the FOSSIL-Setting (without displaying a
  998. message).
  999. In case even this fails, the safest way is to edit TM.CFG manually. Just
  1000. change
  1001.  
  1002. Connection=Modem
  1003.  
  1004. to
  1005.  
  1006. Connection=Fossil
  1007.  
  1008. and make sure that the entry Port= is correct.
  1009.  
  1010. Also, FOSSIL has to be selected for every entry in the Dial-List.
  1011.  
  1012.  
  1013. 2. Terminate
  1014.  
  1015. Early versions of Terminate (<3.x) had a problem identifying a FOSSIL driver
  1016. that does not support all serial ports at once, like does NETFOS. If you
  1017. have Terminate 3.x or higher, you don't have to read on.
  1018. The first time Terminate is set up for FOSSIL, it expects that a FOSSIL
  1019. driver is installed on COM1. This, of course, is not always given (e.g.
  1020. NETFOS installed on COM2). It may result in a system-crash.
  1021.  
  1022. Workaround:
  1023.  
  1024. either use NETFOS on COM1 or
  1025.  
  1026. the first time, you switch Terminate to FOSSIL, do it with a regular FOSSIL
  1027. driver (like BNU or X00) installed. From then on you can use NETFOS.
  1028.  
  1029. If you don't have a FOSSIL driver handy, load
  1030.  
  1031. NETFOS /P1() /P2()
  1032.  
  1033. This installs NETFOS on both COM1 and COM2.
  1034. 3. Telix For Windows
  1035.  
  1036. Use the COM-Setting, not FOSSIL! In Windows it is always recommended to use 
  1037. STCOMM whenever possible.
  1038. Apart from that, the FOSSIL support of early versions of TfW is buggy.
  1039.  
  1040.  
  1041. 4. Crosspoint
  1042.  
  1043. In case Crosspoint does not work properly with Stomper, you might try loading 
  1044. NETFOS with the /I option. Crosspoint's FOSSIL support is not very clean in
  1045. some places.
  1046.  
  1047.  
  1048. 5. pcAnywhere
  1049.  
  1050. Use the plain INT14-Setting and do not set higher speeds than 9600 bps.
  1051. Otherwise pcAnywhere will not be able to initialize the port.
  1052. To achieve higher speeds, refer to the modemserver switch /L.
  1053.  
  1054.  
  1055. 6. CFOS
  1056.  
  1057. These tips refer to CFOS/DOS.
  1058. CFOS/Win should be treated similarily.
  1059. There are two ways to install an ISDN server using CFOS:
  1060.  
  1061. 1. CFOS installed on the modem server.
  1062.  
  1063. The drivers need to be loaded in this sequence
  1064.  
  1065. CAPI
  1066. CFOS
  1067. STOMPERF
  1068.  
  1069. Thus, clients can only access ISDN via the FOSSIL interface. Applications
  1070. that access the CAPI must have STISDN / NFCAPI. 
  1071.  
  1072. 2. CFOS installed on the client stations.
  1073.  
  1074. On the modem server, you load
  1075.  
  1076. CAPI
  1077. STISDN [...]
  1078.  
  1079. And on the clients, you load
  1080.  
  1081. NFCAPI [...]
  1082. CFOS [...]
  1083.  
  1084. The main drawback of this second alternative is that the ISDN server is
  1085. accessed and locked by the client station as soon as CFOS is loaded.
  1086. Whereas in the first alternative, the ISDN server is accessed only if there
  1087. really is an application demanding access via NETFOS.
  1088.  
  1089.  
  1090.  We suggest to load CFOS with the following options: 
  1091.  
  1092.  /w3 /jr
  1093.  
  1094.  
  1095.  
  1096. 7. Tobit FaxWare
  1097.  
  1098.  STOMPER.NLM can share the same port with Tobit FaxWare. However, 
  1099. FaxWare may then not be set to automatic fax reception since the port is 
  1100. continuously in use by FaxWare in this case.
  1101.  
  1102.  
  1103.  
  1104. Appendix D Troubleshooting
  1105.  
  1106. This chapter has been moved to a small program named HELP!.EXE. Using this 
  1107. little DOS program, you can get help for specific problems.
  1108. Just start the program by entering HELP! in the Stomper directory on the DOS 
  1109. command line or in a DOS box of Windows.
  1110.  
  1111.  
  1112. Appendix E Performance
  1113.  
  1114. The modem server may transmit up to 17,000 Bytes per second. Anyways, you 
  1115. may only get to this limit if you are using CFOS / STOMPERF with channel 
  1116. bundling.
  1117.  
  1118. The ISDN-Server allows up to 34,000 Bytes per second, corresponding to
  1119. about 4 bundled channels.
  1120.  
  1121.  
  1122.  
  1123. Appendix F What is a FOSSIL driver?
  1124.  
  1125. There are various possibilities for a DOS program to address serial
  1126. interfaces of a PC:
  1127.  
  1128. There is the hardware related method, communicating directly with the
  1129. interface components. This method is used very often because it∩s quick
  1130. and uncomplicated for the program user - no unnecessary thoughts about
  1131. a fossil driver and its implementation.
  1132.  
  1133. "Polite" programs use the 4 functions provided by the computer BIOS (INT 14): 
  1134. Baud rate setting, character transmission, character receive and fetching the
  1135. interface status. This method has the advantage of being hardware independent
  1136. (only BIOS has to have the information how to communicate with the hardware -
  1137. the programmer isn∩t troubled with that). Big and decisive disadvantage:
  1138. under DOS, BIOS allows max. 9600 bps, which is out of date today. Furthermore
  1139. BIOS routines are generally quite slow.
  1140.  
  1141. Another possibility is the fossil driver, combining the advantages of the
  1142. solutions mentioned above - speed and hardware independence - troubling the
  1143. user with only one installation.
  1144.  
  1145. The fossil driver offers buffered interface communication as an additional
  1146. function to the BIOS, emulating the interface functions of BIOS. Data arriving
  1147. at the interface needn∩t be handled immediately by the software, but are
  1148. stored in a ring buffer. A program using BIOS for example, has to handle
  1149. every single character before the next arrives in order to avoid a loss of
  1150. data. With a fossil driver the data can be fetched and handled in blocks.
  1151.  
  1152.  
  1153. Appendix G What is a network fossil driver?
  1154.  
  1155.  
  1156. It∩s easy to exploit the advantage of a hardware independent program with
  1157. the use of a fossil driver. A suitable driver can pretend any digital
  1158. communication element against such a hardware independent program, for
  1159. example as COM2. The programm doesn∩t care how this works, as long as the
  1160. driver handles the mass of data.
  1161.  
  1162. Stomper uses this circumstance. A modem server is installed on a network
  1163. integrated computer linked to a modem. The modem server waits for a network
  1164. fossil driver connection, which again bluffs to be communicating with a
  1165. serial interface. At the same time a lot of instruction data and other data
  1166. are passed over the network, but don∩t worry, a normal network is hardly
  1167. concerned with that.
  1168.  
  1169.  
  1170. Appendix H Support
  1171.  
  1172. Pflug Datentechnik may be reached via:
  1173.  
  1174. Fax     +49 7157-216-22
  1175. e-mail  support@pflugdt.lb.eunet.de
  1176. Compuserve    Pflug Datentechnik 100340,1047
  1177. Fido    2:246/1009        (Only Crashmail!, please)
  1178. Mailbox (BBS)   +49 7157-216-23
  1179.  
  1180.  
  1181. Current Stomper versions can be downloaded from our BBS or from the WEB:
  1182.  
  1183. http://pweb.eunet.de/pflugdt.lb
  1184.  
  1185.