home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / fax067.zip / fsend.cfg < prev    next >
Text File  |  1997-02-03  |  15KB  |  376 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. ; New for some reasons in WARP:
  22. ;
  23. ; The priority of Load TIF and the writing in the debug file is handled
  24. ; by priority:
  25. ;
  26. ; DebugThread's priority is adjusted by ...
  27. ; DosSetPriority(PRTYS_THREAD,DebugPriorityType,DebugPriorityValue,0);
  28. ; and tif_thread() is adjusted by ...
  29. ; DosSetPriority(PRTYS_THREAD,LoadPriorityType,LoadPriorityValue,0);
  30. ;
  31. ; You can select either IDLE or REGULAR priority for each of the both
  32. ; threads AND you can select a value (-31 to +31) with:
  33.  
  34. ;   DebugIdlePriority    <-31 - +31> selects IDLE for debug writing
  35. ;   DebugRegularPriority <-31 - +31> selects REGULAR for debug writing
  36. ;   LoadIdlePriority     <-31 - +31> selects IDLE for TIF loading
  37. ;   LoadRegularPriority  <-31 - +31> selects REGULAR for TIF loading
  38.  
  39. ; You MUST use either ...Idle... or ...Regular... (the later entry overwrites
  40. ; the former) !!!
  41. ; Default (for OS/2 2.1x) is 'DebugIdlePriority 0' and 'LoadIdlePriority 0'
  42.  
  43. ; Recommanded for OS/2 WARP is
  44.  
  45. DebugIdlePriority 30
  46. LoadIdlePriority 31
  47.  
  48. ; In either case, Load...Priority MUST be greater than Debug...Priority !!!
  49.  
  50. ; The two following values are used in the headerline of each page. LocalID
  51. ; is also send to the modem.
  52. LocalID +43 1 70199 3414
  53. LocalName Dr. Harald Pollack
  54.  
  55. LocalPhone +43-1-70199-3102
  56.  
  57. ; Optinaly, a coverpage is generated.
  58.  
  59. CoverPage Yes
  60.  
  61. ; Declare a predefined graphic (BMP, black & white)
  62.  
  63. CoverGraphic d:\tif\cover1.bmp
  64.  
  65. ; FSEND is able to colaborate with FAXWORKS (tm):
  66. ;
  67. ; Use commandline switch '-#nnnnnn' to select a FXnnnnnn.FAX or
  68. ; '-#?' to send last edited fax (FAX.IDX - 1). Both FaxIdx and FaxLog
  69. ; MUST be defined to use this feature!
  70.  
  71. FaxIdx fax.idx
  72. FaxLog fax.log
  73. FaxPath e:\faxworks
  74.  
  75. ; DialRetry 1
  76.  
  77. ; Time to wait between redial in seconds
  78. ;DialWait 5
  79.  
  80. ; Some FaxModem need fixed speed for data and fax transmission
  81. ; for Class 2 (except Zyxel) you must use 'FaxBaudRate 19200'. Baudrate
  82. ; is switched in modem_init(), see below for explanation.
  83. ;DataBaudRate 2400
  84. ;FaxBaudRate 19200
  85.  
  86. ; FSEND must know, what your modem is able to do. Use a terminalprogram and
  87. ; enter: AT+FCLASS=?
  88. ; If your modem responses with ERROR, then forget FSEND, else if a value
  89. ; of '2' or '2.0' is reported, you can use FSEND. Enter AT+FCLASS=2 (or
  90. ; AT+FCLASS=2.0 if possible) and if 'OK' is reported then AT+FDCC=? (or
  91. ; AT+FCC=? in Class 2.0). Chose the highest value for first, second, forth and
  92. ; fifth value and the lowest for the eighth value. You can simulate it by
  93. ; entering AT+FDCC=x,x,x,x,x,x,x,x and receiving 'OK'.
  94.  
  95. ; for highres, 9600 bps max
  96. Capabilities 1,3,0,2,0,0,0,0
  97.  
  98. ; for normal, 14400 bps max
  99. ;Capabilities 0,5,0,2,0,0,0,0
  100.  
  101. ; for highres, 14400 max and 2-D Read compression
  102. ;Capabilities 1,5,0,2,1,0,0,0
  103.  
  104. ; Bring your modem in a stable and repoduceable state. 'ModemReset' is sent
  105. ; as FIRST command after initialising the ComPort (at DataBaudRate).
  106. Reset ATZ
  107.  
  108. ; Finaly, you can make a controlled cleanup with
  109. CleanUp ATZ
  110.  
  111. ; It is a very bad kind of doing, to initialise a modem with a long, cryptic
  112. ; string. Store all the values in a profile (with AT&Wn) and recall them with
  113. ; the above ATZ. Normaly, the manufacturer of your modems knows it better than
  114. ; you, so once AT&F and AT&Wn should be enough for proper working.
  115. ;Init AT&FE1M1L2V1X3&D3S0=0S7=100w1
  116. ; The above string as that kind of doing you should omit!
  117. ; Possibility for sending some extra commands, response is checked for 'OK'
  118. ; In Class 2.0 you MUST enter the +FNR=1,1,1,1 or FSEND will NOT work!
  119. Init ATE0m2
  120. Init AT+FBOR=0
  121. ;Init AT+FBO=0
  122. ;Init AT+FNR=1,1,1,1
  123.  
  124. ; Choose a fax class your modem can handle:
  125. FaxClass 2
  126. ;FaxClass 2.0
  127.  
  128. ; Dialprefix, here and only here you should add dial modifier eg. X3 or 0W.
  129. Dial ATDT
  130.  
  131. ; FSEND is able to use either TIFF or plain ASCII (8-Bit) Text to send.
  132. ; To distinguish between them, FSEND uses 'TextExtention'. If the file
  133. ; (entered with '-i') has TextExtention, than it is handled as ASCII text,
  134. ; else a TIFF with Compression=3 is expected.
  135. TextExtention .TXT
  136.  
  137. ; Normally, FSEND creates each time called, a file FSEND.DEB and stores
  138. ; all activities in it. You can redefine this filename and prefix it with '+'
  139. ; to get a continous logfile. Try '?' as filename :-)
  140. FaxDebug +D:\POINT\LOG\FSEND.LOG
  141.  
  142. ; Some older (or cheaper) faxmodems echo all faxdata they receive from FSEND.
  143. ; To suppress the recording of this in the log, use
  144. NoGarbage
  145.  
  146. ; You do not want to have a headerline ?
  147.  
  148. ; NoHeaderLine 1
  149.  
  150. ; You do not want to have a footerline ?
  151.  
  152. ; NoFooterLine 1
  153.  
  154. ; FSEND is able to work 100% in accordance to CCITT T.30 ! In fact, some
  155. ; equipment does NOT so. One of the 'unknown facts' is EOM (EndOfMessage)
  156. ; handling in faxmodems (Class 2 or Class 2.0) or faxsoftware (Class 1).
  157. ; To work-a-round (and make FSEND to be understood by such crippeled products)
  158. ; use the keyword 'NoEOM' here or the commandline option '-NOEOM'.
  159.  
  160. ; NoEOM
  161.  
  162. ; To accelerate reading of this file, use ConfigEnd as the absolut last
  163. ; keyword here. Comments may follow as much as you like ...
  164.  
  165. ConfigEnd
  166.  
  167. ; Some explantion for the initialisation of your modem:
  168.  
  169. ; FSEND, in modem_init() does the following
  170.  
  171. ; 1) setting baudrate to <DataBaudrate>
  172. ; 2) sending <ModemReset> and waits for <OK>
  173. ; 3) sending <ModemInit> and waits for <OK> (up to 10 times)
  174. ; 4) sending <ModemAT> plus <ModemFCLASS> and waits for <OK>
  175. ; 5) setting baudrate to <FaxBaudrate>
  176. ; 6) sending <ModemAT> and waits for <OK>
  177. ; 7) sending <ModemAT> plus <ModemFLID> plus '=' plus <LocalID> and waits
  178. ;    for <OK>
  179. ; 8) sending <ModemAT> plus <ModemFCR> plus '=0' and waits for <OK>
  180. ; 9) sending <ModemAT> plus <ModemFDCC> plus '=' plus <Capabilities> and
  181. ;    waits for <OK>
  182. ;10) sending 'AT+FCLASS?' and waiting for '2' or '2.0' response. If none of
  183. ;    them is received, FSEND aborts.
  184. ;11) sending <ModemAT> plus <ModemFBUF> plus '?' and stores the first numerical
  185. ;    value received for elsewhat.
  186.  
  187. ; Each of this steps you can verify in FSEND.DEB or what name you ever gave
  188. ; these file.
  189.  
  190. ; At first tries, FSEND aborts often while doing the above. Try ATE1V1&W to
  191. ; switch to verbose mode and echo mode.
  192.  
  193. ; FSEND works well in Class 2 with Zyxel and Rockwell chipset based Modems.
  194. ; Class 2.0 is implemented yet only by Zyxel and USR. Class 2 works fine,
  195. ; Class 2.0 was only tested on Zyxel (ROM 6.12 and 6.13) and works fine too.
  196.  
  197. ; FSEND with USR was not tested by the autor. Users had reported, they can not
  198. ; bring USR to work with FSEND in Class 2.0.
  199.  
  200. ; FSEND Class 2.0 is implemented 'from the paper' of the standard.
  201.  
  202. ; Maybe FSEND is wrong.
  203. ; Maybe the standard is wrong.
  204. ; Maybe manufacturers had not made their homework.
  205.  
  206. ; Finaly, FSEND will never be ported to DOS, but for serious callers, the
  207. ; source code is available from the autor. There is NO copyright. You can
  208. ; do anything with FSEND or the source code EXCEPT:
  209.  
  210. ; DO NOT RENAME FSEND to elsewhat and distribute it!
  211.  
  212. ; DO NOT ALTER THE SOURCE CODE, COMPILE AND NAME IT "FSEND".
  213.  
  214. ; Please fell free to contact the autor:
  215.  
  216. ; FidoNet 2:313/9.59
  217. ; Internet HPOLLACK@gw1-x203.uibk.ac.at
  218.  
  219. ; Error reports without a copy of the FSEND.DEB are SENSELESS.
  220.  
  221. ; Many thanks to Bernhard Seidl, Gerold Pummer and Wolfgang Hoffmann
  222. ; for excessive tests of various (beta) versions of FSEND.
  223.  
  224. ; Commandline parameters:
  225.  
  226. ;C:\FSEND /?
  227.  
  228.  
  229. ;-------------------------------------------------------
  230. ;FaxSend/2 for IBM OS/2 32 Bit Version 1.10b Sep 01 1995
  231. ;No Rights Reserved               Dr.H.Pollack & B.Seidl
  232. ;-------------------------------------------------------
  233.  
  234.  
  235. ;FSEND.EXE -p<phonenumber> -i<filename> [options]
  236.  
  237. ;Options:  -i<filename> . file(s) to send [*.TIF, *.BMP or *.TXT]
  238. ;          -i@<filename>  points to a file containing filenames
  239. ;          -p<number> ... phone number to call
  240. ;          -#<fax> ...... send fax from faxlog
  241. ;          -c<filename> . configuration file [FSEND.CFG]
  242. ;          -d<name> ..... recipient of fax
  243. ;          -m<comment> .. short message to recipient
  244. ;          -NoCover ..... no coverpage at all
  245. ;          -NoEOM ....... special parameter to suppress
  246. ;                         interpage negotiation
  247. ;          -testdcdoff... do NOT check carrier (DCD)
  248. ;          -FastLoad .... do NOT read diskdata in IDLETIME
  249. ;          -r[n] ........ fill order of fax raw file [1]
  250. ;          -t ........... trace activities on screen
  251. ;          -x ........... save each page as FXDTnnnn.BMP
  252. ;          -h|/h|-?|/? .. shows this command summary.
  253.  
  254. ; -i
  255.  
  256. ; You can enter input file as much as you like (and the OS/2 can handle :-).
  257. ; Wildcards like '*' and '?' are supported. Filenames without extention are
  258. ; treated as '*.TIF'. Single and multi page TIFF is supported. Plain ASCII
  259. ; text files are eccepted, as well as OS/2 and WINDOWS Bitmaps (*.BMP) if they
  260. ; are well formed and in accordance to WINDOWS SDK or OS/2 redbooks !!!
  261. ; Keep in mind, BMP or often 'crippeled' and and they only SEEM to be a bitmap!
  262.  
  263. ; -i@
  264.  
  265. ; This feature gives you the ability to construct a textfile as an input to
  266. ; FSEND, which contains all filenames to transmit like with '-i'.
  267.  
  268. ; -p
  269.  
  270. ; You can enter the phone number in one string or splitted by blanks (e.g.
  271. ; '-p0321 543 76 98') but do not use dashes or slashes inbetween the number.
  272. ; The phone number is put in the headerline of the fax.
  273.  
  274. ; -d
  275.  
  276. ; The same rule as in '-p'. There is no casetranslation.
  277.  
  278. ; -c
  279.  
  280. ; selfexplanating, I hope :-)
  281.  
  282. ; -testdcdoff
  283.  
  284. ; FSEND tests (in a background thread) the existence of Data Carrier. Some
  285. ; modems do not handle this signal in the right way, so you can switch off
  286. ; this test. An idication is, if an error is reported while 'handshaking sound'
  287. ; is produced. FSEND will (should :-) never hang to infinity even if this test
  288. ; is disabled, because all is checked by timeout. Checking DCD only speeds up
  289. ; the aborting sequence.
  290.  
  291. ; -r[#]
  292.  
  293. ; FSEND can send raw fax data (in the form BinkleyTerm produces PAGEnnnn.FAX),
  294. ; but it is strongly recommanded, to DO NOT USE THIS FEATURE because
  295. ; unpredictable results are the rule :-). This switch is only for testing.
  296.  
  297. ; -t
  298.  
  299. ; All informations which are written to FSEND.DEB is copied to the screen.
  300. ; Senseful while testing, but timeconsuming.
  301.  
  302. ; -NoEOM
  303.  
  304. ; It seems (to me), creators of faxmodems or faxsoftware cannot READ the
  305. ; appropriate standards (like CCITT T.30 or EIA/TIA-592) in order to well
  306. ; implimate the neccessary protocols in their products. The well defined
  307. ; signal EOM (EndOfMessage = multi documents in ONE faxsession) is missed in
  308. ; a lot of products. Therefore, you can 'switch off the brain' of FSEND and
  309. ; let it act in a more simple way ...
  310.  
  311. ; For clearnes:
  312.  
  313. ; In a faxsession (one call) you can transmit any number of pages. If ALL pages
  314. ; have the same resolution and are of the same kind of contents (text or
  315. ; black & white graphics or even dithered grayscale images) you can transmit
  316. ; them in ONE document. If contents changes (some pages are text, some are
  317. ; grayscale images and others are b/w images) you can split your session into
  318. ; more documents and use dedicated session parameters for each type of image:
  319. ; for text, 'normal' resolution and 2-D Read compression, for dithered
  320. ; grayscale images 'fine' resolution and 1-D Huffman compression or for simple
  321. ; b/w images 'fine' resolution and 2-D Read compression. This changes are
  322. ; signaled by an EOM which forces the receiver to change its capabilities.
  323. ; This method yields in more efficient transmission and SHORTER connect times.
  324. ; By this methode you can save MORE money than by using higher transmission
  325. ; speed !!!!
  326.  
  327. ; -x
  328.  
  329. ; For checking the validy of your source (TIF or TXT or RAW). A file
  330. ; FXDTnnnn.BMP is stored for each page. The BMP is inverse (last scanline
  331. ; first). This switch should be used only to test pagegeneration.
  332.  
  333. ; Finaly:
  334.  
  335. ; There is, in fact, no purpose, why FSEND should realy work. The Class 2
  336. ; fax communication rules (right, there is NO STANDARD) are crippled and each
  337. ; manufactuerer of faxmodem uses its own rules. Commercial faxprograms works
  338. ; fine with a great number of modems, but in fact, they tread each modem in a
  339. ; certain manner. It can not be the result of a free available faxprogram
  340. ; to work with each and every modem on the market. But it works with a lot
  341. ; of modems, more then expected :-).
  342.  
  343. ; Class 2.0 is an adopted and recommanded standard, but at the time, FSEND
  344. ; was written, only two modems (Zyxel and USR) was available with this class.
  345.  
  346. ; Hint (in case of errors :-)
  347.  
  348. ; 1) You are misinterpreting this document
  349. ; 2) FSEND could not interpret some lines, because you had mixed up Class 2
  350. ;    and Class 2.0 commands.
  351. ; 3) FSEND could not handle your TIF.
  352. ; 4) Your modem is misinterpreting commands from FSEND (the normal case :-)
  353. ; 5) Public telephone lines were NOT build for fax. Each errorfree page
  354. ;    should be treaded as a surprise.
  355. ; 6) Do NOT try to transmit at high speeds. Faxmachines normally sends with
  356. ;    4800 bps or less!
  357. ; 7) Your preferred faxprogram works well, FSEND not. Well that's a fact.
  358.  
  359. ;ErrorLevels returned by FSEND.EXE:
  360.  
  361.  
  362. ; ErrorLevel 1 ..... falscher Kommandozeilenparameter
  363. ; ErrorLevel 2 ..... keine Telephonnummer
  364. ; ErrorLevel 3 ..... keine oder falsche Konfigurationsdatei
  365. ; ErrorLevel 10 .... UserExit (exit/retry or ESC)
  366. ; ErrorLevel 100 ... DebugThreadError
  367. ; ErrorLevel 101 ... TIFFThreadError
  368. ; ErrorLevel 102 ... HUFFThreadError
  369. ; ErrorLevel 103 ... ComInThreadError
  370. ; ErrorLevel 104 ... TimeThreadError
  371. ; ErrorLevel 251 ... Abbruch nach verbindungsaufbau
  372. ; ErrorLevel 253 ... ModemError
  373. ; ErrorLevel 254 ... ComPortError
  374. ; ErrorLevel 255 ... Speicher nicht ausreichend
  375.  
  376.