home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 May / PCO_5_97.ISO / FilesBBS / OS2 / CF2B1205.ARJ / CF2B1205.ZIP / VCFOS2.DOC < prev    next >
Encoding:
Text File  |  1997-02-18  |  7.9 KB  |  236 lines
  1.         vcFos/2 -- OS/2 Virtual FOSSIL Driver
  2.         ----------------------------------------------------------------
  3.  
  4.  
  5.  
  6.         Hi!
  7.         ---
  8.  
  9.         This is the README for vcFos/2, the OS/2 virtual FOSSIL driver
  10.         for cFos/2.
  11.  
  12.         For more info on how to contact us etc., see README.OS2.
  13.  
  14.         For registering information see the ORDER.* files.
  15.  
  16.  
  17.  
  18.  
  19.         What is it?
  20.         -----------
  21.  
  22.         vcFos/2 is a virtual FOSSIL driver for OS/2 DOS boxes. That is,
  23.         it 'emulates' a FOSSIL driver in a DOS box. 'Emulate' means, that
  24.         vcFos/2 is no full FOSSIL driver with it's own logic etc., but it
  25.         simply is an interface and translator between FOSSIL functions and
  26.         OS/2 phyiscal device drivers (PDDs).
  27.  
  28.         vcFos/2 does only support cFos/2 COM-ports to prevent trouble
  29.         with other serial drivers (COM.SYS etc).
  30.  
  31.         vcFos/2 currently supports all FOSSIL functions including the
  32.         'Install/Deinstall application' functions 0x7e/0x7f. Some functions,
  33.         however, are not fully functional, see below 'Bugs'.
  34.  
  35.         vcFos/2 uses a 'taming' mechanism for the 'get status' FOSSIL
  36.         function. The status is 'cached' in vcFos/2 and only updated when
  37.         really needed, but at least every 50 milliseconds. This should be
  38.         ok for most applications.
  39.  
  40.         vcFos/2 uses internal receiver and transmitter buffers to speed up
  41.         the receiption and transmission of data. The size of these buffers
  42.         is currently 1kb.
  43.  
  44.         vcFos/2 allocates about 1kb in your DOS box for some of the FOSSIL
  45.         functions as well as the FOSSIL and driver signatures.
  46.  
  47.  
  48.  
  49.  
  50.         How to install:
  51.         ---------------
  52.  
  53.         Include a line in your CONFIG.SYS file like:
  54.  
  55.            DEVICE=c:\cfos\vcfos.sys <settings>
  56.  
  57.         The settings map FOSSIL ports to OS/2-COM-ports. They look
  58.         like <FOSSIL-port>=<COM-port-name>, i.e. the following example
  59.         would load vcFos/2 and map FOSSIL port 2 to COM5 and port 3
  60.         to COM6:
  61.  
  62.            DEVICE=c:\cfos\vcfos.sys 2=COM5 3=COM6
  63.  
  64.         The other COM-ports will not be supported by vcFos/2. vcFos/2
  65.         will give control to the next driver in the INT 14 chain. Use
  66.         vcFos/2 only on cFos/2 ports for now. This may be enhanced in
  67.         a future version.
  68.  
  69.         Note: FOSSIL ports start at 0, COM ports start at 1. So, many
  70.            DOS software that uses FOSSIL lets you set the COM-port as
  71.            COMx. The above example will create COM-ports in the
  72.            DOS-boxes named COM3 (FOSSIL port 2) and COM3 (port 3).
  73.  
  74.         If you do not specify any settings, vcFos/2 will load with
  75.         the FOSSIL ports 0-7 mapped to the OS/2-COM-ports COM1..COM8,
  76.         but will only support those ports cFos/2 is loaded for.
  77.  
  78.         You may specify up to 8 port mappings.
  79.  
  80.         When vcFos/2 is loaded it checks for cFos/2 of at least version
  81.         0.81. If none found, vcFos/2 will beep and not load.
  82.  
  83.         vcFos/2 MUST be loaded in CONFIG.SYS; it can NOT be loaded at
  84.         the DEVICE entry of a DOS-Box.
  85.  
  86.  
  87.  
  88.  
  89.         How does this mapping work?
  90.         ---------------------------
  91.  
  92.         vcFos/2 provides up to 8 FOSSIL ports in a DOS-Box. Those FOSSIL
  93.         ports have numbers, starting at 0.  You may specify a "mapping"
  94.         for each FOSSIL port to an cFos/2 COM-port, i.e. you specify
  95.         which cFos/2 port is accessed, when a certain FOSSIL port is
  96.         accessed.
  97.  
  98.         Regard the following example:
  99.  
  100.            DEVICE=CFOS.SYS COM5
  101.            DEVICE=VCFOS.SYS 7=COM5
  102.  
  103.         When you open a DOS-box, you may now access the FOSSIL port 7
  104.         (which, because of the naming convertions mentioned in the
  105.         above paragraph is often named COM8) _from_inside_the_dos_box_!
  106.  
  107.         The vcFos/2 COM-port namings inside a DOS-box have nothing
  108.         to do with those names of the OS/2 (or cFos/2) ports! As you
  109.         see, the DOS-box-COM-port COM8 is "routed" to the OS/2 COM-port
  110.         COM5 by vcFos/2.
  111.  
  112.         Be sure that you specify the right FOSSIL ports in your
  113.         DOS-software. If some mailer were to be installed under the
  114.         above example, you would have to set the COM-port to 8, or COM8.
  115.  
  116.         Note that vcFos/2 will only map ports made available by cFos/2.
  117.  
  118.  
  119.  
  120.  
  121.         How to run DOS applications from OS/2 applications:
  122.         ---------------------------------------------------
  123.  
  124.         vcFos/2 will issue a 'device open' call to cFos/2 if the user
  125.         does an FOSSIL 'open' function. This 'device open' is done with
  126.         sharing and SHARE_DENYNONE mode and may fail if the port was
  127.         initially opened in any other mode.
  128.  
  129.         I tested vcFos/2 with XENIA 1.98 (OS/2) and it did not work.
  130.         This may be, because XENIA up to 1.98.03 opens the COM ports
  131.         in SHARE_DENYALL mode and the subsequent open request of vcFos/2
  132.         fails. Registered XENIA users should use 1.98.04, which works ok.
  133.  
  134.         So far I myself did not test any other OS/2 applications with
  135.         vcFos/2, so just experiment yourself and mail me the results.
  136.  
  137.         According to user experience at least the following OS/2 mailer
  138.         vs. DOS BBS pairs run ok:
  139.  
  140.            MainDoor 1.10b115 - RemoteAccess 2.50
  141.            TMail/2 - RemoteAccess
  142.  
  143.  
  144.  
  145.  
  146.         Case studies:
  147.         -------------
  148.  
  149.         I successfully tested vcFos/2 with:
  150.  
  151.         FrontDoor 2.20, Telix 3.50 (FOSSIL support), Terminate 3.00,
  152.         BinkleyTerm 2.50ee, BinkleyTerm 2.60 XE, Maximus 2.01
  153.  
  154.  
  155.         CrossPoint:
  156.  
  157.            Setting the /OS2D switch may help.
  158.  
  159.  
  160.         Hydra Protocol:
  161.  
  162.            I had problems running Hydra (built in BT 2.60 XE) with
  163.            acceptable speed, even on a Pentium 200.  I fancy this is
  164.            a Hydra Problem.
  165.  
  166.  
  167.         PDZModem:
  168.  
  169.            Be sure to use the -os2 switch.
  170.  
  171.  
  172.  
  173.  
  174.         Known Bugs
  175.         ----------
  176.  
  177.         -- The system utilisation sometimes goes up 100%.  I'm not sure
  178.            if this is a VCFOS bug or not.
  179.  
  180.         -- Once in a while, you may get a SYS3176 from PMSHELL and the
  181.            DOS box is closed.  Simply restart it... :)  I'm working on
  182.            that.
  183.  
  184.         -- It was reported that screens would go blank if you switched
  185.            a DOS session from graphic to fullscreen mode.  As far as I
  186.            could see, this depends on the setting of
  187.            VIDEO_SWITCH_NOTIFICATION and VIDEO_ONDEMAND_MEMORY.  Play
  188.            with them and read the according help in case of trouble.
  189.  
  190.         -- You'll get problems if you like to boot DOS sessions from
  191.            disks or disk images.
  192.  
  193.         -- VCFOS does not work well with SIO in one computer.  IMHO
  194.            that's a SIO problem;  I'll try to circumvent in the future.
  195.  
  196.         -- No own statusline
  197.  
  198.         -- No ISDN appendage
  199.  
  200.         -- Only parts of the INT 14 support (e.g. no baudrate-change
  201.            hangup feature and only the 4 FOSSIL status bits)
  202.  
  203.         -- No special cFos/2 support. In the future vcFos/2 will
  204.            recognize cFos/2 and support it. This will speed up some
  205.            things.
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.         Debugging
  213.         ---------
  214.  
  215.         vcFos/2 creates a small logfile named C:\VCTRACE. This file will
  216.         contain some info on the loading process and other. You may
  217.         dump FOSSIL tracing info to this file as well, see CFU.DOC.
  218.  
  219.         This type of debugging is crude, but may help in some cases.
  220.  
  221.         As a matter of fact, it is not possible to display data while
  222.         a VDD is loaded, so all status and error messages of the
  223.         loading process are written to C:\VCTRACE. Have a look at this
  224.         file if something works weird.
  225.  
  226.  
  227.  
  228.  
  229.         Plans for the future / EOF
  230.         --------------------------
  231.  
  232.         Fix the above listed bugs, differences and restrictions.
  233.  
  234.  
  235.         Thanx for using a member of the cFos family.
  236.