home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1996 October / PCO_10.ISO / filesbbs / cfos2.arj / README.OS2 < prev    next >
Encoding:
Text File  |  1996-09-05  |  16.7 KB  |  449 lines
  1.  
  2.         'cFos/2' readme file
  3.         ----------------------------------------------------------------
  4.  
  5.  
  6.         Dear user,
  7.  
  8.         This README.OS2 file contains only important information. A
  9.         full fledged documentation of the same quality as the 'cFos'
  10.         documentation CFOS.{DOC|ENG} will be available soon. Refer to
  11.         the 'cFos' documentation in case of questions.
  12.  
  13.         Be sure to read the WHATSNEW file if you alreay have cFos in
  14.         use. It contains a lot of additional infos and changes!
  15.  
  16.         Check ORDER.* to order 'cFos/2'.
  17.  
  18.  
  19.  
  20.         Before you start:
  21.         -----------------
  22.  
  23.         If you write mail to us concerning 'cFos/2' be sure to include
  24.         the following header. We WILL NOT answer ANY MAIL without this
  25.         header. Please include it in EVERY MAIL, even in replies and
  26.         even if we replied a lot of times. We will get a big bunch of
  27.         bug-report-mails and this is neccessary if we shall be able to
  28.         handle this flood of eMail.
  29.  
  30.            OS/2 Version: x.xxx  (include internal revision if possible)
  31.            CPU type and clock rate: xxxxx
  32.            ISDN board name: xxxxxxx
  33.            CAPI Manufacturer: xxxxxxxxxx
  34.            CAPI Version: x.xxx  (we need to know the version of the
  35.                                  implementation of that CAPI, not of the
  36.                                  specification. So please don't say
  37.                                  "CAPI v1.1")
  38.            'cFos/2' Version and Beta level: 0.xx Beta xxx
  39.            Application software name and version: xxxxxx
  40.  
  41.         If you preceed your mails with this, we will be able to handle
  42.         your reports efficiently. Please address every mail to
  43.            "cfos-os2-bugs, 2:2453/30" (fidonet) or
  44.            "cfos-os2-bugs@zaphod.infox.com" (internet).
  45.         Be prepared that we eventually will not answer your letter
  46.         but will write an answer in CFOS_HELP or notice your comments
  47.         without response.
  48.  
  49.         CFOS_HELP is the international (though mostly in German) fidonet help
  50.         conference for 'cFos' and 'cFos/2'. Feel free to post questions and
  51.         comments to this area. If you currently have no connection to
  52.         CFOS_HELP, here are some folx that have:
  53.  
  54.            2:24/64, 2:24/901, 2:24/999, 2:240/5002, 2:240/5500,
  55.            2:2450/10, 2:2453/2, 2:301/1, 2:301/2, 2:310/1212
  56.            2:310/3, 2:317/7, 2:318/2
  57.  
  58.         Please ask one of them or your echomail uplink for this area, BUT
  59.         NOT US. It is impossible for us to deliver CFOS_HELP to every
  60.         net (or node) individually.
  61.  
  62.         CFOS_HELP is moderated by the authors of 'cFos'. Rules are in
  63.         CFOSHELP.RUL. This area is an 'official' Fidonet german backbone
  64.         echo.
  65.  
  66.  
  67.  
  68.         'cFos/2': Registering
  69.         ---------------------
  70.  
  71.         If you like to register 'cFos/2', simply fill out the ORDER.DOC,
  72.         ORDER.ENG or another of the ORDER.* files and send it to us or
  73.         use CFOSCFG (in a DOS box) to order.
  74.  
  75.         The key-file must reside in the same directory as CFOS.SYS
  76.         resides in and must be named CFOS.KEY.
  77.  
  78.  
  79.  
  80.  
  81.         'cFos/2': What does it do?
  82.         --------------------------
  83.  
  84.         'cFos/2' is an OS/2 physical device driver that enables you to
  85.         use your ISDN board as if it were a "normal" modem. You can
  86.         use all your favorite OS/2 modem software!
  87.  
  88.         'cFos/2' adds a character device to your system and you may set
  89.         your programs to use this device name and will find a "modem"
  90.         with AT commands etc. behind this device.
  91.  
  92.         In order to operate, 'cFos/2' needs to be loaded AFTER your ISDN
  93.         CAPI drivers in CONFIG.SYS, and these drivers must be
  94.         implemented as physical device drivers as well. If all goes
  95.         well, 'cFos/2' will load, allocate some memory, do some init's,
  96.         display some messages and your system is ready for ISDN!
  97.  
  98.         'cFos/2' does now run with CAPI 1.1 as well as CAPI 2.0.
  99.  
  100.  
  101.  
  102.  
  103.         'cFos/2': How do I load it?
  104.         ---------------------------
  105.  
  106.         You may specify the device(s) and switches on the commandline.
  107.         Some switches are special to the OS/2 version, others have
  108.         the same meaning as under DOS with 'cFos'. Name as many character
  109.         devices as you need. Use COMx for those programs that only run
  110.         on COMx device names. Your commandline looks like this:
  111.  
  112.            DEVICE=C:\CFOS\CFOS.SYS <devicename(s)> <switches>
  113.  
  114.         if you load cFos/2 for CAPI 1.1. If you like to use CAPI 2.0
  115.         use:
  116.  
  117.            DEVICE=C:\CFOS\CFOS20.SYS <devicename(s)> <switches>
  118.  
  119.         Replace <devicename> with your device's name, e.g. COM3.
  120.  
  121.         Note that you may load 'cFos/2' only once, even for multiple
  122.         ports. use "DEVICE=CFOS.SYS COM3 COM4", for example.
  123.  
  124.         Note furthermore, that you can NOT use the -c switches to
  125.         specify the COM ports as you would do with cFos/DOS.
  126.  
  127.         For those of you familiar with 'cFos' (for DOS) the following
  128.         info may be useful:
  129.  
  130.         'cFos/2' loads for as many ports as you specify devices, max 30
  131.         in the registered version. The shareware version supports 2 ports
  132.         at a time.
  133.         'cFos/2' uses an alternate monochrome monitor if you specify
  134.         the -ja switch. On this monitor traces and the statusline are
  135.         displayed.
  136.  
  137.         'cFos/2' uses receive and transmit buffers of a default of 8 kbytes
  138.         each (defaults are chosen on the settings of -w and -b switches).
  139.         Use the -r and -t switches to adjust the buffer sizes if needed.
  140.         Other switches that are available are:
  141.  
  142.            -w   set windowsize
  143.            -b   set blocksize
  144.            -j0  enable callerid repair
  145.            -ja  enable alternate monochrome debug monitor
  146.            -jp  enable passive B3 connection
  147.            -jr  disable CAPI reregistering
  148.            -jv  disable V.110 B3 protocoll
  149.            -jy  ignore DTR signal
  150.            -kc  set open and close function calls to leave the DTR signal
  151.                 unchanged. THIS MAY BE DANGEROUS. ONLY USE IF NEEDED!
  152.            -kn  enable API_SET_SIGNAL (0:0) before API_RELEASE. This may
  153.                 be good behaviour, but crashes some CAPI's. Use this switch
  154.                 for debugging.
  155.            -kw  wait for an ENTER after loading
  156.            -kx  behave like SIO (see note 1 below)
  157.  
  158.         Switches for the registered version of cFos/2:
  159.  
  160.            -aX  Add an auxiliary port for channel bundling with controller
  161.                 X
  162.  
  163.         For a documentation of the switches, read the CFOS.ENG documentation
  164.         file.
  165.  
  166.         Note 1: The SIO specification differs from the spec by IBM in one
  167.                 important point:  The set device control block function
  168.                 (set DCB, IOCTL 1/53).  Under COM.SYS setting DTR control
  169.                 mode to 0 drops DTR, setting it to 1 raises DTR.  Under SIO
  170.                 this only controls the handling of DTR when a COM port is
  171.                 opened or closed.  If control mode is set to 0, DTR won't
  172.                 change when the port is closed/opened.  If set to 1, DTR
  173.                 is raised on open and dropped on close.
  174.  
  175.                 If you have trouble dropping DTR (as, for example, with
  176.                 Binkley/2 2.60 XE) DO NOT use -kx.  If you have trouble with
  177.                 spawned programs (i.e. the connection is terminated when
  178.                 one application spawns another, try -kx).
  179.  
  180.         If you do not specify any device name, 'cFos/2' loads with "ISDN"
  181.         as the device name.
  182.  
  183.  
  184.  
  185.  
  186.         Known Bugs :
  187.         ------------
  188.  
  189.         -- The V.42bis compression has sometimes CRC errors while
  190.            transmitting.
  191.  
  192.         If you find other bugs (or think you've done), first check the
  193.         README.OS2 file (this one) for some additional information.
  194.         If your bug stays, please write an eMail to the above address
  195.         or in CFOS_HELP.
  196.  
  197.         Be sure to provide us with the information in the header
  198.         of your mail (see above).
  199.  
  200.         Do NOT send fax'es or surface mail; your letter would stay
  201.         unanswered. Please do NOT call us voice. We need our time to
  202.         improve 'cFos' for you!
  203.  
  204.  
  205.  
  206.  
  207.         Some technical info:
  208.         --------------------
  209.  
  210.         'cFos/2' is an OS/2 level 3 device driver with DOSDevIOCtl2.
  211.         It includes all Category 1 IOCtl functions described in the
  212.         "IBM Physical Device Driver Reference, Second Edition" as of
  213.         March 1994. It does not support deinstall so far.
  214.  
  215.         'cFos/2' devices must be opened before use and closed afterwards.
  216.  
  217.         'cFos/2' does currently NOT feature:
  218.  
  219.         -- less than 8 databits. The highbits are currently not stripped.
  220.         -- XON/XOFF stripping in incoming data
  221.         -- usage of the error replacement character
  222.         -- null stripping
  223.         -- automatic RTS or DTR control modes. Currently they may be
  224.            activated, but you will never see RTS or DTR change.
  225.         -- AT commands AT&W (does not save), ATZ (only does AT&F), AT&T
  226.            (does nothing), AT? (does nothing)
  227.         -- +++ hangup sequence (use DTR drop instead)
  228.         -- a statusline on the primary display. It is only possible to
  229.            display one on a secondary HGC display using the -ja switch.
  230.  
  231.         Because of some OS/2 restrictions, 'cFos/2' does some
  232.         initialisations in the first access to the device driver.
  233.         I.e. when you first call any function (excluding shutdown) of
  234.         a cFos-device, 'cFos/2' registers at the CAPI, installs the
  235.         signal handler and more. 'cFos/2' checks the signalling with
  236.         the CAPI and waits up to 5 seconds for a reply from the CAPI.
  237.         If there is no reply from the CAPI, 'cFos/2' won't work and will
  238.         only issue errors when you try to dial out. The error code will
  239.         be something like 0x60??. In case of trouble try an ATI6 command
  240.         to get some more information.
  241.  
  242.  
  243.  
  244.  
  245.         'cFos/2' is currently tested with:
  246.         ----------------------------------
  247.  
  248.         OS/2 2.11 with
  249.  
  250.             TELES S0.16, CAPI 2.92, 2.95
  251.             NCP P/16, CAPI 1.3
  252.             Diehl Diva, CAPI 5.00
  253.             AVM B1 V2.0, CAPI Rev 8.1
  254.             ITK iX1 V1.2, CAPI 1.05
  255.             HST Saphir, CAPI 1.3 (rev 04)
  256.  
  257.         OS/2 Warp with
  258.  
  259.             HST Saphir, CAPI v1.3 - v1.4, CAPI 1.1 and 2.0
  260.             AVM B1 V2.0, CAPI Rev 8.1
  261.             ELSA PCF/Pro, CAPI 0.10 of 16-May-95
  262.             BinTec BIANCA, CAPI 1.50 of 10-Apr-95
  263.             TELES S0.16.3, CAPI 3.10
  264.  
  265.         ZOC 2.05 - 2.13, TE/2 1.30, PMComm 2.20, Maximus/2 2.02,
  266.         LoraBBS 2.40B4, BinkleyTerm OS/2 2.50 EE Beta E3-32,
  267.         Xenia/2 1.98, MainDoor/2 0.99b, UUPC/extended 1.12j,
  268.         Warp Internet Access Kit, Cantaloup/2 Beta 0.73,
  269.         UUGate's uucico 0.33, CKermit 5A(190), OS2CIM 2.0.1,
  270.         OS/2 ppp 2.00 Rev 1.8, PCBoard/2 15.22, Lotus Notes,
  271.         OS/2 WebExplorer, Infimail 1.34
  272.  
  273.  
  274.         Comments to some hard/software:
  275.  
  276.  
  277.           Diehl Diva
  278.  
  279.           For a reason unknown to us, we were unable to transmit data
  280.           with 2k frames without errors. If you set the maximum transmit
  281.           frame size (S28) to 1024 no problems occure.
  282.  
  283.  
  284.           AVM B1, CAPI Rev. 8.1
  285.  
  286.           You have to run the ISDNLOAD program *before* you ACCESS the
  287.           'cFos/2' ports the first time (you must LOAD 'cFos/2' before
  288.           ISDNLOAD, of course). It was reported that the system
  289.           shutdown hangs with 'cFos/2' and the AVM B1. If it does,
  290.           please give us a hint.
  291.  
  292.  
  293.           ITK iX1, CAPI 1.05
  294.  
  295.           We tested the ITK CAPI and it worked ok (V42b does not work,
  296.           but crashes the system).  As with the Diva board,
  297.           you should set S28=1024 to inhibit Zmodem CRC errors when
  298.           uploading. It was reported that the CAPI crashed after a while.
  299.           We still have no clue why this is so. If it crashes at your site,
  300.           send us a mail with the OS/2 trap output.
  301.  
  302.           You need to run IXLOAD *before* you access cFos/2 the *first*
  303.           time. The ITK CAPI does not work with the -kn switch.
  304.  
  305.           ITK told us that the CAPI 1.05 was not very stable under Warp.
  306.           Use CAPI 1.06.
  307.  
  308.  
  309.           ELSA PCF/Pro, CAPI 0.10
  310.  
  311.           To run cFos/2 with the ELSA CAPI you need to set the -ks
  312.           switch on the commandline. If you don't, the system will crash
  313.           when you do a shutdown.
  314.  
  315.  
  316.           HST/Janussoft boards, NCP boards
  317.  
  318.           It may be that you have to start 'cFos/2' with a -ks switch
  319.           to prevent OS/2 (or the CAPI) from crashing when the system
  320.           is shut down. Setting this switch won't do any harm with
  321.           this CAPI, so just use it for safety. Starting with CAPI 1.3
  322.           rev 05 beta04 this should no longer be necessary.
  323.  
  324.  
  325.           UUGate uucico
  326.  
  327.           It seems that uucico does not raise the DTR signal before
  328.           sending data to the comport. Load 'cFos/2' with -jy to ignore
  329.           the DTR setting. Note that this can cause trouble in dropping
  330.           DTR to hang up.
  331.  
  332.  
  333.           PCBoard/2
  334.  
  335.           You need to set the -kc and -kx switches to prevent 'cFos/2'
  336.           from dropping DTR when PCBoard/2 closes the COMport to shell
  337.           out to external programs.
  338.  
  339.  
  340.           InterMail 2.29e
  341.  
  342.           I tested a demo version of InterMail. It has support for native
  343.           OS/2 COM-access, i.e. InterMail (in an OS/2-DOS-box) uses the
  344.           same function calls as a native OS/2 application would do.
  345.           Unfortunately, the downloads had CRC errors and the uploads from
  346.           the terminal are quite slow; but the uploads in the mailer are
  347.           really fast. We are investigating on this problem. IM runs ok
  348.           with the -kx switch.
  349.  
  350.           Use VCFOS if you have problems with the Intermail OS/2 COM port
  351.           access.
  352.  
  353.  
  354.           OS2CIM
  355.  
  356.           I tested OS2CIM here and it run quite find, but had a bug in
  357.           the routines that set the modem signals via IOCTL function
  358.           0x46 (cat 1). The upper 6 bits of the masks must be 0, but
  359.           they aren't always. 'cFos/2' set the known signals to the
  360.           desired values but issues an error. If anyone can get this
  361.           to the programmers of OS2CIM (or mail me their address),
  362.           then i would be glad (and could perhaps remove this paragraph).
  363.  
  364.  
  365.           BinkleyTerm/2
  366.  
  367.           Some versions seem to need the -kx switch to spawn external
  368.           applications (ie. BBS'es), others can no longer drop DTR
  369.           when -kx is set (eg. Binkley/2 2.60 XE).  Test it before use.
  370.           See note 1 in the switches section for more info.
  371.  
  372.  
  373.           Internet Access Kit
  374.  
  375.           The TONLINE.CMD file enables connections to T-Online in Germany
  376.           via SLIPPM and cFos/2. This file updates the TONLINE.CMD of
  377.           the T-Online CD. You need to set the dial string to ATB6D to
  378.           connect to T-Online.
  379.  
  380.  
  381.         If you need some newer CAPI version, try to get it from your
  382.         dealer, capi manufacturer, etc. first. If not otherwise possible,
  383.         you may try to request/download it from our mailbox, area ISDN.
  384.  
  385.  
  386.  
  387.  
  388.         How to get new versions?
  389.         ------------------------
  390.  
  391.         Versions are named something like CF2_xxxx.ZIP, where 'xxxx' is
  392.         a version number like '081C'.
  393.  
  394.  
  395.         You may get the latest version from:
  396.  
  397.         Our home BBS :
  398.  
  399.             Zaphods BBS, Bonn/Germany, Sysop Chris Lueders
  400.  
  401.                 +49-228-262894   14400bps, HST/V32b   (fido 2:2453/30)
  402.                 +49-228-9111041  64000bps, X75/V110   (fido 2:2453/33)
  403.  
  404.  
  405.         Our primary FTP site :
  406.  
  407.             FTP.P2P.DE,  Directory /pub/cfos
  408.  
  409.  
  410.         We support Fido file request of 'cFos/2' under the magic name
  411.         CFOS2.
  412.  
  413.  
  414.  
  415.  
  416.         Credits:
  417.         --------
  418.  
  419.         Thanx very much to the following people for their help, advice
  420.         and/or time:
  421.  
  422.         Joern Bardewyck, Kalle Braun, Rainer Schuetze, Dennis Rowe (for
  423.         his sample device driver code), Michael Buenter, Heinz-Otto
  424.         Scheid (for his patience), Wim Abels and Patrick Bosch.
  425.  
  426.         Thanx to the following companies for their help and boards to
  427.         test with: HST, TELES, Diehl, NCP, AVM, ITK, ELSA, BinTec.
  428.  
  429.  
  430.  
  431.  
  432.         Plans for the future:
  433.         ---------------------
  434.  
  435.         -- Implement all features that 'cFos' (for DOS) currently has.
  436.  
  437.         -- Add a utility for some PM window with full featured 'cFos/2'
  438.            status display.
  439.  
  440.         -- Add an easy-to-use installation program.
  441.  
  442.  
  443.  
  444.  
  445.         End of file
  446.         -----------
  447.  
  448.         Have fun, thanx for using 'cFos/2'.
  449.