home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1998 June B / Pcwk6b98.iso / Faxmaker / Patches / debug / README.TXT < prev    next >
Text File  |  1997-10-31  |  7KB  |  201 lines
  1. To install GFI modem/board/isdn debug utility
  2. =============================================
  3.  
  4. 1. Create a new directory.
  5.  
  6. 2. Unzip GFIFAX.ZIP in the new directory.
  7.  
  8.  
  9.  
  10.  
  11. To use GFI modem/board/isdn debug utility
  12. =========================================
  13.  
  14. 3. Run GFIFAX.EXE with parameters. If no or incorrect parameters are entered a help is displayed.
  15.  
  16.     For example to send a fax;
  17.  
  18.         gfifax +s /N 661072 test.fax
  19.  
  20.     or to receive a fax:
  21.  
  22.         gfifax +r c:\in.fax
  23.  
  24.     The file test.fax is included for test purposes.
  25.  
  26. 4. Make sure that you send the fax to the fax machine or modem on which FAXmaker fails. 
  27.    When program stops (after success or failure) a file called debug.txt is created.
  28.  
  29. 5. Send this file should be sent to GFI FAX & Voice support. This will enable us to see what has happened.
  30.  
  31.  
  32. Some more examples
  33. =========================================
  34.  
  35. To send a fax over an ISDN CAPI2.0 adapter:
  36.     GFIFAX +s /capi20 /P 1 /N 12345678 test.fax        
  37. Note that '/S capi20' tell GFIFAX.EXE to use capi20.
  38. '/P 1' means that first controller has to be used
  39.  
  40. To receive a fax on ISDN-card over 2nd card:
  41.     GFIFAX +r /S capi20 /P 2 in.fax
  42.  
  43.  
  44.  
  45.  
  46.  
  47. The /Z flag (ISDN CAPI2.0 only)
  48. =============================================================
  49. CAPI2.0 is standard protocol for software to communicate
  50. with the ISDN board. However, the implementation of CAPI2.0
  51. can be slightly different between manufacturers. To take full 
  52. advantage of the ISDN card, you can add the /Z flag. 
  53. Example sending fax over AvmB1 card:
  54.     GFIFAX +s /S capi20 /P 1 /N 12345 /Z AvmB1 test.fax
  55.  
  56. The /I flag
  57. =============================================================
  58.  
  59. The /I option can be used to set the TSI (transmitting
  60. called subscriber identification).
  61. The term TSI is very often interchanged with CSI (or CSID)
  62. and the fax-header. CSI is the TSI sent to you by the other
  63. party (your TSI is the other patry's CSI and the other way
  64. around). The fax-header is a completely different thing, 
  65. although most fax-machines put the exact TSI info in it.
  66. One very imporatant thing to know is: some modems do NOT ACCEPT
  67. characters in the TSI. The resulting error is that the modem 
  68. cannot be switched to fax-mode.
  69. In the debug-utility GFIFAX.EXE, the /I information will be 
  70. used for TSI as well as fax-header, to make the debug-utility 
  71. as simple as possible. 
  72. So, some modems will fail to switch to faxmode after the command:
  73.     GFIFAX /I "Gfi Fax&Voice" /N 1 test.fax
  74. but will succeed on
  75.     GFIFAX /I "12 34 56" /N 1 test.fax
  76.  
  77.  
  78.  
  79.  
  80.   
  81.  
  82.  
  83. Short technical note on the modem delay times ( /X and /Y options )
  84. =============================================================
  85.  
  86. Most of the modem-problems are due to modem-command delay-time. 
  87. Online, the delay is very critical for a few modems.
  88. There are two indications that delay might be a problem:
  89.  1. The modem doesn't respond on a command (error -3102).
  90.  2. The carrier is dropped, i.e. the connection is lost.
  91.     This you can see from the modem, CD is switched off.
  92.  
  93. The TIA/EIA class 2 specification states that:
  94.  
  95. "the DCE may fail to recognise a command line if the start element of
  96. the first character of the command line begins within one millisecond
  97. of one half-bit time into the stop element of the terminating
  98. character of the final result code character issued in response to
  99. the preceding command line".
  100.  
  101. The TIA/EIA class 2.0 specification states that:
  102.  
  103. "the DTE shall not issue a new command line until the DCE has finished
  104. delivering the complete final result code to the previous command
  105. line, including any following <cr> and <lf> characters".
  106.  
  107.  
  108. However, there's no mathematical rule to calculate the delay-time.
  109. When a modem is offline, FAXmaker uses a long delay before it
  110. releases a new command (60ms) and inbetween two characters (20ms).
  111. These delays are definitely long enough for all modems.
  112. The problem is not when the modem is offline. The problem is when
  113. the modem is online. When online, the delay has to be long enough so
  114. that next command will be accepted, but not too long because the modem
  115. might drop the carrier because it doesn't receive a command. This behaviour
  116. is different amongst the modems on the market. Also, some commands require
  117. a longer delay than other on the same modem.
  118.  
  119. There are a lot of differences between modems. The behaviour not only depends 
  120. on the modem-type only, but also on the EPROM-version of the modem.
  121. Because GFI can't test all different modems/EPROM versions, you
  122. can change the delay in the debug-utility and see if it solves youre problem.
  123.  
  124. The default pre-command delay (/X) is 20ms, the default delay between two
  125. characters (/Y) is 10ms. If you use /X and /Y, please try the following
  126. combinations:
  127.     /X 0  /Y 0
  128.     /X 5  /Y 0
  129.     /X 20 /Y 5
  130.  
  131. If you try these three combinations, most probably your problems will be solved.
  132.  
  133. You can make this change into faxmaker by adding another line into the
  134. <FAXMAKER>\MODEMS.INF file. The syntax of a line is
  135.     name,type,initstring,precommanddelay,interchardelay,voiceformat,voicebitspersample,voicesamplefreq
  136.  
  137. Let's say you have problems with your class-2 modem 'XYZ' and you got it to work with
  138. params /X 20 /Y 5, then add the following line:
  139.     XYZ=class232,AT&F,20,5,0,0,0
  140.  
  141.  
  142.  
  143. What to do if fax-server has problems that debug-utility hasn't
  144. =============================================================
  145.  
  146. It is possible that the fax-server has problems which you can't reproduce
  147. using this debug-utility. Most of the times it is due to different
  148. settings that are used by the fax-server. For instance, you're using a 
  149. different modem-initialisation string.
  150.  
  151. However, it is possible to find out what the problem is. Please do
  152. the following, step-by-step:
  153. 1. Stop the fax-server if it is running;
  154. 2. Find out in which directory the fax-server is located. The name of this
  155.    file is 'FGWMSERV.EXE' and is located in your FAXmaker directory;
  156. 3. Copy EXACTLY ONE of the following files from the debug-utility directory 
  157.    (where this README.TXT is located) to the fax-server directory:
  158.         CLASS132.DLL  in case of a class 1 fax-modem problem
  159.      or CLASS232.DLL  in case of a class 2 fax-modem problem
  160.      or CLAS2032.DLL  in case of a class 2.0 fax-modem problem
  161.      or FC20GNRC.DLL  in case of a generic CAPI20 ISDN-board problem
  162.      or FC20AVMB.DLL  in case of a AVMB1 ISDN-board problem
  163.      or FC20DIVA.DLL  in case of a DIVA ISDN-board problem
  164.      or FC20DIVP.DLL  in case of a DIVA Pro ISDN-board problem
  165.      or FC20DIVM.DLL  in case of a DIVA Maestra ISDN-board problem
  166.      or FC20ITKX.DLL  in case of a ITK x1 ISDN-board problem
  167.  
  168.    You will overwrite the existing DLL. It is a good idea to copy the existing one
  169.    to a temporarily directory, so it can be restored whenever you don't need
  170.    debug-information anymore.
  171. 4. Launch the fax-server like you normally do.
  172. 5. As soon as the problem occurs, stop the fax-server
  173. 6. In the root of your C: drive, you will find one or more debug-files. The naming
  174.    convention of the file(s) is C:\DBG?????.TXT. 
  175.    Send these files to GFI via email or via fax.
  176. 7. Restore the DLL module that you copied to a temporarily directory. If you don't
  177.    do this, the fax-server will produce a lot of debug-output and will slow down
  178.    the system.
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.     
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200. Copyright 1997, GFI FAX & VOICE.
  201.