home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / prog2 / nmdm21.lzh / NMODEM.DOC < prev    next >
Encoding:
Text File  |  1990-03-02  |  11.8 KB  |  307 lines
  1.  
  2.  
  3.  
  4.         
  5.         
  6.         
  7.         
  8.         
  9.         
  10.         
  11.         
  12.         
  13.         
  14.         
  15.         
  16.         
  17.         
  18.         
  19.         
  20.         
  21.         
  22.         
  23.         
  24.         
  25.         
  26.         
  27.         
  28.                                   NetBIOS Modem
  29.         
  30.                                   By Chris Cox
  31.                                    March 1990
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.         
  39.         
  40.         
  41.         
  42.                           Required hardware & software.
  43.         
  44.              An IBM compatible PC for use as the modem server.
  45.         
  46.              An IBM compatible PC for use as the modem user.
  47.         
  48.              A NetBIOS compatible local area network.
  49.         
  50.              A modem for use at the modem server.  
  51.         
  52.         
  53.         Note  this program requires the use of a modem which can be  con-
  54.         figured to completely ignore the status of the RS232c Data Termi-
  55.         nal  Ready (DTR) status line.  If your modem hangs up  the  tele-
  56.         phone line when the DTR line is lost, MSVR will not function.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.         
  64.         This  is a brief synopsis of the purpose, configuration  require-
  65.         ments, and usage of NetBIOS Modem, by Chris Cox.
  66.         
  67.         At this time, NetBIOS Modem is still under extensive  development 
  68.         however,  in its present form, it does fill a void in many  local 
  69.         area  networks:  that of allowing more than one person to  use  a 
  70.         modem.
  71.         
  72.         NetBIOS Modem relies on the communications capabilities  afforded 
  73.         by  any  network which, either relies on, or  at  least  supports 
  74.         (such as Novell's NetWare), the NetBIOS communications interface.
  75.         
  76.         Unlike  many of it's commercial counterparts, NetBIOS Modem  does 
  77.         not create an interface which adhere's to any formal, or de facto 
  78.         IBM PC communications structure at this time.  Hence, anyone  who 
  79.         needs  to use the modem MUST use the included terminal  emulation 
  80.         program  VTERM.EXE.  It is anticipated that this will not be  the 
  81.         case in the future, but for the time being, that's the way it is!
  82.         
  83.         Please  be warned, this package has only had limited  testing  on 
  84.         one  network, so it is not impossible that there  are  additional 
  85.         bug's  to  those which will be described in appendix  A  of  this 
  86.         document.
  87.         
  88.         If you find any additional bug's, please report them to me either 
  89.         via  CompuServe 72711,1775, or MCI Mail account  "Christopher  G. 
  90.         Cox".
  91.         
  92.         As  is  standard with most software, by using this  package,  you 
  93.         agree to indemnify me against, and I specifically refuse to carry 
  94.         any  liability from your, or anybody else's, use of this  package 
  95.         or any part of it.
  96.         
  97.         You  may distribute this package freely, as long as NO CHARGE  of 
  98.         any  form is made, including duplication, etc.  In addition,  all 
  99.         files  supplied in this package as listed on the  following  page 
  100.         must be included, and no additions or removals are allowed.
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.         Files included in this package are as follows:
  108.         
  109.         NMODEM.DOC          This document.
  110.         
  111.         MSVR.EXE            The executable program which runs on the PC
  112.                             acting as the modem server.
  113.         
  114.         VTERM.EXE           The executable program which runs on the PC
  115.                             using the modem server (i.e. the user!).
  116.         
  117.         VT$DIAL.DAT         An optional ASCII file which contains the
  118.                             name and number of frequently called systems
  119.                             (Please note it is optional whether or not
  120.                              you use this file.)
  121.         
  122.         The  file VT$DIAL.DAT is a simple ASCII file which  contains  the 
  123.         name  and telephone numbers of any services which  you  regularly 
  124.         call  using  the  NetBIOS Modem.  Use of this  file  is  entirely 
  125.         optional.   As  it contains just ASCII data, you may  create  and 
  126.         edit  it using any ASCII editor, including EDLIN.  The format  of 
  127.         this  file  will be described after the  pre-usage  configuration 
  128.         which follows on the next page...
  129.         
  130.         The  only file which has to be available to anyone who  needs  to 
  131.         use your modem is VTERM.EXE.
  132.         
  133.         Conversely,  the  personal computer which is to function  as  the 
  134.         modem server only needs to have access to the file MSVR.EXE.
  135.         
  136.         If you wish to make use of the dialing directory, ensure that you 
  137.         call VTERM from the directory in which VT$DIAL.DAT is stored.  If 
  138.         you are using the NetBIOS Modem on a Novell NetWare network,  and 
  139.         you place VT$DIAL.DAT in the SYS:PUBLIC directory, then it can be 
  140.         found  by  any user who has SYS:PUBLIC included in  their  search 
  141.         path AS LONG AS THAT USER's LOGGED DRIVE IS A NETWORK DRIVE, when 
  142.         they execute VTERM.
  143.         
  144.         Only  one  user at a time can access any one modem.   If  another 
  145.         user  is  connected to the modem, then an error message  will  be 
  146.         sent  to the second user, and the program will exit back to  DOS.  
  147.         However, mode than one copy of MSVR can be run simultaneously  as 
  148.         long  as any additional copies operate at a different baud  rate.  
  149.         Baud rates supported are 110, 300, 1200, 2400, 4800, 9600, 19.2k, 
  150.         38.4k, & 57.6k baud.  The program has only been tested up to 9600 
  151.         baud  at this time.  The default baudrate, if not  specified,  is 
  152.         2400, as with version 1.0.
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.         Configuration requirements.
  160.         
  161.         The  current  version of NetBIOS Modem requires the use of  a  PC 
  162.         dedicated  to operation as a modem-server.  Version 2.0 has  been 
  163.         tested under DesqView 2.26 and operates successfully in a  multi-
  164.         tasking environment.
  165.         
  166.         MSVR requires a Hayes-compatible modem, connected to your PC  via 
  167.         either COM1:, COM2:, COM3:, or COM4:.
  168.         
  169.         Usage is straightforward.  Simply type the command
  170.         
  171.                   MSVR [port] [baud-rate]
  172.                        where [port] is a number between 1 and 4.  The 
  173.                        default value is 1 for COM1:.
  174.                        and [baud-rate] is one of 110, 300, 1200, 2400,
  175.                        4800, 9600, 19200, 38400, 57600.  The default
  176.                        value is 2400.
  177.         
  178.         Please note that MSVR should be run before running VTERM. If MSVR 
  179.         has  not  been  run, or there is not a server  available  at  the 
  180.         specified baud-rate, VTERM will fail and give an error message.
  181.         
  182.         Usage of VTERM is even easier.  It has only one optional  parame-
  183.         ter  which may be used to specify the baudrate.  To use  a  baud-
  184.         rate other than 2400, MSVR must be run with the alternative baud-
  185.         rate specified.  If no baud-rate is supplied, 2400 will be used.
  186.         
  187.                   VTERM [baud-rate]
  188.         
  189.         and you're on your way.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.         Dialing directory.
  197.         
  198.         As  stated  before the format of the dialing  directory  is  very 
  199.         simple.   Each  entry in the directory consists of a NAME  and  a 
  200.         NUMBER.   That's it.  Nothing more, nothing less.   Please  note, 
  201.         however,  if you do create a dialing directory, it must have  the 
  202.         entry LAST following the final directory entry, and there can  be 
  203.         no more than 20 (twenty) entries in the directory.
  204.         
  205.         Consider the contents of the VT$DIAL.DAT file supplied...
  206.         
  207.         MCI Mail
  208.         1-800-456-6245
  209.         CompuServe (Minneapolis port)
  210.         339-2507
  211.         LAST
  212.         000
  213.         
  214.         This file contains two valid entries, followed by the LAST entry.
  215.         The  fields  in  the file are line-delimited, i.e.  each  name  & 
  216.         number is terminated by a Carriage Return / Line Feed sequence.
  217.         
  218.         This file is so simple, it could even be created by entering  the 
  219.         following command (and in fact was...)
  220.              
  221.                   COPY CON VT$DIAL.DAT
  222.                   MCI Mail - 2400 Baud<ENTER>
  223.                   1-800-456-6245<ENTER>
  224.                   CompuServe (Minneapolis port)<ENTER>
  225.                   339-2507<ENTER>
  226.                   LAST<ENTER>
  227.                   000<ENTER>
  228.                   ^Z  (Control Key & Z)
  229.         
  230.         Please don't forget the twenty entry limit!
  231.         
  232.         The  directory is available at any time in VTERM by pressing  the 
  233.         <F10> key.
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.         File Transfers.
  241.         
  242.         Version  2.0 adds the capability to send and receive files  using 
  243.         the  XModem & YModem (1k-XModem) protocols.  YModem BATCH is  not 
  244.         supported in version 2.0.
  245.         
  246.         XModem  &  YModem facilitate the transmission  and  reception  of 
  247.         files  with their inherrent error checking protocols.   The  file 
  248.         transfer feature is activated by pressing the <F9> function  key.  
  249.         You  will see a window popup on your screen asking you  to  enter 
  250.         four items.
  251.         
  252.         The  first  is  the name of the file which you want  to  send  or 
  253.         receive.   You  may  enter upto 64 characters  into  this  field, 
  254.         allowing  for the files full pathname.  If you leave  this  field 
  255.         blank, pressing ESCAPE will return you to the terminal emulator.
  256.         
  257.         Two  of  the other fields have default values assigned  to  them.  
  258.         One  of these fields is used to select X or YModem - the  default 
  259.         is XModem.  The other is used to specify NAK or CRC XModem.  This 
  260.         option  defaults  to CRC, which is a significantly  better  error 
  261.         checking  method  than the original NAK form of  XModem.   YModem 
  262.         always uses CRC, irrespective of the method you select.
  263.         
  264.         The  fourth  field you must specify is for  Upload  or  Download.  
  265.         There  is  no default value for this field, so  you  must  choose 
  266.         either U or D.
  267.         
  268.         Once  you have filled in the necessary fields, press  the  ESCAPE 
  269.         key to initiate the file transfer.
  270.         
  271.         Remember,  if  you want to leave the file transfer  mode  without 
  272.         sending or receiving a file, leave the filename field blank,  and 
  273.         press ESCAPE.
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.         Appendices.
  281.         
  282.         Appendix A - Known bugs.
  283.         
  284.         The bug that caused characters to be dropped has been eliminated, 
  285.         by dropping the DTR status line when sending a packet to the user 
  286.         running  VTERM.   This now requires that your  modem  ignore  the 
  287.         status of the DTR line.
  288.         
  289.         *** FIXED ***
  290.              So far, there's only one known bug, and it's more of  a 
  291.              nuisance than a problem!  The problem is that occasion-
  292.              ally (about once every two of three screensful of text) 
  293.              a character will get printed twice, or alternatively, a 
  294.              character will get dropped.
  295.         
  296.              By monitoring the screen on the modem server, it can be 
  297.              seen  that for some reason this character  is  actually 
  298.              appearing  twice in, or being dropped from,  the  RS232 
  299.              input buffer.  This does not occur with other  programs 
  300.              which  use the same C asynchronous  communications  li-
  301.              brary,  and so appears to be caused  intermittently  by 
  302.              the NetBIOS calls.  This is undergoing further examina-
  303.              tion.
  304.  
  305.  
  306.  
  307.