home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / FONDIR57.ZIP / FONDIR.DOC < prev    next >
Text File  |  1991-11-03  |  64KB  |  1,686 lines
  1.  
  2. ╔═══════════════════════════════════════════════════════════════════════╗
  3. ║                                                                       ║
  4. ║      ╔═══  ╔══╗  ╔╗  ╗  ╔══╗   ═╦═  ╔══╗           User's Guide       ║
  5. ║      ╠═══  ║  ║  ║╚╗ ║  ║  ╚╗   ║   ║  ╚╗          to Operation       ║
  6. ║      ║     ║  ║  ║ ╚╗║  ║   ║   ║   ╠═╦═╝                             ║
  7. ║      ╚     ╚══╝  ╚  ╚╝  ╚═══╝  ═╩═  ╚ ╚══                             ║
  8. ║                                                                       ║
  9. ║                                                                       ║
  10. ║       FONDIR - BBS Text File to Phone Directory Translate Utility     ║
  11. ║      Copyright (C) 1988-1991 Henry C. Clark, All rights reserved.     ║
  12. ║                                                                       ║
  13. ╚═══════════════════════════════════════════════════════════════════════╝
  14.  
  15.  
  16.                           Software Mechanics
  17.                            P.O. Box 832052
  18.                          Richardson, TX 75083
  19.  
  20.         214-881-2627  12/24/96/14400 bps  24hr  FidoNet 1:124/6119
  21.  
  22.  
  23.  
  24. ╔═══════════════════════════════════════════════════════════════════════╗
  25. ║ WHATS NEW                                                             ║
  26. ╚═══════════════════════════════════════════════════════════════════════╝
  27.  
  28. FONDIR Version 5.7 implements support for Unicom 3.0 and Commo 5.0,
  29. newer versions of existing programs.  Also, tests were performed to
  30. insure compatibility with Boyan 5.0 and Qmodem 4.3 ( although no
  31. changes occurred in the directory formats ).
  32.  
  33. FONDIR now supports alternate subdirectory specification for the
  34. support files :  ldarea., metro., and the directory files.  See the
  35. new section on the /s: parameter for more information.  This change
  36. is made to provide support for online directory builders in a
  37. multiuser environment.
  38.  
  39. Enjoy.
  40.  
  41.  
  42. ╔═══════════════════════════════════════════════════════════════════════╗
  43. ║ TABLE OF CONTENTS   FONDIR Version 5.7                                ║
  44. ╚═══════════════════════════════════════════════════════════════════════╝
  45.  
  46. Chap.  1 -- FONDIR ARCHIVE.
  47.   Installation
  48.   Overview
  49.   History
  50.  
  51. Chap.  2 -- HOW TO IMPORT A BBS LIST TO YOUR PROGRAM.
  52.   Quick Start Section
  53.   Fondir Uses Default Directory Name
  54.   Fondir Renames Existing Directory File
  55.  
  56. Chap.  3 -- HOW TO EXPORT FROM YOUR PROGRAM TO A BBS LIST.
  57.   Fondir Appends To Existing BBS List
  58.  
  59. Chap.  4 -- ONLINE HELP.
  60.  
  61. Chap.  5 -- THE COMMAND LINE OPTIONS.
  62.   Comm Program type   ( /o: option )
  63.   Assume Protocol     ( /p: option )
  64.   Keep Date           ( /k  option )
  65.   Local Area Code     ( /l: option )
  66.   Prefix Phone Number ( /a: option )
  67.   Metro Number        ( /d: option )
  68.   Format Specification Key Character ( /c  option )
  69.   Modem Speed         ( /m:  and /b:  options )
  70.   Export              ( /x  option )
  71.   Support file path   ( /s: option )
  72.  
  73. Chap.  6 -- FONDIR DOS COMMAND SYNTAX EXAMPLES.
  74.   Transform Example
  75.   Error Checking of Input ( semantic )
  76.   Error on Input ( logical )
  77.  
  78. Chap.  7 -- BBS LIST FORMAT SPECIFICATIONS.
  79.   Format Specification Coding
  80.   Format Specifier Stacking
  81.   Format First Word Length
  82.   Format Header Specification
  83.   Comm Program Field Support
  84.  
  85. Chap.  8 -- BBS LIST CONTENTS
  86.   Protocol Field Format
  87.   The Bps Modem Rate
  88.   Modem Type
  89.   Parity Indicator
  90.   File Transfer Protocol Type
  91.   Terminal Emulator Mode Codes
  92.   Examples of BBS Lists
  93.  
  94. Chap.  9 -- PROGRAM SWITCHES AND DEFAULTS.
  95.   Comm Program Type Codes
  96.   Speed Code Parameters
  97.   Warnings and Other Notes
  98.  
  99. Chap. 10 -- REGISTER TO GET UPDATES.
  100.   Mail-in Registration Form
  101.  
  102. Chap. 11 -- LICENSE AGREEMENT.
  103.   The Terms of The Agreement
  104.   Note from the Author
  105.  
  106.  
  107.  
  108. ╔═══════════════════════════════════════════════════════════════════════╗
  109. ║ 1 -- FONDIR ARCHIVE                                                   ║
  110. ╚═══════════════════════════════════════════════════════════════════════╝
  111.  
  112. FONDIR is shipped in an archive file, FONDIRxx.ZIP.  The 'xx' is the
  113. version number.  The archive file should contain the following files :
  114.  
  115.    FONDIR.EXE          - 8088 compatible version,
  116.    FONDIR.DOC          - this document file you're reading now,
  117.    FONERR.DOC          - list of displayed output from FONDIR operations
  118.                          meaning and possible solutions to problems
  119.    METRO.214           - sample DFW 214 metro exchange list,
  120.    LDAREA.214          - sample Dallas 214 long distance exchange list,
  121.    METRO.817           - sample DFW 817 metro exchange list,
  122.    COMCOL.EXE          - program to convert comma separated files to
  123.                          the columnar format used by FONDIR,
  124.    COMCOL.DOC          - document for that program.
  125.  
  126. Specify when you register that you want the sixteen bit versions for
  127. 286 computers.
  128.  
  129.  
  130. ┌───────────────────────────────────────────────────────────────────────┐
  131. │ OVERVIEW                                                              │
  132. └───────────────────────────────────────────────────────────────────────┘
  133.   
  134.  
  135. FONDIR will convert a text list of BBS phone numbers, names and other
  136. information into a file which can be used by your Comm Program.
  137.  
  138. You may have to ADD CONTROL CODES TO THE TEXT LIST to show FONDIR where
  139. the information is.  The control codes are called the Format
  140. Specification Key in this documentation.
  141.  
  142. FONDIR can also convert back to a text list format from your Comm
  143. Program phone directory file.
  144.  
  145.   BBS List -> FONDIR Import -> Comm Program directory file
  146.   Comm Program directory file -> FONDIR Export -> BBS List
  147.  
  148. You can use this two step processes to convert from one comm program
  149. to another.
  150.  
  151. COMCOL will convert a text file with comma separated fields to a
  152. vertical column field text file.  There is a separate document
  153. covering that program.  FONDIR likes columns of data.
  154.  
  155.  
  156. ┌───────────────────────────────────────────────────────────────────────┐
  157. │ INSTALLATION                                                          │
  158. └───────────────────────────────────────────────────────────────────────┘
  159.  
  160. FONDIR is short for Phone Directory. Un-zip the FONDIRxx.ZIP file and
  161. either :
  162.  
  163.   a.) keep the .exe program and exchange lists
  164.       with your BBS list files, or
  165.   b.) keep the .exe program and exchange lists
  166.       with your Comm Program files.
  167.  
  168. FONDIR will work from a pathed sub-directory.  See the section on
  169. Support file path for information regarding the specification of
  170. subdirectories for the different files FONDIR uses.
  171.  
  172.  
  173.  
  174. ┌───────────────────────────────────────────────────────────────────────┐
  175. │ HISTORY                                                               │
  176. └───────────────────────────────────────────────────────────────────────┘
  177.   
  178.  
  179. FONDIR, Version 5.7 is the result of continual upgrades, including :
  180.  
  181.      as BF.EXE ( Boyan Phone )
  182.    V 1.0a  initial release, options h,s,n,p,b,m,d, CARR to BOYAN
  183.    V 1.1a    correct 9600 bps value for BOYAN
  184.  
  185.      as XLATE.EXE ( Translate )
  186.    V 2.0a  add procomm 2.4.2, procomm plus, qmodem, gt-powercomm, telix
  187.    V 3.0b  corrected gt-power headers, added options x, k
  188.    V 3.1b   on /b set speed option, move speed text into name area at end
  189.    V 3.2   correct end of gt file handling, pibterm support ( /o:I )
  190.    V 3.3   correct less than 8 char phone number length
  191.    V 3.4   new BBS list system name formats
  192.  
  193.      as FONDIR.EXE ( "Phone Dear" )
  194.    V 4.0a  any list using format specification, /l, /a area code options
  195.    V 4.1a  gt v.14, format codes for elapse, upload, download
  196.    V 4.2   telix 3, pibterm 4.1
  197.    V 4.3a  metro number support
  198.    V 4.4   Boyan 4 support, any two metro areas, Qmodem 4.0 support
  199.    V 4.5   gt 1500, area headers, stacked format fields
  200.    V 4.6   telemate 1.10
  201.    V 4.7   telemate memo & passwords, blank field bug fix, Zmodem default
  202.    V 4.8   telix export bug fix, /x:dirfile name option
  203.    V 4.9   Qmodem index number bug fix
  204.    V 5.0   PC-Talk4, Rcomm, K9-Express support, 80 exchange tables
  205.    V 5.1   Mirror 3 support
  206.    V 5.2   telemate 2.0, PC Anywhere 3.11, Carbon Copy Plus 4.01,
  207.            |g logfile key, |i port key
  208.    V 5.3   gt-15.50, MSC 6.0, remove 's' functions, first word on
  209.            file names
  210.    V 5.4   ADialer 2.0, remove duplex, fix telemate speed code
  211.    V 5.5   Commo 4.3, Qmodem 4.2, fix count truncate bugs
  212.    V 5.6   Unicom 2.0, Procomm + 2.0, test GT 16
  213.    V 5.7   Unicom 3.0, Commo 5, Boyan 5 tests, Qmodem 4.3 tests,
  214.            /s: support file path parameter
  215.  
  216.  
  217.  
  218. ╔═══════════════════════════════════════════════════════════════════════╗
  219. ║ 2 -- HOW TO IMPORT A BBS LIST TO YOUR PROGRAM                         ║
  220. ╚═══════════════════════════════════════════════════════════════════════╝
  221.  
  222.  
  223. ┌───────────────────────────────────────────────────────────────────────┐
  224. │ QUICK START SECTION                                                   │
  225. └───────────────────────────────────────────────────────────────────────┘
  226.  
  227.  
  228. Most BBS lists are distributed in text file format.  The list entries
  229. are arranged 'one BBS system per line of text', and the data for each
  230. BBS is arranged in columnar format.
  231.  
  232. FONDIR will convert a BBS list text file to the binary file that your
  233. Comm Program uses in it's dialing directory.
  234.  
  235. For example, let's suppose you have a BBS list file, and each line of
  236. data looks something like this :
  237.  
  238. 03/24 MY BBS               OPUS  214-881-2627  #Z  Henry Clark
  239. 03/24 Joe's BBS            OPUS  214-555-1234  #Z  Joe Modem  
  240. 03/24 RBBS Central         RBBS  900-555-0000  #Y  Huck Finn  
  241.  
  242. You need to add a set of codes to the list file so that FONDIR knows
  243. where the information about each BBS system is :
  244.  
  245. |d5   |n20                 |f4   |#12          |p2 |i11
  246.  
  247. 03/24 MY BBS               OPUS  214-881-2627  #Z  Henry Clark
  248. 03/24 Joe's BBS            OPUS  214-555-1234  #Z  Joe Modem  
  249. 03/24 RBBS Central         RBBS  900-555-0000  #Y  Huck Finn  
  250.  
  251. The codes ( for Format Specification ) I have used include the
  252. date last called ( |d ), the BBS system name ( |n ), a Script
  253. File name ( |f ), the phone number ( |# ) and some protocol
  254. codes ( |p ) and an information field ( |i ).
  255.   
  256. After each code letter is the width of each columnar field.
  257.  
  258. Given the above two lines in a file called BBS.LST, I could then
  259. create a Comm Program directory file, for example the Boyan Version 5
  260. BOYAN.FON file, with the DOS command :
  261.  
  262. C:>fondir bbs.lst /o:q /k
  263.  
  264. That's all there is to it.  A QMODEM.FON file, ready to be used by the
  265. Qmodem Comm Program, will be created in the current directory.
  266.  
  267.  
  268. ┌───────────────────────────────────────────────────────────────────────┐
  269. │ MORE DETAIL ABOUT FONDIR IMPORT                                       │
  270. └───────────────────────────────────────────────────────────────────────┘
  271.   
  272.  
  273. I don't know which Comm Program you use.  I do know that the /o:
  274. option is REQUIRED.  You must use the /o: option to tell FONDIR which
  275. Comm Program you use. You must figure out which /o:  option is for
  276. your Comm Program.  Is that so hard ?
  277.  
  278. Target phone directory filenames :
  279.  
  280. "BOYAN.FON"               use the  /o:b  option  Boyan
  281. "PROCOMM.DIR"             use the  /o:p  option  Procomm
  282. "PCPLUS.DIR"              use the  /o:+  option  Procomm Plus 1.1
  283. "PCPLUS.DIR"              use the  /o:2  option  Procomm Plus 2.0
  284. "QMODEM.FON"              use the  /o:q  option  Qmodem
  285. "GT.DIR"                  use the  /o:g  option  GT Powercomm
  286. "TELIX.FON"               use the  /o:t  option  Telix
  287. "PIBTERM.FON"             use the  /o:i  option  Pibterm
  288. "TM.FON"                  use the  /o:m  option  Telemate * See note below
  289. "PC-TALK4.DIR"            use the  /o:c  option  PC-Talk
  290. "PC-TALK.DIR"             use the  /o:r  option  Rcomm
  291. "K9X.P"                   use the  /o:k  option  K9 Express
  292. "DIALDIR.DAT"             use the  /o:o  option  Mirror
  293. "DIALDIR.PRM"             use the  /o:a  option  PC Anywhere
  294. "CC30.CFG"                use the  /o:y  option  Carbon Copy
  295. "BBS.DAT"                 use the  /o:d  option  A Dialer
  296. "COMMO.FON"               use the  /o:f  option  Commo
  297. "UNICOM.DIR"              use the  /o:u  option  Unicom
  298.  
  299.  
  300. "Boyan, Procomm, Procomm +, Qmodem, Gt-Powercomm, Telemate, Telix,
  301. Pibterm, PC-Talk4, Rcomm, K9-Express, Mirror 3, PC Anywhere,
  302. Carbon Copy Plus, A Dialer, Commo and Unicom"...
  303.  
  304.   ...are all Copyrighted by their respective authors.
  305.  
  306. In general, the contents of the phone file reflect your programs
  307. dialing directory information.  The above file names are the
  308. defaults for your Comm Programs.
  309.  
  310. * File create name note :
  311.  
  312. For Telemate, when using the System ID ( |i ) specification, a file
  313. called "TM.MEM" is created.  This is the Telemate memo file and it's
  314. contents is seen in the online dialing directory.  FONDIR refers to
  315. it as the 'auxiliary' file.
  316.  
  317.  
  318. ┌───────────────────────────────────────────────────────────────────────┐
  319. │ FONDIR USES DEFAULT DIRECTORY NAME.                                   │
  320. └───────────────────────────────────────────────────────────────────────┘
  321.   
  322.  
  323. FONDIR always uses the above file names, and they are assumed to be
  324. in your current directory. It is an ERROR to enter a file name of
  325. these types as a parameter for FONDIR.  You specify one of the file
  326. names above using the /o:? parameter.  The valid characters for the
  327. '?' are shown above.
  328.  
  329. FONDIR is going to convert from the text file to the Comm Program
  330. directory file, or vice versa.  You specify the Comm Program
  331. type with the /o:? option, and you specify the BBS List text file name
  332. explicitly.
  333.  
  334.  
  335. ┌───────────────────────────────────────────────────────────────────────┐
  336. │ FONDIR RENAMES EXISTING DIRECTORY FILE.                               │
  337. └───────────────────────────────────────────────────────────────────────┘
  338.   
  339.  
  340. When FONDIR is going to write a directory file with one of the above
  341. names, AND that file already EXISTS : FONDIR will rename the existing
  342. file by changing the last letter of the 'filename' part of the
  343. complete file name to a unique number.  For example, BOYAN.FON might
  344. become BOYA1.FON.
  345.  
  346. This technique is used when the BBS list contains more entries than
  347. the Comm Program file will support.  FONDIR will continue to rename
  348. the file to a unique name, for each directory file that is necessary
  349. to COMPLETELY convert the BBS list.  For example, you might end up
  350. with the following files, ( again, I'll use the BOYAN.FON example ) :
  351.  
  352.    boyan.fon   - the last file
  353.    boya1.fon   - the first file ( assuming none existed previously )
  354.    boya2.fon   - the second file ( second set of entries )
  355.    etc.
  356.  
  357. There are two ways to use these 'numbered' files.  The first is to
  358. simply copy it to the actual name required by your Comm Program.  The
  359. second way is to use your Comm Program's "select phone directory
  360. file" option, many Comm Programs support this function.
  361.  
  362. Any auxiliary file generated will follow this same naming convention.
  363.  
  364. WARNING : the maximum number of BBS list entries supportable is
  365. dependent upon the number of entries per file your Comm Program
  366. supports.  If FONDIR has to create more than 10 directory files,
  367. the numbering system will fall into the characters which logically
  368. follow the '9' character;  this is not fatal, just be sure to watch
  369. the file names to get the idea.  After '9' comes '@', then 'A', 'B',
  370. etc.
  371.  
  372.  
  373. ┌───────────────────────────────────────────────────────────────────────┐
  374. │ USAGE EXAMPLE ( Import BBS list to Comm Program ).                    │
  375. └───────────────────────────────────────────────────────────────────────┘
  376.   
  377.  
  378. The following command is an example.  To convert to Procomm Plus 2.0 :
  379.  
  380.  FONDIR bbslist.txt /o:2
  381.         ^           ^
  382.         |           |
  383.         |           |
  384.         |           |
  385.         |           `-  translate to the Procomm + 2.0 format
  386.         `-  translate from this BBS list file
  387.  
  388. The BBS list file must contain a Format Specification which FONDIR
  389. uses to determine how the data in the list file is organized.  YOU
  390. MUST MANUALLY enter the specification if it is not already there.
  391. See Chapter 7 for more information on the Format Specification.
  392.        
  393. Register if you want custom Comm Program translations.
  394.  
  395.  
  396.  
  397. ╔═══════════════════════════════════════════════════════════════════════╗
  398. ║ 3 -- HOW TO EXPORT FROM YOUR PROGRAM TO A BBS LIST                    ║
  399. ╚═══════════════════════════════════════════════════════════════════════╝
  400.  
  401. The idea of exporting TO a BBS list text file from your program phone
  402. directory is to support the changes you are still making manually, so
  403. that you don't have to enter them again every time a BBS list
  404. changes.  The Export feature is also useful for translating between
  405. two or more Comm Programs.
  406.  
  407. The BBS list file must contain a Format Specification.  See Chapter 7
  408. for more information on the Format Specification.
  409.  
  410. For example purposes, create a text file called BBSLIST.TXT with
  411. the following line in it :
  412.  
  413. |d5   |n20                 |#12          |p4
  414.  
  415. Make sure your text file does NOT contain a CONTROL-Z ( ascii EOF ),
  416. such as DOS EDLIN would generate.
  417.  
  418. The FONDIR export command has three parameters :
  419.  
  420.   FONDIR bbslist.txt /o:b /x
  421.          ^           ^    ^
  422.          |           |    |
  423.          |           |    `------  the export option
  424.          |           `--------- the program type Boyan option
  425.          `------------------ a BBS text file to write to
  426.  
  427. The above command will append list information from your Boyan
  428. program phone file directory ( boyan.fon ), to a file called 
  429. "bbslist.txt" which would look like this :
  430.  
  431. |d5   |n20                 |#12          |p4
  432.  
  433. 03/24 MY BBS               214-881-2627  #Z
  434. 03/24 Joe's BBS            214-555-1234  #Z
  435. 03/24 RBBS Central         900-555-0000  #Y
  436.   
  437. You can specify WHICH Comm Program directory file to export using the
  438. option /x:filename format.  See the /x option description for more
  439. information.
  440.  
  441.  
  442. ┌───────────────────────────────────────────────────────────────────────┐
  443. │ FONDIR APPENDS TO EXISTING BBS LIST.                                  │
  444. └───────────────────────────────────────────────────────────────────────┘
  445.   
  446.  
  447. FONDIR always writes it's export text to the file name given.  It
  448. does NOT overwrite an existing text file of that name, it adds it's
  449. export data to the end of existing data.  These are also called
  450. 'append' writes.
  451.  
  452. You may specify a fully qualified path name for your BBS list text
  453. file.
  454.  
  455.  
  456.  
  457.  
  458. ╔═══════════════════════════════════════════════════════════════════════╗
  459. ║ 4 -- ONLINE HELP                                                      ║
  460. ╚═══════════════════════════════════════════════════════════════════════╝
  461.  
  462. You can get the following help information by entering the FONDIR
  463. command with NO parameters, with the /h parameter, or with the /?
  464. parameter.
  465.  
  466.  Command format is  >FONDIR  bbslist.fil  /o:x  [options]
  467.  
  468.   /o:x   - x is Comm Program : B P + 2 Q G T I M C R K O A Y D F or U.
  469.     Boyan,Procomm,procomm+,procomm + 2,Qmodem,Gt-power,Telix,pIbterm,teleMate
  470.     pC-talk4,Rcomm,K9-express,mirrOr3,pcAnywhere,carboncopY,aDialer,F-Commo
  471.     Unicom
  472.  OPTIONS :
  473.   /m:n     - max modem speed       /b:n    - speed always : 3,1,2,4,9,a,b
  474.   /k       - keep dates            /p:c    - protocol always 'c'
  475.   /l:ddd   - LOCAL area code ddd   /d:ddd.. - METRO exchange area code ddd
  476.   /a:ddd.. - long distance prefix  /s:path  - support file path
  477.   /c:c     - BBS list format key
  478.   /x:dirname - Export to BBS list, default is Import from BBS list
  479.  
  480.  Separate options with a space. See docs for list format specifiers.
  481.    EXAMPLE :   FONDIR bbs.lst /o:b /k /l:214 /d:817 /a:1-
  482.  
  483.  24hr. Help/Register at   124/6119   MY BBS   214-881-2627.
  484.  
  485.  
  486.  
  487.  
  488. ╔═══════════════════════════════════════════════════════════════════════╗
  489. ║ 5 -- THE COMMAND LINE OPTIONS                                         ║
  490. ╚═══════════════════════════════════════════════════════════════════════╝
  491.  
  492. ┌───────────────────────────────────────────────────────────────────────┐
  493. │ COMM PROGRAM TYPE ( /o:  option ).                                    │
  494. └───────────────────────────────────────────────────────────────────────┘
  495.  
  496.  
  497. It's required and fully described in Chapter 2, section More Detail
  498. on Import.
  499.  
  500.  
  501.  
  502. ┌───────────────────────────────────────────────────────────────────────┐
  503. │ ASSUME PROTOCOL ( /p:   option ).                                     │
  504. └───────────────────────────────────────────────────────────────────────┘
  505.   
  506.  
  507. If you specify a protocol using the /p option, then FONDIR will
  508. always set the protocol in each phone directory entry to the letter
  509. you specify in the /p option.
  510.  
  511. In the absence of the /p option, FONDIR will use the Format
  512. Specification for PROTOCOL Code ( |p5 ), as you specified in the text
  513. file, and look there for a file transfer protocol code.  The codes
  514. are defined in Chapter 8.
  515.  
  516.  
  517. ┌───────────────────────────────────────────────────────────────────────┐
  518. │ KEEP DATE ( /k  option ).                                             │
  519. └───────────────────────────────────────────────────────────────────────┘
  520.   
  521.  
  522. If you want to update the date of last call in your Comm Program
  523. phone file directory, then use the /k option.  If you do NOT use the
  524. /k option, then your phone file directory will contain a blank date.
  525.  
  526. In a special case, a Qmodem 4.3 entry will contain the date that
  527. FONDIR created the FON directory.
  528.  
  529.  
  530. ┌───────────────────────────────────────────────────────────────────────┐
  531. │ LOCAL AREA CODE ( /l:   option ).                                     │
  532. └───────────────────────────────────────────────────────────────────────┘
  533.   
  534.  
  535. The phone numbers in a BBS list are best kept as full 10 digit phone
  536. numbers.  Like this : 214-881-2627.
  537.  
  538. They do not HAVE to be this way, but the FONDIR /l, /d and /a options
  539. function best when you use 10 digit codes. For your local calls, area
  540. code dialing will not be required.  The /l: option allows you to
  541. specify which area code is your local area code, and FONDIR will
  542. remove the area code digits from the phone number in the text list
  543. entry.
  544.  
  545. See Chapter 7 for |L format options that allow use of 7 digit numbers
  546. in the list, with an area code 'header'.
  547.  
  548. For example, if you live in the 214 area code, you may want to use
  549. the option /l:214-   to remove ONLY those digits from the start of
  550. a phone number.
  551.  
  552. Of course, many numbers in your local area code are still long
  553. distance.  FONDIR will attempt to read a file called LDAREA.xxx,
  554. where 'xxx' is the three digit local area code.  Each exchange in the
  555. LDAREA.xxx file is assumed to be not local, but long distance.
  556. Since I don't know all the long distance areas and phone exchanges, I
  557. leave it up to you to make your own LDAREA.xxx files, if you need
  558. them.  Just make sure you use the same format that the METRO.xxx files
  559. use, ie. one three digit code per line.
  560.  
  561. Here's an example :  You live in the 214 area code, and you have a
  562. BBS list like this --
  563.  
  564. |d5   |n20                 |#12          |p4
  565.  
  566. 03/24 MY BBS               214-881-2627  #Z
  567. 03/24 Joe's BBS            214-555-1234  #Z
  568. 03/24 RBBS Central         900-555-0000  #Y
  569.  
  570. You also have a file called LDAREA.214 that contains two lines :
  571.  
  572. 555
  573. 666
  574.  
  575. When you use the /l:214 and /a:1- options, FONDIR will create phone
  576. numbers that look like this :
  577.  
  578. 1 MY BBS               881-2627
  579. 2 Joe's BBS            1-214-555-1234
  580. 3 RBBS Central         1-900-555-0000
  581.  
  582. Why ?  The first entry was 214-881 and 881 is NOT in the LDAREA.214
  583. file, so it must be local.  FONDIR stripped the area code.  The
  584. second entry was 214-555 and 555 IS in the LDAREA.214 ( remember this
  585. is just an example ).  555 then must be long distance, so FONDIR
  586. prefixed the number using the 1- code.  The third entry is area code
  587. 900 and in not involved with this type of translation.
  588.  
  589. On export, FONDIR will add back the area code to any phone number
  590. which is 8 digits or less, prior to writing to the BBS list file, if
  591. you use the /l: and /a: options.
  592.  
  593. If you use the /s: path option, it affects where FONDIR looks for the
  594. LDAREA exchange file.  Use the /s: option before the /l: option, and
  595. the LDAREA file is searched from the path.  Use the /s: option after
  596. the /l: option, and the LDARDA file is searched from the default
  597. subdirectory.  See the section on the /s: option for more
  598. information.
  599.  
  600.  
  601. ┌───────────────────────────────────────────────────────────────────────┐
  602. │ PREFIX PHONE NUMBER ( /a:  option ).                                  │
  603. └───────────────────────────────────────────────────────────────────────┘
  604.   
  605.  
  606. The phone numbers in a BBS list may not always be fully dialable
  607. phone numbers.  Some examples of this are 'local 7 digit numbers'
  608. which are not local to you, incomplete phone numbers which are not
  609. stand alone numbers, or when you need to use access codes before you
  610. dial the number, such as the standard 1+ access code.
  611.  
  612. The /a: option, only works on Long Distance numbers outside your
  613. local area code as specified by the /l: option, unless the additional
  614. LDAREA.xxx file has been used.
  615.  
  616. Use /a:  followed by one or more prefix digit codes.  For example,
  617. you need to dial 10288-1- to get the correct long distance carrier :
  618. use /a:10288-1-  to prefix every LD phone number in the BBS list.
  619.  
  620. Most people with standard 10 digit phone lists will use :
  621.   /a:1-
  622.  
  623. The prefix is not recommended for PBX ( dial 9 to get out ) type
  624. functions.  In these cases, where ALL your phone numbers must be
  625. prefixed, use your Comm Program's dialing prefix feature, or set your
  626. modem dial string to something like ATDT9,  which causes every phone
  627. number to begin with the 9.
  628.  
  629.  
  630. ┌───────────────────────────────────────────────────────────────────────┐
  631. │ METRO NUMBER ( /d: option )                                           │
  632. └───────────────────────────────────────────────────────────────────────┘
  633.   
  634.  
  635. The files METRO.214 and METRO.817 contain sample exchange code
  636. listings.  The sample represents the 214 and 817 area codes.  Each
  637. file can contain none, one or up to 50 'exchange' codes.
  638.   
  639. An exchange is the first three digits of a 7 digit number.  Certain
  640. areas of the country allow callers to dial 'toll free' calls with
  641. 10 digits, ie. using the area code, but not the 1+ format.  These
  642. extended area calls are typically called Metro numbers.
  643.  
  644. FONDIR looks for a METRO.xxx file.   The 'xxx' is changed to the
  645. area code digits you specify in the /d: option.
  646.  
  647. If FONDIR finds such a file in the current directory, it will enable
  648. the logic to determine from your /d: option ( a metro area ) and
  649. the /a: option ( the long distance prefix ), whether or not a number
  650. is truly long distance, a metro number, or a local phone call, and
  651. how to encode the number correctly for dialing.
  652.  
  653. Since I don't know all the metro areas and phone exchanges, I leave
  654. it up to you to make your own METRO.xxx files, if you need them.  Just
  655. make sure you use the same format that the files are in now, ie. one
  656. three digit code per line.  You must insure that the 'xxx' extension
  657. matches your /d:xxx code.
  658.  
  659. An example :  You live in the 214 area code and you can dial some 817
  660. area code numbers without dialing 1 first.  Your BBS list looks like
  661. this :
  662.  
  663. |d5   |n20                 |#12          |p4
  664.  
  665. 03/24 MY BBS               214-881-2627  #Z
  666. 03/24 Joe's BBS            817-100-1234  #Z
  667. 03/24 RBBS Central         817-555-0000  #Y
  668.  
  669. You have a file called METRO.817 that contains two lines :
  670.  
  671. 555
  672. 666
  673.  
  674. When you use the /d:817 and /a:1- options, FONDIR will create phone
  675. numbers that look like this :
  676.  
  677. 1 MY BBS               1-214-881-2627
  678. 2 Joe's BBS            1-817-100-1234
  679. 3 RBBS Central         817-555-0000
  680.  
  681. Why ?  Well the first entry was just like the example used in the /l:
  682. option description, but I didn't specify a /l: option !  The second
  683. entry is 817-100, but 100 is not in the METRO.817 file, so FONDIR
  684. translates it as a long distance number.  The third entry is 817-555,
  685. and 555 IS in the METRO.817 file, so FONDIR knows its a metro type
  686. number and does not prefix it with the 1- digits.
  687.  
  688. If you use the /s: path option, it affects where FONDIR looks for the
  689. METRO exchange file.  Use the /s: option before the /l: option, and
  690. the METRO file is searched from the path.  Use the /s: option after
  691. the /l: option, and the METRO file is searched from the default
  692. subdirectory.  See the section on the /s: option for more
  693. information.
  694.  
  695. ┌───────────────────────────────────────────────────────────────────────┐
  696. │ NOTES ON /l, /a, /d OPTIONS                                           │
  697. └───────────────────────────────────────────────────────────────────────┘
  698.   
  699.  
  700. The use of '-' dash characters is pretty much the norm for a phone
  701. number.  They are transparent to your modem ( yes, you probably send
  702. dashes to your modem all the time ).  You will note that I have
  703. demonstrated the /l, /a, and /d options using the '-' dash symbols.
  704.   
  705. If your particular BBS list format does not use dashes, then you
  706. should not use them in your option parameters.
  707.  
  708. On the off chance that your BBS list format uses the space ' '
  709. character for a separator, you will have to code the options in a
  710. special way, using quotes around the whole option.
  711.  
  712. For example :   "/l:214 "
  713.  
  714. Note the trailing space after the 214 digits.  This coding format
  715. would be used when your phone numbers look like this : 214 881 2627,
  716. instead of like this : 214-881 2627.
  717.  
  718. Because of restrictions imposed by the logic in FONDIR's phone number
  719. functions, only '-' dash or ' ' space or no separator code at all may
  720. be used.  You may use any of these three choices, at any time, but no
  721. other separator codes are useable.
  722.  
  723.  
  724. ┌───────────────────────────────────────────────────────────────────────┐
  725. │ FORMAT SPECIFICATION KEY CHARACTER ( /c  option ).                    │
  726. └───────────────────────────────────────────────────────────────────────┘
  727.   
  728.  
  729. The Format Specification is a text line that you must place in your
  730. BBS List file.  The Format Specification marks the data columns for
  731. the information fields in each entry.  The default character is the
  732. '|' character.  You may use any marker character by selecting it with
  733. the /c: option, and by using that character within your BBS list
  734. file.
  735.  
  736. See Chapter 7 for more information on the Format Specification and
  737. which programs support which fields.
  738.  
  739.  
  740. ┌───────────────────────────────────────────────────────────────────────┐
  741. │ MODEM SPEED ( /m:  and /b:  options )                                 │
  742. └───────────────────────────────────────────────────────────────────────┘
  743.   
  744.  
  745. The /m option allows you to specify your modems maximum speed.  For
  746. example, if you have a 2400 bps modem, and your BBS list contains
  747. entries with faster rates, you must use the /m:2  option so that
  748. FONDIR will set the rates for the faster entries back to 2400 bps.
  749.  
  750. The /b option allows you to set ALL entries to a specified speed. 
  751. This is useful for 'locking' your modem rate to a fixed speed,
  752. regardless of the speed of the modem at the other end, or the
  753. connected rate.  For example, if you want to lock your modem at 38400
  754. bps, then use the /b:B option and FONDIR will set all the entries to
  755. 38400 bps, regardless of the speed code in the BBS list.
  756.  
  757. See Chapter 11 for the valid Speed Codes.
  758.  
  759.  
  760. ┌───────────────────────────────────────────────────────────────────────┐
  761. │ EXPORT ( /x  option )                                                 │
  762. └───────────────────────────────────────────────────────────────────────┘
  763.   
  764.  
  765. The /x option can be used in one of two formats :
  766.   1) /x =  with default Comm Program directory name assumed, or
  767.   2) /x:dirname = specified Comm Program directory name.
  768.  
  769. If you use the /x option with no directory name, FONDIR export
  770. assumes the standard Comm Program directory name, and that file must
  771. be located in the current sub-directory.
  772.  
  773. If you use the /x:dirname option, and specify the directory name,
  774. that file must also be located in the current directory.  Further,
  775. you may NOT specify a drive, path or file extension in the 'dirname'
  776. field.
  777.  
  778. Even though you specify the directory FILENAME, the EXTENSION is
  779. assumed.  This is because certain Comm Programs follow naming
  780. conventions with the directory file name, and/or auxiliary or
  781. secondary file name.
  782.  
  783. Example using BOYA1.FON :
  784.  
  785.   fondir bbs.lst /o:b /x:boya1
  786.   
  787.  
  788. You can use the /c, /l, /d, /k and /s options with the Export
  789. ( /x ) option.
  790.  
  791. The BBS list filename is mandatory, and must contain a Format
  792. Specification as is the /o: option.
  793.  
  794. See Chapter 3 for more information on Export.
  795.  
  796.  
  797. ┌───────────────────────────────────────────────────────────────────────┐
  798. │ SUPPORT FILE PATH ( /s:  option )                                     │
  799. └───────────────────────────────────────────────────────────────────────┘
  800.  
  801. In response to requirements for a multiuser FONDIR, such as with the
  802. online directory creation doors, or for LAN usage, the /s option
  803. allows you to specify a subdirectory where FONDIR support files are
  804. located.
  805.  
  806. The support files include :
  807.   LDAREA exchange file ( if /l specified after /s )
  808.   METRO exchange file ( if /d specified after /s )
  809.   comm program directory ( both import and export )
  810.   auxiliary file ( both import and export )
  811.  
  812. Path information for the BBS text file may be specified in that
  813. filename parameter.
  814.  
  815. FONDIR looks for the LDAREA or METRO exchange files in the current
  816. subdirectory unless the /s:path option is specified before the /l:ddd
  817. or /d:ddd options.
  818.  
  819. On Import :
  820. FONDIR creates the comm program directory files in the /s:path
  821. subdirectory whenever the /s option is used.  In the abscence of the
  822. /s: option, the comm program directory files are created in the
  823. current subdirectory.  Same for the auxiliary files.
  824.  
  825. On Export :
  826. FONDIR looks for the comm program directory file ( whether the
  827. default or the /x: specified file ) in the /s:path subdirectory
  828. whenever the /s option is used.  In the abscence of the /s: option,
  829. the comm program directory file is searched in the current
  830. subdirectory.  Same for the auxiliary file.
  831.  
  832. For example, suppose you have 2 subdirectories called USER1 and
  833. USER2.  FONDIR.EXE is located in the subdirectory called UTIL, and
  834. the default or current directory is COMM.
  835.  
  836. In order for two users to run the program at the same time, your
  837. would need to code the FONDIR command for each to use the different
  838. subdirectories, as follows :
  839.  
  840. \util\fondir \user1\bbs.lst /o:q /l:214 /d:817 /a:1- /s:\user1
  841. \util\fondir \user2\bbs.lst /o:q /l:214 /d:817 /a:1- /s:\user2
  842.  
  843. The users can share the LDAREA and METRO exchange files located in
  844. the COMM directory ( /s is after the /l and /d options ).  The Qmodem
  845. .fon files will be created in each users separate directory.
  846.  
  847.  
  848.  
  849.  
  850. ╔═══════════════════════════════════════════════════════════════════════╗
  851. ║ 6 -- FONDIR DOS COMMAND SYNTAX EXAMPLES                               ║
  852. ╚═══════════════════════════════════════════════════════════════════════╝
  853.  
  854. >FONDIR bbslist.txt /o:b /s
  855.  
  856.    Import into Boyan from bbslist.txt, using system type for script
  857. name.
  858.  
  859. >FONDIR bbslist.txt /o:+ /b:a
  860.  
  861.    Import into Procomm Plus, make all speeds 19200.
  862.  
  863. >FONDIR bbslist.txt /o:+ /b:a /l:214
  864.  
  865.    Import, local area code is 214.  LDAREA.214 may contain
  866. exchanges in the 214 area which are still long distance to me.
  867.  
  868. >FONDIR bbslist.txt /o:+ /b:a /l:214 /a:1-
  869.  
  870.    As above, long distance prefix is 1-.
  871.  
  872. >FONDIR bbslist.txt /o:+ /b:a /l:214 /a:1- /d:817
  873.  
  874.    As above, a metro area is 817.  METRO.817 may contain exchanges in
  875. the 817 area which are still local calls to me.  Most people will use
  876. the /l, /a, /d options all the time if they live in a long distance
  877. or metro area.
  878.  
  879. >FONDIR c:\new\bbslist.txt /o:+ /m:2
  880.  
  881.    Import into Procomm Plus from bbslist.txt, max speed of my
  882. modem is 2400.
  883.  
  884. >FONDIR bbslist.txt /o:q /k
  885.  
  886.    Import into Qmodem from bbslist.txt, use the date from the list.
  887.  
  888. >FONDIR bbslist.txt /o:g /p:O
  889.    
  890.    Import into GT-Powercomm, default file transfer protocol is 'O'.
  891.  
  892. >FONDIR bbslist.txt /o:p /x
  893.  
  894.    Export from Procomm 2.4 to bbslist.txt.
  895.  
  896. >FONDIR bbslist.txt /o:b /x:boya1
  897.  
  898.    Export from a specified Boyan 5 phone file to bbslist.txt.
  899.  
  900. Yes, you can use this command :
  901.  
  902. FONDIR bbslist.txt /o:+ /b:a /m:a /l:214 /d:817 /a:10777-1- /k /p:Z
  903.  
  904.    The above command Imports from the text file bbslist.txt into
  905. Procomm Plus format.  All modem speeds are set to 19200.  My area
  906. code is 214 and I have a metro area 817.  Both my LDAREA.214 and
  907. METRO.817 files are present. True long distance calls will use the
  908. 10777-1- prefix.  I want to stuff the date from the bbslist.txt file
  909. into Procomm Plus, and I want the default file transfer protocols to
  910. be 'Z' type.
  911.  
  912.  
  913. ┌───────────────────────────────────────────────────────────────────────┐
  914. │ TRANSFORM EXAMPLE.                                                    │
  915. └───────────────────────────────────────────────────────────────────────┘
  916.   
  917.  
  918. FONDIR bbs.txt /o:b /l:214 /a:1- /d:817 /k /x
  919. FONDIR bbs.txt /o:q /l:214 /a:1- /d:817 /k
  920.  
  921.   The above two commands will export from Boyan format, writing
  922. the text file bbs.txt and import that text file into Qmodem format.
  923. The file bbs.txt must exist and contain a Format Specification.
  924.  
  925.  
  926. ┌───────────────────────────────────────────────────────────────────────┐
  927. │ ERROR CHECKING OF INPUT ( SEMANTIC ).                                 │
  928. └───────────────────────────────────────────────────────────────────────┘
  929.   
  930.  
  931. FONDIR pretty much validates everything you enter, and it HAS to be
  932. valid or FONDIR will generate a message, usually telling you ( by
  933. re-displaying your input ) the part which FONDIR did not understand.
  934.  
  935.  
  936. ┌───────────────────────────────────────────────────────────────────────┐
  937. │ ERROR ON INPUT ( LOGICAL ).                                           │
  938. └───────────────────────────────────────────────────────────────────────┘
  939.   
  940.  
  941. FONDIR does not know what protocol letter you need to use, so it
  942. allows you to input any character.  FONDIR will ignore otherwise
  943. valid options which can not be implemented for a particular Comm
  944. Program.
  945.  
  946.  
  947.  
  948.  
  949. ╔═══════════════════════════════════════════════════════════════════════╗
  950. ║ 7 -- BBS LIST FORMAT SPECIFICATION KEYS                               ║
  951. ╚═══════════════════════════════════════════════════════════════════════╝
  952.  
  953. Most any BBS list can be supported.  What FONDIR is looking for in
  954. the text list file is a Format Specification which tells FONDIR where
  955. the information fields are for each entry.
  956.  
  957. YOU MUST SUPPLY THE FORMAT SPECIFICATION, if it is not already in the
  958. BBS List file you are working with.
  959.  
  960. The Format Specification works best with columnar ( readable )
  961. fields, arranged with one list entry per text line.
  962.  
  963. As an example, here is the format of a full featured BBS list.  Note
  964. that the following text lines are longer than 80 characters, so an 80
  965. column display or printer will not allow you to see it as a single
  966. line.  But it IS a single line, and you should obtain a text editor
  967. that supports line lengths greater than 80 characters if you want all
  968. the information available all the time.
  969.  
  970. |n32                              |f4  |i8      |#15          |p4  |c5   |t5   |m8
  971.  
  972. MY BBS Henry Clark                OPUS 124/6119 214-881-2627  2U Z 04/21 23:31 PASSWORD
  973. MY Other BBS Henry Clark          OPUS          214-555-1212  9U Z 04/21 23:42 PASSWORD
  974. Joe's Board                       TBBS          212-999-9999  AU Z 04/21 23:31 PASSWORD
  975. Ed's Mobile BBS                   QUIC 124/120  805-555-5555  9H Z                              
  976.  
  977. The first line is the Format Specification.  The remaining lines are
  978. BBS List entries.  Note that each '|' character is placed directly
  979. above the start of column data in the list entry. Some entries do not
  980. have all available data, that's ok.  Most Comm Programs do not
  981. support all the fields.  That's OK too.
  982.  
  983. Your BBS list file MUST contain a Format Specification.  This
  984. includes the file that you will EXPORT to.  A brand new Export file
  985. will have to contain the one line of Format Specification, as this is
  986. the only place FONDIR will look for it.
  987.  
  988. WARNING :  Inconsistent results occur when the text line length is
  989. less than the format specification position.  Make sure that empty
  990. columns of data are SPACE FILLED out to the end of the format
  991. specification.  FONDIR export does this on export.
  992.  
  993.  
  994. ┌───────────────────────────────────────────────────────────────────────┐
  995. │ FORMAT SPECIFICATION CODING                                           │
  996. └───────────────────────────────────────────────────────────────────────┘
  997.   
  998.  
  999. Each field contains three parts, all of which are required.  They are :
  1000.  
  1001.     Field-separator Code Length
  1002.  
  1003. '|' is the default field separator key.  It appears in the same
  1004. column as the applicable list entry data.  Think of it as a marker
  1005. or position indicator.  You can use any character by selecting the
  1006. /c:  option on the FONDIR command line.
  1007.  
  1008. Code is one of the field codes listed below.
  1009.  
  1010. Length number is a decimal value from 2 to 255.
  1011.  
  1012. The field codes are :
  1013.  
  1014.  n - BBS Name, any ascii characters
  1015.  i - ID or Info, additional description of BBS
  1016.  # - Dial Digits, 0-9, -, etc.
  1017.  p - Protocol Modifier Codes, see protocol codes below.
  1018.  d - Last Call Date, mm/dd/yy
  1019.  t - Last Call Time, hh:mi:ss
  1020.  f - Script File name
  1021.  g - Log File name
  1022.  w - Password
  1023.  e - Emulation type, such as ANSI or VT100
  1024.  c - Call count
  1025.  o - Hours of operation, when the BBS is available
  1026.  h - elapsed hours online
  1027.  m - elapsed minutes online
  1028.  $ - elapsed total hours online
  1029.  r - uploads received count
  1030.  x - downloads transmitted count
  1031.  @ - comm port, first character 0 ( default ), 1 or 2
  1032.  y - city code
  1033.  ( - dialing script
  1034.  
  1035. For example,   |n32
  1036.  
  1037.   means the following :
  1038.  
  1039. the | character is positional, it shows where the column containing
  1040. the BBS name is located.  The n character, specifies that this is the
  1041. BBS name.  The 32 is the total length of the BBS name field.
  1042.  
  1043.  
  1044. ┌───────────────────────────────────────────────────────────────────────┐
  1045. │ FORMAT SPECIFIER STACKING                                             │
  1046. └───────────────────────────────────────────────────────────────────────┘
  1047.   
  1048.  
  1049. If a column of BBS list data is to be used as more than one field,
  1050. you may 'stack' the specifiers behind a single | character.  For
  1051. example, suppose you want a script file ( |f option ) to be the
  1052. first four characters of the BBS name ( |n option ).  Stack the
  1053. format specifiers like this :
  1054.  
  1055. |n32f4                                 |#15          |p4  |c5   |t5   |m8
  1056.  
  1057. OPUS MY BBS Henry Clark                214-881-2627  2U Z 04/21 23:31 PASSWORD
  1058. OPUS MY Other BBS Henry Clark          214-555-1212  9U Z 04/21 23:42 PASSWORD
  1059. TBBS Joe's Board                       212-999-9999  AU Z 04/21 23:31 PASSWORD
  1060. QUIC Ed's Mobile BBS                   805-555-5555  9H Z
  1061.  
  1062.  
  1063. WARNING : Do not use a width longer than the actual width of the
  1064. column of data.  This is important for both import and export.  A
  1065. larger width specification will result in 'spill' from the next
  1066. column of data into this column, and will cause extra ( usually
  1067. unwanted ) data to be placed in your Comm Program directory file.
  1068.  
  1069.  
  1070. ┌───────────────────────────────────────────────────────────────────────┐
  1071. │ FORMAT FIRST WORD LENGTH                                              │
  1072. └───────────────────────────────────────────────────────────────────────┘
  1073.  
  1074.  
  1075. Some of the Comm Program directory fields specify file names.  These
  1076. include :
  1077.  
  1078.    |f - Script File
  1079.    |g - Log File or Macro File
  1080.    |( - Dialing Script File or Keyboard Map File
  1081.  
  1082. It is not useful to have a file name with a space character it.  For
  1083. example, |f8 on the field "OPUS MY BBS", would normally generate a
  1084. script file named "OPUS MY ", which is not valid file name.
  1085.  
  1086. To avoid these problems, FONDIR automatically translates only the
  1087. first whole word of the BBS list field for the above three format
  1088. keys.  The field length in the format key becomes a maximum length,
  1089. and not a specific length.
  1090.  
  1091. "OPUS MY BBS" using |f8 translates to "OPUS", the first word, and a
  1092. useful script file name.  "PCBOARD Joe's BBS" using |f4 translates to
  1093. "PCBO", since the maximum length is 4.
  1094.  
  1095.  
  1096. ┌───────────────────────────────────────────────────────────────────────┐
  1097. │ FORMAT HEADER SPECIFICATION                                           │
  1098. └───────────────────────────────────────────────────────────────────────┘
  1099.   
  1100.  
  1101.  l - long distance area code
  1102.  
  1103. During processing of the BBS list file, FONDIR will look for the
  1104. |l characters in the first column of each line.  If this is found,
  1105. FONDIR looks further in the line for an Area Code of three digits.
  1106. If the area code is found, FONDIR assumes that this area code applies
  1107. to all subsequent phone number entries until a new |l is found.
  1108.  
  1109. For example :
  1110.  
  1111. |d5   |n20                 |#12          |p2 
  1112.  
  1113. 03/24 MY BBS               214-881-2627  #Z
  1114. 03/24 MY BBS               214-881-2627  #Z
  1115. 03/24 MY BBS               214-881-2627  #Z
  1116.  
  1117. could be listed as :
  1118.  
  1119. |d5   |n20                 |#12      |p2 
  1120.  
  1121. |L Dallas 214
  1122. 03/24 MY BBS               881-2627  #Z
  1123. 03/24 MY BBS               881-2627  #Z
  1124. 03/24 MY BBS               881-2627  #Z
  1125.  
  1126. This encoding format is useful when the BBS list entries are very
  1127. wide.  FONDIR does not support this convention on export to the BBS
  1128. list file.
  1129.  
  1130.  
  1131. ┌───────────────────────────────────────────────────────────────────────┐
  1132. │ COMM PROGRAM FIELD SUPPORT                                            │
  1133. └───────────────────────────────────────────────────────────────────────┘
  1134.   
  1135.  
  1136. The following list shows which format key fields are used by each of
  1137. the supported programs.  You may specify a field in your BBS list,
  1138. that is not supported by your Comm Program.
  1139.  
  1140. Boyan 5.0
  1141.   name                - |n
  1142.   phone               - |#
  1143.   script              - |f
  1144.   speed               - |p
  1145.   parity              - |p
  1146.   file protocol       - |p
  1147.   terminal emulation  - |e
  1148.   last date called    - |d and /k option
  1149. Procomm 2.4.3
  1150.   name                - |n
  1151.   phone               - |#
  1152.   script              - |f
  1153.   speed               - |p
  1154.   parity              - |p
  1155.   data bits           - |p
  1156. Procomm Plus 1.1
  1157.   name                - |n
  1158.   phone               - |#
  1159.   script              - |f
  1160.   speed               - |p
  1161.   parity              - |p
  1162.   data bits           - |p
  1163.   file protocol       - |p
  1164.   terminal emulation  - |e
  1165.   last date called    - |d and /k option
  1166.   call count          - |c
  1167. Procomm Plus 2.0
  1168.   name                - |n
  1169.   phone               - |#
  1170.   script              - |f
  1171.   speed               - |p
  1172.   parity              - |p
  1173.   data bits           - |p
  1174.   file protocol       - |p
  1175.   terminal emulation  - |e
  1176.   last date called    - |d and /k option
  1177.   call count          - |c
  1178.   password            - |w
  1179.   macro file          - |g
  1180.   keyboard file       - |(
  1181.   comm port           - |@
  1182. Qmodem 4.3
  1183.   name                - |n
  1184.   phone               - |#
  1185.   script              - |f
  1186.   speed               - |p
  1187.   parity              - |p
  1188.   data bits           - |p
  1189.   file protocol       - |p
  1190.   last date called    - |d and /k option
  1191.   password            - |w
  1192.   call count          - |c
  1193. GT-Powercomm 16.00
  1194.   name                - |n
  1195.   phone               - |#
  1196.   script              - |f
  1197.   speed               - |p
  1198.   parity              - |p
  1199.   data bits           - |p
  1200.   file protocol       - |p
  1201.   terminal emulation  - |e
  1202.   last date called    - |d and /k option
  1203.   last time called    - |t and /k option
  1204.   password            - |w
  1205.   call count          - |c
  1206.   hours of operation  - |o
  1207.   elapsed hours online  - |h
  1208.   elapsed minutes online- |m
  1209.   uploads received      - |r
  1210.   downloads transmitted - |x
  1211.   comment 1             - |i
  1212.   city code             - |y
  1213.   dialing script        - |(
  1214. Telix 3.11
  1215.   name                - |n
  1216.   phone               - |#
  1217.   script              - |f
  1218.   speed               - |p
  1219.   parity              - |p
  1220.   data bits           - |p
  1221.   file protocol       - |p
  1222.   terminal emulation  - |e
  1223.   last date called    - |d and /k option
  1224.   password            - |w
  1225.   call count          - |c
  1226. Pibterm 4.1
  1227.   name                - |n
  1228.   phone               - |#
  1229.   script              - |f
  1230.   speed               - |p
  1231.   parity              - |p
  1232.   data bits           - |p
  1233.   file protocol       - |p
  1234.   terminal emulation  - |e
  1235.   last date called    - |d and /k option
  1236.   last time called    - |t and /k option
  1237. Telemate 2.0
  1238.   name                - |n
  1239.   phone               - |#
  1240.   script              - |f
  1241.   logfile             - |g
  1242.   comm port           - |@
  1243.   speed               - |p
  1244.   parity              - |p
  1245.   data bits           - |p
  1246.   file protocol       - |p
  1247.   terminal emulation  - |e
  1248.   last date called    - |d and /k option
  1249.   password            - |w
  1250.   call count          - |c
  1251.   auxiliary MEMO file - |i
  1252. PC-Talk4 1.39
  1253.   name                - |n
  1254.   phone               - |#
  1255.   speed               - |p
  1256.   parity              - |p
  1257.   data bits           - |p
  1258. Rcomm 2.1
  1259.   name                - |n
  1260.   phone               - |#
  1261.   speed               - |p
  1262.   parity              - |p
  1263.   data bits           - |p
  1264. K9-Express 8.6
  1265.   name                - |n
  1266.   phone               - |#
  1267.   script              - |f
  1268.   speed               - |p
  1269.   parity              - |p
  1270.   data bits           - |p
  1271.   file protocol       - |p
  1272.   last date called    - |d and /k option
  1273.   last time called    - |t and /k option
  1274. Mirror 3 1.01
  1275.   name                - |n
  1276.   phone               - |#
  1277.   script              - |f
  1278.   speed               - |p
  1279.   parity              - |p
  1280.   data bits           - |p
  1281.   terminal emulation  - |e
  1282.   last date called    - |d and /k option
  1283.   last time called    - |t and /k option
  1284.   call count          - |c
  1285.   elapsed time online - |h
  1286.   total time online   - |$
  1287.   comment 1           - |i
  1288. PC Anywhere 3.11
  1289.   name                - |n
  1290.   phone               - |#
  1291.   logfile             - |g   ( simply Y or N )
  1292. Carbon Copy Plus 4.01
  1293.   name                - |n
  1294.   phone               - |#
  1295.   password            - |w
  1296. A Dialer 2.0
  1297.   name                - |n
  1298.   phone               - |#
  1299.   script              - |f
  1300.   password            - |w
  1301.   last date called    - |d and /k option
  1302.   city code           - |y
  1303. Commo 5.0
  1304.   name                - |n
  1305.   phone               - |#
  1306.   macro               - |f
  1307.   password            - |w
  1308.   last date called    - |d and /k option
  1309. Unicom 3.0
  1310.   name                - |n
  1311.   phone               - |#
  1312.   speed               - |p
  1313.   script              - |f
  1314.   parity              - |p
  1315.   data bits           - |p
  1316.   file protocol       - |p
  1317.   terminal emulation  - |e
  1318.   password            - |w
  1319.   call count          - |c
  1320.   
  1321.   
  1322.  
  1323.  
  1324. ╔═══════════════════════════════════════════════════════════════════════╗
  1325. ║ 8 -- BBS LIST CONTENTS                                                ║
  1326. ╚═══════════════════════════════════════════════════════════════════════╝
  1327.  
  1328. ┌───────────────────────────────────────────────────────────────────────┐
  1329. │ PROTOCOL FIELD FORMAT                                                 │
  1330. └───────────────────────────────────────────────────────────────────────┘
  1331.   
  1332.  
  1333. The protocol field is specially coded, and contains several
  1334. characters of information, including modem speed, parity, file
  1335. transfer protocol and modem type.
  1336.  
  1337. Some examples :
  1338.  
  1339. |p5
  1340. 2 EX
  1341.  
  1342. The above specifies a 2400 bps, Even parity connection using Xmodem
  1343. for a file transfer protocol.
  1344.  
  1345. |p5
  1346. BZ
  1347.  
  1348. The above specifies 38400 bps and Zmodem protocol.
  1349.  
  1350.  
  1351. The protocol modifier codes are described in the following sections.
  1352. Support for protocol modifiers will be based on these lists.
  1353. Trademarks and Copyrights exists for several of the names included below.
  1354.  
  1355.  
  1356. ┌───────────────────────────────────────────────────────────────────────┐
  1357. │ THE BPS MODEM RATE.                                                   │
  1358. └───────────────────────────────────────────────────────────────────────┘
  1359.   
  1360.  
  1361. ! or 3       - 300 bps
  1362. @ or 1       - 1200 bps
  1363. # or 2       - 2400 bps  ( the default )
  1364. 4            - 4800 bps
  1365. ^ or 9       - 9600 bps
  1366. a or A       - 19200 bps
  1367. 8 or b or B  - 38400 bps
  1368. c or C       - 57600 bps
  1369. d or D       - 115200 bps
  1370.  
  1371. ┌───────────────────────────────────────────────────────────────────────┐
  1372. │ MODEM TYPE                                                            │
  1373. └───────────────────────────────────────────────────────────────────────┘
  1374.   
  1375.  
  1376. This field is reserved but presently not used by any Comm Program.
  1377.  
  1378. U  - U.S. Robotics (T) modem
  1379. H  - Hayes (T) modem
  1380. F  - Fastcomm (T) modem
  1381. T  - Trailblazer (T) modem
  1382. V  - any V.32 modem
  1383.  
  1384. ┌───────────────────────────────────────────────────────────────────────┐
  1385. │ PARITY INDICATOR.                                                     │
  1386. └───────────────────────────────────────────────────────────────────────┘
  1387.   
  1388.  
  1389. e or E - Even parity
  1390.  
  1391. ┌───────────────────────────────────────────────────────────────────────┐
  1392. │ FILE TRANSFER PROTOCOL TYPE.                                          │
  1393. └───────────────────────────────────────────────────────────────────────┘
  1394.   
  1395.  
  1396. The following are only a few of the many available.
  1397.  
  1398. Z - Zmodem
  1399. X - Xmodem
  1400. Y - Ymodem
  1401. K - Kermit
  1402. I - Imodem
  1403. G - Ymodem-G
  1404. T - Telink
  1405. S - CLink
  1406. 7 - Modem 7
  1407.  
  1408. ┌───────────────────────────────────────────────────────────────────────┐
  1409. │ TERMINAL EMULATOR MODE CODES                                          │
  1410. └───────────────────────────────────────────────────────────────────────┘
  1411.   
  1412.  
  1413. The following are the supported terminal emulator codes.
  1414.  
  1415. TT   - TTY
  1416. AN   - ANSI
  1417. VT   - VT100
  1418. TV   - Televideo
  1419. HE   - Heath
  1420. AD   - AD
  1421. 31   - Model 31
  1422. 32   - 3270
  1423. WY   - Wyse
  1424.  
  1425.  
  1426. Register if you want custom BBS list translations.
  1427.  
  1428.  
  1429. ┌───────────────────────────────────────────────────────────────────────┐
  1430. │ Examples of BBS Lists                                                 │
  1431. └───────────────────────────────────────────────────────────────────────┘
  1432.   
  1433.  
  1434. A few BBS list Format Specifications are presented for examples. 
  1435. Many of these are longer than 80 characters.
  1436.  
  1437. Darwin National BBS List :
  1438. |#12                                         |f1  |p2     |n20
  1439.  
  1440. Fido Nodelist ( use COMCOL /m:15 /c:; to convert to vertical column format ) :
  1441.                |n15                                               |#15             |p1
  1442.  
  1443. XLATLIST Text Output of Nodelist :
  1444.                 |n20                 |#14                                  |p1
  1445.  
  1446. Carr/Farmer Dallas/Ft. Worth BBS List :
  1447. |n29f8                        |#8      |P9       |I24                     |d5
  1448. |L area code header
  1449.  
  1450.  
  1451.  
  1452. ╔═══════════════════════════════════════════════════════════════════════╗
  1453. ║ 9 -- PROGRAM SWITCHES AND DEFAULTS                                    ║
  1454. ╚═══════════════════════════════════════════════════════════════════════╝
  1455.  
  1456. The default protocol is 'Z', Zmodem.
  1457.  
  1458. The default bps rate is 2400 bps (2).
  1459.  
  1460. The default maximum rate is 38400 (b).
  1461.  
  1462. The default I/O port number is 0 ( not COM1, Telemate only ).
  1463.  
  1464. The default Format Specification Field Separator key character is
  1465. '|'.
  1466.  
  1467. The default last date called is blank ( today's date, Qmodem only ).
  1468.  
  1469. The maximum line length of a BBS text file is 255 characters.
  1470.  
  1471.  
  1472. ┌───────────────────────────────────────────────────────────────────────┐
  1473. │ Comm Program Type Codes                                               │
  1474. └───────────────────────────────────────────────────────────────────────┘
  1475.   
  1476. Here are the valid program type codes used in the /o:   parameter.
  1477.  
  1478. 'B'     Boyan 5.0
  1479. 'P'     Procomm 2.4.3
  1480. '+'     Procomm Plus 1.1
  1481. '2'     Procomm Plus 2.0
  1482. 'Q'     Qmodem 4.3
  1483. 'G'     GT-Powercomm 16.00
  1484. 'T'     Telix 3.11
  1485. 'I'     Pibterm 4.1
  1486. 'M'     Telemate 2.0
  1487. 'C'     PC-Talk4 1.39
  1488. 'R'     Rcomm 2.1
  1489. 'K'     K9 Express 8.6
  1490. 'O'     Mirror 3 1.01
  1491. 'A'     PC Anywhere 3.11
  1492. 'Y'     Carbon Copy Plus 4.01
  1493. 'D'     A Dialer 2.0
  1494. 'F'     Commo 5.0
  1495. 'U'     Unicom 3.0
  1496.  
  1497. Upper or lower case letters are acceptable.  As you can see, I'm
  1498. running out of matching letters <grin>.
  1499.  
  1500. If you don't use something, you will see an error message.  The Comm
  1501. Program type field is REQUIRED.  You can use an upper or lower case
  1502. letter to specify your Comm Program.
  1503.  
  1504.  
  1505.  
  1506. ┌───────────────────────────────────────────────────────────────────────┐
  1507. │ Speed Code Parameters                                                 │
  1508. └───────────────────────────────────────────────────────────────────────┘
  1509.  
  1510.  
  1511. The valid speed codes for use with the /m: amd /b: parameters are :
  1512.  
  1513. 3       - 300 bps
  1514. 1       - 1200 bps
  1515. 2       - 2400 bps  ( the default )
  1516. 4       - 4800 bps
  1517. 9       - 9600 bps
  1518. A       - 19200 bps
  1519. B       - 38400 bps
  1520. C       - 57600 bps
  1521. D       - 115200 bps  ( not currently supported )
  1522.  
  1523. Upper and lower case letters are acceptable.
  1524.  
  1525.  
  1526. ┌───────────────────────────────────────────────────────────────────────┐
  1527. │ Warnings and Other Notes                                              │
  1528. └───────────────────────────────────────────────────────────────────────┘
  1529.   
  1530.  
  1531. GT 16.00 modifies the phone directory header record after every
  1532. use of the program. FONDIR sets the phone directory header to the same
  1533. values generated by use of the GT_UTIL program.
  1534.  
  1535.  
  1536. ╔═══════════════════════════════════════════════════════════════════════╗
  1537. ║ 10 -- REGISTER TO GET UPDATES                                         ║
  1538. ╚═══════════════════════════════════════════════════════════════════════╝
  1539.  
  1540. Print out this following page. Write a check. Address an envelope.
  1541. Mail it.  You will feel really good when you get my response.
  1542.  
  1543.  
  1544.  
  1545. ╔═══════════════════════════════════════════════════════════════════════╗
  1546.  
  1547.   FONDIR Phone List Translator Utility Registration Form and
  1548.   Payment Invoice #910701 for Version 5.7
  1549.  
  1550.   
  1551.   Name    ───────────────────────────────────────
  1552.   
  1553.   Address ───────────────────────────────────────
  1554.   
  1555.           ───────────────────────────────────────
  1556.   
  1557.           ───────────────────────────────────────
  1558.   
  1559.   Phone   ───────────────────────────────────────
  1560.   
  1561.   
  1562.   Version ────────────────  Date Received ────────────────
  1563.   
  1564.   
  1565.   Check one :
  1566.   
  1567.   (  )  Enclosed is U.S. ──────────── Dollars for ─────────── copies
  1568.   
  1569.         at U.S. 20 Dollars each.
  1570.   
  1571.   (  )  Enclosed is U.S. ──────────── Dollars for ─────────── copies
  1572.   
  1573.         of customized versions at U.S. 40 Dollars each.
  1574.   
  1575.         Enter customization parameters : ───────────────────────────────
  1576.   
  1577.         ────────────────────────────────────────────────────────────────
  1578.   
  1579.         ────────────────────────────────────────────────────────────────
  1580.   
  1581.   (  )  Enclosed is U.S.  400        Dollars for  20 or more users
  1582.   
  1583.         on a site license ( make your own copies, documents ).
  1584.   
  1585.   Send this form with check or money order,
  1586.   payable to Hershel Enterprises, Inc. to :
  1587.   
  1588.     Software Mechanics, FONDIR
  1589.     P.O. Box 832052
  1590.     Richardson, TX 75083-2052
  1591.     U.S.A.
  1592.   
  1593. ╚═══════════════════════════════════════════════════════════════════════╝
  1594.  
  1595.  
  1596.  
  1597. ╔═══════════════════════════════════════════════════════════════════════╗
  1598. ║ 11 -- LICENSE AGREEMENT                                               ║
  1599. ╚═══════════════════════════════════════════════════════════════════════╝
  1600.  
  1601. The SOFTWARE is FONDIR, the Phone Directory Translate Utility,
  1602. Copyright (C) 1988-1991 Henry C. Clark, Hershel Enterprises, Inc.
  1603.  
  1604.   By using or distributing, or allowing to be distributed the
  1605. SOFTWARE, you are agreeing to be bound by the terms of this
  1606. agreement.
  1607.  
  1608.   IF you do not agree to the terms of this agreement, promptly
  1609. destroy any and all copies of the SOFTWARE that you may have.
  1610.  
  1611. ┌───────────────────────────────────────────────────────────────────────┐
  1612. │ The Terms of this Agreement :                                         │
  1613. └───────────────────────────────────────────────────────────────────────┘
  1614.  
  1615. 1
  1616.    You may NOT accept money, or otherwise charge a fee for the
  1617. SOFTWARE because you transfer a copy of the SOFTWARE to another party. 
  1618. You may NOT alter the SOFTWARE files, nor distribute the files using
  1619. a file name other than that name which you received, except for the
  1620. extension as relates to compression techniques.  The SOFTWARE
  1621. may be compressed using different techniques, only if all the
  1622. component files of the original package are included.  You may NOT
  1623. decompile, reverse engineer or include the SOFTWARE in another work,
  1624. without written permission from Hershel Enterprises, Inc. dba
  1625. Software Mechanics.
  1626.  
  1627. 2
  1628.    You may NOT accept money, or otherwise charge a fee for ANY usage
  1629. or operation of the SOFTWARE,  without written permission from
  1630. Hershel Enterprises, Inc. dba Software Mechanics.
  1631.  
  1632. 3
  1633.    You may NOT accept money, or otherwise charge a fee for ANY medium
  1634. upon which the SOFTWARE is transferred, including but not limited to
  1635. modem carrier, diskettes, CD-ROM, magnetic tape, etc. without written
  1636. permission from Hershel Enterprises, Inc. dba Software Mechanics.
  1637.  
  1638.    We invite your requests to include our SOFTWARE in your
  1639. compilations.
  1640.  
  1641. 4
  1642.    You may NOT use or distribute the Software in ANY manner for or by
  1643. commercial or governmental entities without first correctly filling
  1644. out and sending the registration agreement and payment.
  1645.  
  1646.    US Government restricted rights are set forth in subparagraph
  1647. (c)(1)(ii) of the Rights in Technical Data and Computer Software
  1648. clause at DFARS 252.227-7013(Oct. 1988) and FAR 52.227-19(June 1987). 
  1649. Contractor is Hershel Enterprises, Inc.
  1650.  
  1651. 5
  1652.    You accept and understand that NO warranty is expressed or implied.
  1653. The person using the SOFTWARE bears all risk as to the quality and
  1654. performance of the SOFTWARE.   In no event shall Hershel Enterprises'
  1655. liability for any damages ever exceed the price paid to Hershel for
  1656. the license to use the SOFTWARE, regardless of the form of the claim,
  1657. even if Hershel Enterprises has been notified of such a possibility.
  1658.  
  1659. 6
  1660.    You MAY distribute freely the Software within the above license
  1661. restrictions.  You may use the Software on a trial basis, and you are
  1662. required to pay for the Software if you use it on a regular basis.
  1663.  
  1664.  
  1665. ┌───────────────────────────────────────────────────────────────────────┐
  1666. │ Note from the Author :                                                │
  1667. └───────────────────────────────────────────────────────────────────────┘
  1668.   
  1669.  
  1670. As the task of keeping up with the latest Comm Programs increases,
  1671. take time to reflect on the effort expended to produce this program.
  1672.  
  1673. When you run this program, watch how fast it finishes.  This program
  1674. is not the type you run everyday, but it will save you countless
  1675. hours of manual data entry, and open up the door to the modem world
  1676. for you.
  1677.  
  1678. When you fill out the registration slip, write a check and use an
  1679. envelope, you ensure that improvements are made before you need
  1680. them.  My compilers, software tools, PCs, modems and especially
  1681. my time are not free.
  1682.  
  1683. Shareware is not a type of software, it is a form of distribution.
  1684. You get to make sure this program works for you before you pay for
  1685. it.
  1686.