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