STDCODES v1.2
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 8
Field 2 20
Field 3 30
Field 4 23
Field 5 30
Field 6 25
Field 7 30
Total 166
Field delimiters 6
Max 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 geared to converting
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 case doesn't
matter, except that what you use will be displayed in the CPX. 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 to 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
This release version.
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.
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
20th February 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