home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / fax010.lzh / FSEND.CFG < prev    next >
Text File  |  1995-01-03  |  10KB  |  283 lines
  1. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  2. ;
  3. ;     FAXSEND.CFG
  4. ;
  5. ;     Created by Harald Pollack
  6. ;
  7. ; Configurations for FSEND.EXE Vers. 0.08b, Sept 4, 1994
  8. ; Version 0.09b, working in Class 2.0 on Zyxel :-)
  9. ; Version 1.01b, some enhancements like retransmission of bad page if
  10. ; receiving a ReTrain Negativ (RTN) from remote.
  11. ; Each entry must start on FIRST position in line
  12. ; Each line can be 255 characters long (incl. CR+LF)
  13. ; Character-values may be up to 40 characters
  14. ; Only ';' as comment is valid
  15. ; Leading blanks in values are ignored, trailing blanks NOT !!!
  16. ;
  17.  
  18. ; ComPort for transmission. THIS IS A MUST !!!
  19. ComPort COM2
  20.  
  21. ; The two following values are used in the headerline of each page. LocalID
  22. ; is also send to the modem.
  23. LocalID +43 1 70199 3414
  24. LocalName Dr. Harald Pollack
  25.  
  26. LocalPhone +43 1 70199 3102
  27.  
  28. ; Optinaly, a coverpage is generated.
  29.  
  30. CoverPage Yes
  31.  
  32. ; Declare a predefined graphic (BMP, black & white)
  33.  
  34. CoverGraphic d:\tif\cover1.bmp
  35.  
  36. ; FSEND is able to colaborate with FAXWORKS (tm):
  37. ;
  38. ; Use commandline switch '-#nnnnnn' to select a FXnnnnnn.FAX or
  39. ; '-#?' to send last edited fax (FAX.IDX - 1). Both FaxIdx and FaxLog
  40. ; MUST be defined to use this feature!
  41.  
  42. FaxIdx e:\faxworks\fax.idx
  43. FaxLog e:\faxworks\fax.log
  44. FaxPath e:\faxworks
  45.  
  46. ; All other parameters are NOT NEEDED in Class 2. Their default values are
  47. ; hardcoded in FSEND for Class 2 operation.
  48.  
  49. ; Timelimit in Phase A between dialing and '+FCON OK' response.
  50. ;DialTimeout 35
  51.  
  52. ;
  53. ; DialRetry 1
  54.  
  55. ; Time to wait between redial in seconds
  56. ;DialWait 5
  57.  
  58. ; Some FaxModem need fixed speed for data and fax transmission
  59. ; for Class 2 (except Zyxel) you must use 'FaxBaudRate 19200'. Baudrate
  60. ; is switched in modem_init(), see below for explanation.
  61. ;DataBaudRate 2400
  62. ;FaxBaudRate 19200
  63.  
  64.  
  65. ; FSEND must know, what your modem is able to do. Use a terminalprogram and
  66. ; enter: AT+FCLASS=?
  67. ; If your modem responses with ERROR, then forget FSEND, else if a value
  68. ; of '2' or '2.0' is reported, you can use FSEND. Enter AT+FCLASS=2 (or
  69. ; AT+FCLASS=2.0 if possible) and if 'OK' is reported then AT+FDCC=? (or
  70. ; AT+FCC=? in Class 2.0). Chose the highest value for first, second, forth and
  71. ; fifth value and the lowest for the eighth value. You can simulate it by
  72. ; entering AT+FDCC=x,x,x,x,x,x,x,x and receiving 'OK'.
  73.  
  74. ; for highres, 9600 bps max
  75. Capabilities 1,3,0,2,0,0,0,0
  76.  
  77. ; for normal, 14400 bps max
  78. ;Capabilities 0,5,0,2,0,0,0,0
  79.  
  80. ; for highres, 14400 max and 2-D Read compression
  81. ;Capabilities 1,5,0,2,1,0,0,0
  82.  
  83. ; Bring your modem in a stable and repoduceable state. 'ModemReset' is sent
  84. ; as FIRST command after initialising the ComPort (at DataBaudRate).
  85. Reset ATZ
  86.  
  87. ; Finaly, you can make a controlled cleanup with
  88. CleanUp ATZ
  89.  
  90. ; It is a very bad kind of doing, to initialise a modem with a long, cryptic
  91. ; string. Store all the values in a profile (with AT&Wn) and recall them with
  92. ; the above ATZ. Normaly, the manufacturer of your modems knows it better than
  93. ; you, so once AT&F and AT&Wn should be enough for proper working.
  94.  
  95. ; Possibility for sending some extra commands, response is checked for 'OK'
  96. ; In Class 2.0 you MUST enter the +FNR=1,1,1,1 or FSEND will NOT work!
  97. Init AT+FBOR=0
  98. ;Init AT+FBO=0
  99. ;Init AT+FNR=1,1,1,1
  100.  
  101. ; Choose a fax class your modem can handle:
  102. FaxClass 2
  103. ;FaxClass 2.0
  104.  
  105. ; Dialprefix, here and only here you should add dial modifier eg. X3 or 0W.
  106. Dial ATDT
  107.  
  108.  
  109. ; FSEND is able to use either TIFF or plain ASCII (8-Bit) Text to send.
  110. ; To distinguish between them, FSEND uses 'TextExtention'. If the file
  111. ; (entered with '-i') has TextExtention, than it is handled as ASCII text,
  112. ; else a TIFF with Compression=3 is expected.
  113. TextExtention .TXT
  114.  
  115. ; Normally, FSEND creates each time called, a file FSEND.DEB and stores
  116. ; all activities in it. You can redefine this filename and prefix it with '+'
  117. ; to get a continous logfile. Try '?' as filename :-)
  118. FaxDebug +D:\POINT\LOG\FSEND.LOG
  119.  
  120. ; Some older (or cheaper) faxmodems echo all faxdata they receive from FSEND.
  121. ; To suppress the recording of this in the log, use
  122. NoGarbage
  123.  
  124. ; You do not want to have a headerline ?
  125.  
  126. ; NoHeaderLine
  127.  
  128. ; You do not want to have a footerline ?
  129.  
  130. ; NoFooterLine
  131.  
  132. ; Some explantion for the initialisation of your modem:
  133.  
  134. ; FSEND, in modem_init() does the following
  135.  
  136. ; 1) setting baudrate to <DataBaudrate>
  137. ; 2) sending <ModemReset> and waits for <OK>
  138. ; 3) sending <ModemInit> and waits for <OK> (up to 10 times)
  139. ; 4) sending <ModemAT> plus <ModemFCLASS> and waits for <OK>
  140. ; 5) setting baudrate to <FaxBaudrate>
  141. ; 6) sending <ModemAT> and waits for <OK>
  142. ; 7) sending <ModemAT> plus <ModemFLID> plus '=' plus <LocalID> and waits
  143. ;    for <OK>
  144. ; 8) sending <ModemAT> plus <ModemFCR> plus '=0' and waits for <OK>
  145. ; 9) sending <ModemAT> plus <ModemFDCC> plus '=' plus <Capabilities> and
  146. ;    waits for <OK>
  147. ;10) sending 'AT+FCLASS?' and waiting for '2' or '2.0' response. If none of
  148. ;    them is received, FSEND aborts.
  149. ;11) sending <ModemAT> plus <ModemFBUF> plus '?' and stores the first numerical
  150. ;    value received for elsewhat.
  151.  
  152. ; Each of this steps you can verify in FSEND.DEB or what name you ever gave
  153. ; these file.
  154.  
  155. ; At first tries, FSEND aborts often while doing the above. Try ATE1V1&W to
  156. ; switch to verbose mode and echo mode.
  157.  
  158. ; FSEND works well in Class 2 with Zyxel and Rockwell chipset based Modems.
  159. ; Class 2.0 is implemented yet only by Zyxel and USR. Class 2 works fine,
  160. ; Class 2.0 was only tested on Zyxel (ROM 6.12 and 6.13) and works fine too.
  161.  
  162. ; FSEND with USR was not tested by the autor. Users had reported, they can not
  163. ; bring USR to work with FSEND in Class 2.0.
  164.  
  165. ; FSEND Class 2.0 is implemented 'from the paper' of the standard.
  166.  
  167. ; Maybe FSEND is wrong.
  168. ; Maybe the standard is wrong.
  169. ; Maybe manufacturers had not made their homework.
  170.  
  171. ; Finaly, FSEND will never be ported to DOS, but for serious callers, the
  172. ; source code is available from the autor. There is NO copyright. You can
  173. ; do anything with FSEND or the source code EXCEPT:
  174.  
  175. ; DO NOT RENAME FSEND to elsewhat and distribute it!
  176.  
  177. ; DO NOT ALTER THE SOURCE CODE, COMPILE AND NAME IT "FSEND".
  178.  
  179. ; Please fell free to contact the autor:
  180.  
  181. ; FidoNet 2:313/9.59
  182. ; Internet HPOLLACK@gw1-x203.uibk.ac.at
  183.  
  184. ; Error reports without a copy of the FSEND.DEB are SENSELESS.
  185.  
  186. ; Many thanks to Bernhard Seidl and Gerold Pummer
  187. ; for excessive tests of various (beta) versions of FSEND.
  188.  
  189. ; Commandline parameters:
  190.  
  191. ;C:\FSEND /?
  192.  
  193.  
  194. ;--------------------------------------------------
  195. ;FSEND  Fax Send with Class 2/2.0 Modem Vers. 0.08b
  196. ;Serial No. 0000-0000-000000     No Rights Reserved
  197. ;Sep 04 1994                           Dr.H.Pollack
  198. ;--------------------------------------------------
  199.  
  200. ;FSEND.EXE -p<phonenumber> -i<filename> [options]
  201. ;Options:  -i<filename> . Filename(s) to send [*.TIF or *.TXT]
  202. ;          -p######### .. Phonenumber to call
  203. ;          -d<anything> . Recipient of Message [empty]
  204. ;          -c<filename> . Configurationfile [FSEND.CFG]
  205. ;          -testdcdoff... Do NOT test carrier (DCD)
  206. ;          -r[#] ........ Inputfile is FAX-RAW [FillOrder 1/2]
  207. ;          -t ........... Trace activities on screen
  208. ;          -x ........... Save each page as FXDTnnnn.BMP [off]
  209. ;          -h or /h or -? or /? showes this.
  210.  
  211. ; -i
  212.  
  213. ; You can enter input file as much as you like (and the OS/2 can handle :-).
  214. ; Wildcards like '*' and '?' are supported. Filenames without extention are
  215. ; treated as '*.TIF'. Single and multi page TIFF is supported.
  216.  
  217. ; -p
  218.  
  219. ; You can enter the phone number in one string or splitted by blanks (e.g.
  220. ; '-p0321 543 76 98') but do not use dashes or slashes inbetween the number.
  221. ; The phone number is put in the headerline of the fax.
  222.  
  223. ; -d
  224.  
  225. ; The same rule as in '-p'. There is no casetranslation.
  226.  
  227. ; -c
  228.  
  229. ; selfexplanating, I hope :-)
  230.  
  231. ; -testdcdoff
  232.  
  233. ; FSEND tests (in a background thread) the existence of Data Carrier. Some
  234. ; modems do not handle this signal in the right way, so you can switch off
  235. ; this test. An idication is, if an error is reported while 'handshaking sound'
  236. ; is produced. FSEND will (should :-) never hang to infinity even if this test
  237. ; is disabled, because all is checked by timeout. Checking DCD only speeds up
  238. ; the aborting sequence.
  239.  
  240. ; -r[#]
  241.  
  242. ; FSEND can send raw fax data (in the form BinkleyTerm produces PAGEnnnn.FAX),
  243. ; but it is strongly recommanded, to DO NOT USE THIS FEATURE because
  244. ; unpredictable results are the rule :-). This switch is only for testing.
  245.  
  246. ; -t
  247.  
  248. ; All informations which are written to FSEND.DEB is copied to the screen.
  249. ; Senseful while testing, but timeconsuming.
  250.  
  251. ; -x
  252.  
  253. ; For checking the validy of your source (TIF or TXT or RAW). A file
  254. ; FXDTnnnn.BMP is stored for each page. The BMP is inverse (last scanline
  255. ; first). This switch should be used only to test pagegeneration.
  256.  
  257. ; Finaly:
  258.  
  259. ; There is, in fact, no purpose, why FSEND should realy work. The Class 2
  260. ; fax communication rules (right, there is NO STANDARD) are crippled and each
  261. ; manufactuerer of faxmodem uses its own rules. Commercial faxprograms works
  262. ; fine with a great number of modems, but in fact, they tread each modem in a
  263. ; certain manner. It can not be the result of a free available faxprogram
  264. ; to work with each and every modem on the market. But it works with a lot
  265. ; of modems, more then expected :-).
  266.  
  267. ; Class 2.0 is an adopted and recommanded standard, but at the time, FSEND
  268. ; was written, only two modems (Zyxel and USR) was available with this class.
  269.  
  270. ; Hint (in case of errors :-)
  271.  
  272. ; 1) You are misinterpreting this document
  273. ; 2) FSEND could not interpret some lines, because you had mixed up Class 2
  274. ;    and Class 2.0 commands.
  275. ; 3) FSEND could not handle your TIF.
  276. ; 4) Your modem is misinterpreting commands from FSEND (the normal case :-)
  277. ; 5) Public telephone lines were NOT build for fax. Each errorfree page
  278. ;    should be treaded as a surprise.
  279. ; 6) Do NOT try to transmit at high speeds. Faxmachines normally sends with
  280. ;    4800 bps or less!
  281. ; 7) Your preferred faxprogram works well, FSEND not. Well that's a fact.
  282.  
  283.