home *** CD-ROM | disk | FTP | other *** search
/ Millennium Time Capsule / AC2000.BIN / disks / ac1_disk / stdcodes.14 / stdcodes.txt < prev    next >
Encoding:
Text File  |  1996-03-23  |  9.5 KB  |  234 lines
  1.                                STDCODES v1.4
  2.                             STD Codes Index CPX
  3.                             by Linnhe Computing
  4.                      Copyright (c) 1996 Mark S Baines
  5.                             All Rights Reserved
  6.  
  7. Mark S Baines asserts the legal and moral right to be identified as the 
  8. owner of this work.
  9.  
  10.  
  11. STDCODES.CPX IS A FREEWARE PROGRAM
  12. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  13. STDCODES.CPX is protected under UK and international copyright law, and is 
  14. NOT public domain software. Mark S Baines owns the copyright to this and 
  15. accompanying programs and the document files.
  16.  
  17. You are hereby granted a licence to use these copies. You are not allowed to 
  18. alter the programs in any way, to do so is an infringement of my rights. 
  19. FREEWARE is NOT Public Domain!
  20.  
  21.  
  22. STDCODES.CPX - INVENTORY
  23. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  24. When distributed through any means whatsoever, this total package must not 
  25. be separated.
  26.  
  27. STDCODES.CPX  The CPX file
  28. STDCODES.LST  The STD Codes data file
  29. STDCODES.CDX  The index file for the first field - the STD Codes
  30. STDCODES.NDX  The index file for the second field - the Exchange Name
  31. STDCODES.TXT  The documentation in standard ASCII text file
  32. STDINDEX.TOS  The data file checking and index files creation program
  33.  
  34.  
  35. STDCODES.CPX - WHAT IS IT?
  36. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  37. STD Codes Index is a simple CPX program for the Atari XCONTROL panel 
  38. accessory. It allows the user to find which Exchange or Use corresponds to a 
  39. particular STD Code or visa versa. Other details are also shown.
  40.  
  41.  
  42. STDCODES.CPX - USING IT
  43. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  44. Insert the STDCODES.CPX, STDCODES.LST, STDCODES.CDX and STDCODES.NDX files 
  45. into your normal CPX folder. Either re-boot or select the XCONTROL panel 
  46. accessory and select Options/Setup menu item and click on the right-hand of 
  47. the two large icons which reloads all the CPX files. STDCODES.CPX should now 
  48. be available.
  49.  
  50. The STDINDEX.TOS file may be kept elsewhere on your disk and is only needed 
  51. if you alter the STDCODES.LST data file in any way.
  52.  
  53. After double-clicking on the STDCODES.CPX entry, enter an STD Code in the 
  54. relevant box and click on Find or press Return.
  55.  
  56. Alternatively, enter an Exchange Name (such as "Leicester") or Use (such as 
  57. "Freephone") making sure that the STD Code field is empty. Then click on 
  58. Find or press Return. Precedence is given to the STD Code field so that if 
  59. both fields contain data, then the STD Code is searched for.
  60.  
  61. If the More... button is not disabled, then there are additional entries for 
  62. that particular search, such as more STD Codes for the Exchange Name 
  63. entered. Click on this button to see these further entries. When there 
  64. aren't any more details, the More... button will be disabled.
  65.  
  66. Various details are shown:
  67.  
  68.     STD Code
  69.     This is displayed if the user enters an Exchange Name to search for.
  70.  
  71.     Exchange/Use
  72.     For the most part, Exchange Names are shown here, but some STD Codes
  73.     apply to services or uses, such as "Freephone", "Premium Rate Service"
  74.     or "Special Tariff". It is possible to find multiple entries for certain
  75.     Exchange Names or services.
  76.  
  77.     Operator
  78.     Most STD Codes apply to all telecommunications operators, but some are
  79.     more specific and this is shown.
  80.  
  81.     Notes
  82.     Details are given as to other STD Codes which are related to the
  83.     information already shown. It might be worth looking at these numbers.
  84.     Also, the length of the STD Code is shown in some cases. If this is
  85.     shorter than the STD Code displayed in the STD Code field, then the
  86.     excess digits are part of the subscriber's telephone number.
  87.  
  88. The CPX will catch most input errors and missing index and data files and 
  89. inform the user with an alert. These files are expected to be in the 
  90. system's CPX folder as specified in the XCONTROL panel's CONTROL.INF file. 
  91. If this file isn't found then a default path is looked for which is the CPX 
  92. folder on the boot drive. If this isn't found then the CPX won't work.
  93.  
  94. The Info button displays some brief Information about the program. The 
  95. Cancel button closes the CPX.
  96.  
  97.  
  98. STDCODES.CPX - STDCODES.LST data file
  99. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  100. This data file is a colon delimited variable-length fields ASCII file 
  101. containing one entry per line. Each entry consists of six fields separated 
  102. by a colon ':'. The maximum line length is 172 characters. Empty fields must 
  103. contain a space character including the last field. Each line ends in the 
  104. usual carriage return and line feed characters.
  105.  
  106. The CPX program allows for up to 1100 entries. Each field has a maximum 
  107. length. Overlong fields will be displayed unpredictably in the CPX and may 
  108. cause a crash. However, if the data file is edited without the index files 
  109. being recreated then the CPX will almost certainly catch this and prevent 
  110. any crashes or inaccurate data being displayed.
  111.  
  112.     Field                Length
  113.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  114.     Field 1 STD Code       8
  115.     Field 2 Exchange 1    20
  116.     Field 3 Exchange 2    30
  117.     Field 4 User 1        23
  118.     Field 5 User 2        30
  119.     Field 6 Notes 1       25
  120.     Field 7 Notes 2       30
  121.     Total                166
  122.     Field delimiters       6
  123.     Maximum line length  172
  124.  
  125. These maximum lengths are a result of the limited space in the CPX window 
  126. display.
  127.  
  128. The user may edit this file to suit their own needs, for instance, in the 
  129. event of some STD Codes changing. However, the user must remain within the 
  130. limitations as already outlined. Failure to do so will be unpredictable. Use 
  131. an editor to change the file or a word processor in ASCII or non-word 
  132. processor or program mode.
  133.  
  134. If place names that contain hyphens are entered (such as "Weston-Super-
  135. Mare"), leave out the hyphen and insert a space instead (such as "Weston 
  136. Super Mare"). The STDINDEX and STDCODE.CPX programs are writen to convert 
  137. hyphens to spaces so that the various ways of spelling such names are 
  138. successfully acted upon without recourse to duplicate lines (and hence 
  139. duplicate STD codes) in the data file. Also note that the character case 
  140. doesn't matter, so, "Clacton on sea", "Clacton on Sea" and "Clacton On Sea" 
  141. are treated the same.
  142.  
  143. If the STDCODES.LST data file is changed IN ANY WAY then the two index files 
  144. MUST be recreated. A program is supplied for this called STDINDEX.TOS.
  145.  
  146. Whilst every effort has been made to ensure that the information given in 
  147. the STDCODES.LST data file is accurate, no legal responsibility is accepted 
  148. for any errors, omissions or statements in that information.
  149.  
  150. The bulk of the information as supplied in this file is Crown Copyright and 
  151. is reproduced with due acknowledgement of the source of the information. 
  152. There have been substantial additions and editing by myself to increase the 
  153. usefulness of the data. No responsibility is accepted for any errors which 
  154. may have been introduced as a result of any such editing.
  155.  
  156.  
  157. STDCODES.CPX - STDINDEX.TOS
  158. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  159. This program is designed to be used to regenerate the two index files needed 
  160. by STDCODES.CPX. A separate index is created for each of the first two 
  161. fields - STDCODES.CDX for the Code (1st) field and STDCODES.NDX for the 
  162. Exchange Name (2nd) field.
  163.  
  164. A check is also made on the STDCODES.LST file to see if it complies with the 
  165. limitations outlined above. If this check fails, then the index files won't 
  166. be created. Details of the failures are provided so that the user can re-
  167. edit the data file accordingly.
  168.  
  169. Please note that if the STDCODES.LST is edited, even the addition or 
  170. subtraction of one character, then the index files won't be accurate for any 
  171. data after that edit. YOU MUST RECREATE THE INDEX FILES WHENEVER THE 
  172. STDCODES.LST FILE IS EDITED, HOWEVER SMALL.
  173.  
  174.  
  175. STDCODES.CPX - VERSION HISTORY
  176. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  177. V1.0
  178.     February 1996
  179.     The first release version.
  180. V1.1
  181.     February 1996
  182.     Not released.
  183.     Hyphens now allowed in Exchange Name field.
  184.     All text and output fields are better aligned and look neater.
  185. V1.2
  186.     February 1996
  187.     Input can be in any case so that various spellings of place names,
  188.     such as, "Clacton on Sea" or "Clacton On sea" or even "clacton on
  189.     sea" are now considered equivalent.
  190.     Hyphens are converted to spaces by the CPX so duplicate entries in
  191.     the data file for, say, "Clacton-on-sea" and "Clacton on sea" are
  192.     not necessary. Use hyphens or spaces in your input,it doesn't
  193.     matter.
  194. V1.3
  195.     March 1996
  196.     A search on two empty fields is now caught with an alert.
  197.     Some minor corrections to the data file.
  198. V1.4
  199.     March 1996
  200.     This release version.
  201.     If a search string is not found all the output fields have any
  202.     data already displayed in them removed so as not to cause any
  203.     confusion.
  204.  
  205.  
  206. STDCODES.CPX - THE ACKNOWLEDGEMENTS
  207. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  208. Thanks to Jon Ellis for his CPX articles in his excellent Programmers' 
  209. Forum series in ST Applications magazine.
  210.  
  211. Thanks to Kevin O'Donovan for helping with some file search algorithms 
  212. and his patience during this learning period.
  213.  
  214. Also Bob Culverston for finding a decent data file for me to work with 
  215. and thus saving on masses of typing!
  216.  
  217.  
  218. Slàinte mhath
  219. Mark S Baines
  220. Linnhe Computing
  221. Linnhe, Shore Street
  222. Inver, by Tain
  223. Ross-shire
  224. IV20 1SF
  225.  
  226. 22nd March 1996
  227.  
  228. E-mail:
  229. Internet:  msbaines@cix.compulink.co.uk
  230. FidoNet:   2:254/105.10@fidonet.org
  231. NeST:      90:102/107.0@nest.ftn
  232. TurboNet:  100:101/12.10@turbonet.ftn
  233. AtariNet   51:502/0.10@atarinet.ftn
  234.