STDCODES v1.4 STD Codes Index CPX by Linnhe Computing Copyright (c) 1996 Mark S Baines All Rights Reserved Mark S Baines asserts the legal and moral right to be identified as the owner of this work. STDCODES.CPX IS A FREEWARE PROGRAM ˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙ STDCODES.CPX is protected under UK and international copyright law, and is NOT public domain software. Mark S Baines owns the copyright to this and accompanying programs and the document files. You are hereby granted a licence to use these copies. You are not allowed to alter the programs in any way, to do so is an infringement of my rights. FREEWARE is NOT Public Domain! STDCODES.CPX - INVENTORY ˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙ When distributed through any means whatsoever, this total package must not be separated. STDCODES.CPX The CPX file STDCODES.LST The STD Codes data file STDCODES.CDX The index file for the first field - the STD Codes STDCODES.NDX The index file for the second field - the Exchange Name STDCODES.TXT The documentation in standard ASCII text file STDINDEX.TOS The data file checking and index files creation program STDCODES.CPX - WHAT IS IT? ˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙ STD Codes Index is a simple CPX program for the Atari XCONTROL panel accessory. It allows the user to find which Exchange or Use corresponds to a particular STD Code or visa versa. Other details are also shown. STDCODES.CPX - USING IT ˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙ Insert the STDCODES.CPX, STDCODES.LST, STDCODES.CDX and STDCODES.NDX files into your normal CPX folder. Either re-boot or select the XCONTROL panel accessory and select Options/Setup menu item and click on the right-hand of the two large icons which reloads all the CPX files. STDCODES.CPX should now be available. The STDINDEX.TOS file may be kept elsewhere on your disk and is only needed if you alter the STDCODES.LST data file in any way. After double-clicking on the STDCODES.CPX entry, enter an STD Code in the relevant box and click on Find or press Return. Alternatively, enter an Exchange Name (such as "Leicester") or Use (such as "Freephone") making sure that the STD Code field is empty. Then click on Find or press Return. Precedence is given to the STD Code field so that if both fields contain data, then the STD Code is searched for. If the More... button is not disabled, then there are additional entries for that particular search, such as more STD Codes for the Exchange Name entered. Click on this button to see these further entries. When there aren't any more details, the More... button will be disabled. Various details are shown: STD Code This is displayed if the user enters an Exchange Name to search for. Exchange/Use For the most part, Exchange Names are shown here, but some STD Codes apply to services or uses, such as "Freephone", "Premium Rate Service" or "Special Tariff". It is possible to find multiple entries for certain Exchange Names or services. Operator Most STD Codes apply to all telecommunications operators, but some are more specific and this is shown. Notes Details are given as to other STD Codes which are related to the information already shown. It might be worth looking at these numbers. Also, the length of the STD Code is shown in some cases. If this is shorter than the STD Code displayed in the STD Code field, then the excess digits are part of the subscriber's telephone number. The CPX will catch most input errors and missing index and data files and inform the user with an alert. These files are expected to be in the system's CPX folder as specified in the XCONTROL panel's CONTROL.INF file. If this file isn't found then a default path is looked for which is the CPX folder on the boot drive. If this isn't found then the CPX won't work. The Info button displays some brief Information about the program. The Cancel button closes the CPX. STDCODES.CPX - STDCODES.LST data file ˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙ This data file is a colon delimited variable-length fields ASCII file containing one entry per line. Each entry consists of six fields separated by a colon ':'. The maximum line length is 172 characters. Empty fields must contain a space character including the last field. Each line ends in the usual carriage return and line feed characters. The CPX program allows for up to 1100 entries. Each field has a maximum length. Overlong fields will be displayed unpredictably in the CPX and may cause a crash. However, if the data file is edited without the index files being recreated then the CPX will almost certainly catch this and prevent any crashes or inaccurate data being displayed. Field Length ˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙ Field 1 STD Code 8 Field 2 Exchange 1 20 Field 3 Exchange 2 30 Field 4 User 1 23 Field 5 User 2 30 Field 6 Notes 1 25 Field 7 Notes 2 30 Total 166 Field delimiters 6 Maximum line length 172 These maximum lengths are a result of the limited space in the CPX window display. The user may edit this file to suit their own needs, for instance, in the event of some STD Codes changing. However, the user must remain within the limitations as already outlined. Failure to do so will be unpredictable. Use an editor to change the file or a word processor in ASCII or non-word processor or program mode. If place names that contain hyphens are entered (such as "Weston-Super- Mare"), leave out the hyphen and insert a space instead (such as "Weston Super Mare"). The STDINDEX and STDCODE.CPX programs are writen to convert hyphens to spaces so that the various ways of spelling such names are successfully acted upon without recourse to duplicate lines (and hence duplicate STD codes) in the data file. Also note that the character case doesn't matter, so, "Clacton on sea", "Clacton on Sea" and "Clacton On Sea" are treated the same. If the STDCODES.LST data file is changed IN ANY WAY then the two index files MUST be recreated. A program is supplied for this called STDINDEX.TOS. Whilst every effort has been made to ensure that the information given in the STDCODES.LST data file is accurate, no legal responsibility is accepted for any errors, omissions or statements in that information. The bulk of the information as supplied in this file is Crown Copyright and is reproduced with due acknowledgement of the source of the information. There have been substantial additions and editing by myself to increase the usefulness of the data. No responsibility is accepted for any errors which may have been introduced as a result of any such editing. STDCODES.CPX - STDINDEX.TOS ˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙ This program is designed to be used to regenerate the two index files needed by STDCODES.CPX. A separate index is created for each of the first two fields - STDCODES.CDX for the Code (1st) field and STDCODES.NDX for the Exchange Name (2nd) field. A check is also made on the STDCODES.LST file to see if it complies with the limitations outlined above. If this check fails, then the index files won't be created. Details of the failures are provided so that the user can re- edit the data file accordingly. Please note that if the STDCODES.LST is edited, even the addition or subtraction of one character, then the index files won't be accurate for any data after that edit. YOU MUST RECREATE THE INDEX FILES WHENEVER THE STDCODES.LST FILE IS EDITED, HOWEVER SMALL. STDCODES.CPX - VERSION HISTORY ˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙ V1.0 February 1996 The first release version. V1.1 February 1996 Not released. Hyphens now allowed in Exchange Name field. All text and output fields are better aligned and look neater. V1.2 February 1996 Input can be in any case so that various spellings of place names, such as, "Clacton on Sea" or "Clacton On sea" or even "clacton on sea" are now considered equivalent. Hyphens are converted to spaces by the CPX so duplicate entries in the data file for, say, "Clacton-on-sea" and "Clacton on sea" are not necessary. Use hyphens or spaces in your input,it doesn't matter. V1.3 March 1996 A search on two empty fields is now caught with an alert. Some minor corrections to the data file. V1.4 March 1996 This release version. If a search string is not found all the output fields have any data already displayed in them removed so as not to cause any confusion. STDCODES.CPX - THE ACKNOWLEDGEMENTS ˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙ Thanks to Jon Ellis for his CPX articles in his excellent Programmers' Forum series in ST Applications magazine. Thanks to Kevin O'Donovan for helping with some file search algorithms and his patience during this learning period. Also Bob Culverston for finding a decent data file for me to work with and thus saving on masses of typing! Sl…inte mhath Mark S Baines Linnhe Computing Linnhe, Shore Street Inver, by Tain Ross-shire IV20 1SF 22nd March 1996 E-mail: Internet: msbaines@cix.compulink.co.uk FidoNet: 2:254/105.10@fidonet.org NeST: 90:102/107.0@nest.ftn TurboNet: 100:101/12.10@turbonet.ftn AtariNet 51:502/0.10@atarinet.ftn