



















                               FONECOST
                             (Version 2)
             The Shareware Telephone Call Cost Calculator


                                MANUAL






       Copyright 1990 & 1991 R A Gorbutt & Ainley Publishing &
                           Communications.


FONECOST V2                       Page 2

                                INDEX

         What is FONECOST?.......................2
         Copyright/Acknowledgments...............3
         Running.................................3
         Operating...............................4
         Display.................................6
         Modem Usage.............................6

         History.................................7
         SHAREWARE...............................7
         Problems................................8



What is FONECOST?

How many times have you made a phone call wondering just how much it
cost? That sudden shock of receiving the quarterly bill can, to some
extent, be dampened by the use of FONECOST. Not only will this
utility calculate the cost but it can also display the accumulating
cost of the call as it progresses.

For those of you with a modem, if run as a desktop accessory FONECOST
can start calculating when the modem has detected carrier & stop on
disconnection. The time taken is transferred to the program, and of
course, you can see the cost increasing on the screen during the
session. When you first get a modem the first thing that happens is
that you run riot with your phone bill. With FONECOST you can see it
happen!!!!


FONECOST V2                       Page 3

COPYRIGHT/ACKNOWLEDGMENTS

All registered trademarks acknowledged. The prices within FONECOST are
copyright BRITISH TELECOMMUNICATIONS plc.

British Telecommunications plc, Ainley Publishing & Communications and
R A Gorbutt take no responsibility for any errors incurred in the
price data in this program. Every effort has been made to ensure that
all data is correct, and any errors will be rectified as soon as
possible.

This program is copyright 1990 & 1991 Ainley Publishing &
Communications and R A Gorbutt. Permission is granted enabling that
this released version can be freely distributed providing the
following criteria are adhered to:
    1.   That all files as listed in the "readme.doc" are
         kept intact and are supplied untouched/unaltered.
    2.   That only a small charge is made to cover costs of
         copying/distribution etc, if applicable.
    3.   If this is to be distributed via shop floors,
         i.e. packaged for the public via retail shops, that the
         written consent of the copyright holders is obtained.
    4.   Distribution of the program via a commercial magazines
         cover disk will be permitted, providing that written consent
         of the copyright holders is obtained.
These conditions can change at any time by the copyright holders
without notice & will be notified by writing where appropriate.

This means that any Bulletin board, and Shareware/public domain
library can distribute the program as they see fit.

Now with the legal bit over, let's run it.

RUNNING

This program should run on any ST from an unexpanded 520S ST(E)(FM)
etc upwards. It will work in all 3 screen resolution and users of
overscan and large screen monitors are also supported. It will also
work on the ST modes of a TT, but regretfully not on TT modes.
Whilst we have been beta-testing throught out the summer, there may be
a little bug lurking. If you find one that we haven't and we fix it,
you will get free registration. Any known problems will be shown at
the end of the manual.

To work correctly FONECOST.PRG and FONECOST.RSC must be together on
the disk. If you want FONECOST to work as a desktop accessory then
FONECOST.PRG must be renamed to FONECOST.ACC. This file along with
FONECOST.RSC must then reside on the boot disk/directory.

When first run this program or first select it from running as a
desktop accessory (DA) you will see a box alerting you to the fact
that this is unregistered. Click on the "I'll register" and you wont
see this box again during this session.

FONECOST V2                       Page 4

OPERATING

When you are presented with the main dialog box, you will see various
options. The duration box is where you can enter the call duration or
if using the timer, the duration will be shown. This time must be
entered in minutes & seconds. It can be editing using normal GEM ways,
i.e. the "Esc" key will clear the box.

In the box shown below that, the criteria for actually determining how
the call will be charged is set. There are 2 options that must be
made, both using the radio buttons. The first one is the distance of
the call.

    LOCAL -    Calls within the region.
    A -        Calls within 53km (35 miles).
    B -        Calls outside 53km (35 miles).
    B (1) -    Calls outside 53km (35 miles) using low cost routes.
    MOBILE -   Calls made to mobile telephones.
    0898 -     Calls made to Premium rate (p1) services.
    EIRE -     Calls made to the Irish Republic.

Your local BT phone book will list the exchanges and their respective
distance codes.

The next options are the time bands and these apply as follows:

    PEAK -     Mon to Fri, 0900 to 1300.
    STANDARD - Mon to Fri, 0800 to 0900, 1300 - 1800.
    CHEAP -    All other times.

Bank holidays are charged for at normal day rates except Christmas &
New Year when different rates apply. See press for details. Mercury
users are catered for in the registered version.

The four buttons below this relate to the display, modem & timer
functions.

DISPLAY

By clicking on this option you can decide whether or not you want to
see the accumulating cost on the screen. If this function is enabled
(default) then a tick (check mark) is shown to the left of the box.
The display is seen on the top line, set in slightly in medium & high
resolutions to avoid clashing with any on-screen clocks.

MODEM DCD (Data Carrier Detect)

This option can also be toggled on or off. It defaults to off. If the
box is shown greyed, then FONECOST has detected that it has been run
from the desktop and is disabled. When the timer is activated and
MODEM DCD is set to on then the timer wont start until the modem has
detected carrier. "Wait" will be shown if display is on. Like the
display option, a check will appear if active.

FONECOST V2                       Page 5


TIMER ON

This option will start the integral timer. If FONECOST is running as a
DA then the dialog will disappear and you can carry on using the ST as
before. To return to the display, select FONECOST from the desk menu
again. If this option is shown greyed, then the timer is already
running. If the display is active then the cost of the phone call can
be seen on the upper top left of the screen. If the 'modem dcd' option
is enabled then 'Wait' will appear until the modem connects.


TIMER OFF

Initially the option is shown greyed, and is only available if the
timer is running. Clicking on this will transfer the time to the
duration box for further use. If the 'modem dcd' option was used then
the time transferred will be the duration of the last call made using
the modem.


INFO

This will show you a short box telling you the version number etc.

OK

This will actually calculate the cost of the call using the parameters
set by the distance, charge band and the duration of the call. A
dialog box will be shown showing the price, both inclusive & exclusive
of VAT. Pressing Enter or clicking on the button will return you to
the main dialog again.

QUIT

This will return you to the desktop, or if running as a DA, it will
hide the program until called again.


FONECOST V2                       Page 6


DISPLAY

If you wish you can see the cost mounting up, and this is done using
interrupts. This is a small piece of code that runs every 50 or 70
times a second, depending on the monitor used. With this in mind after
about 10 minutes the accuracy can cause the cost to be within 5p.
However the actual timer used for the final calculation is accurate to
within a 1/200th of a second. How quick are you clicking?

The position of the on-screen display is set within the program to be
character position 64 for medium & high resolution users & 35 for low
resolution. The reason it is set in slightly more in medium & high is
so that users can still use on-screen clocks. For low resolution this
hasn't been accounted for because there is too much opportunity to
interfere with the menu bar.

The registered version will, however, let you define exactly where on
the top row you want the display, enabling large screen/overscan users
more flexibility.


MODEM USAGE

This function also uses the interrupts to work properly. Additionally
the modem must be able to use the "dcd" line in the RS232 lead. Most
automatic modems, particularly Hayes compatible use this feature. You
can test this by issuing a "carrier set" command from your terminal
program. AT &C0 will set the carrier high & trigger FONECOST, &
AT &C1 will set the carrier low & stop the timer. These commands may
need to be checked with your manual.

Obviously BT will start charging when the call is answered, but there
is a small delay before the carrier is detected. With a V22bis
connection (2400 baud) this is only a short delay, whereas using
V32/V42bis (9600 baud with error correction) can take as long as 10
seconds. FONECOST doesn't take this into account as it will vary from
modem to modem and also BBS to BBS. However the cost shown will be
near enough, more accurate as the call gets longer & should stop
running riot with 100k download at 1200 baud.


FONECOST V2                       Page 7


HISTORY

FONECOST was first conceived early in 1990 and released in September
of that year. It received a small but favourable response, which has
encouraged me to release this version. Originally FONECOST was written
in GFA Basic, but this release has been entirely written in HiSoft
Lattice C, V5. This has enabled small compact fast code and avoided
the need for direct 68000 machine code. Even the interrupt routines
were written in C.

Usable versions of FONECOST V2 have been around since April but extra
features have been added and also large screen & low resolutions
weren't catered for. The code for these was minimal and was added.

Debugging took time & beta testing was carried out during the summer.
My thanks go to those on CiX for their help.


SHAREWARE

The concept of shareware relies on your honesty to succeed. If you
like this program and continue using it, you are expected to register
and make a small contribution to the author so he can carry on
developing it & maybe bring out new programs at low prices.

OK, so you want to register, what do you get?

    1.   The latest full featured program
    2.   Access to MERCURY prices as well
    3.   The ability to user define the program
    4.   A small hardcopy printed manual

and FONEDATA.

FONEDATA will allow you to update and alter the prices within the
program as you need to. Telephone prices do alter frequently, twice a
year at the moment. Using a full featured GEM front end, altering
prices is made painless.
Additionally FONEDATA will let you alter the default positions on the
charge, distance & time bands & the lets you alter the screen
position.

To make registering easier there is a small file REGISTER.DOC which
can printed out and filled in. Registrations will be accepted on
anything as long as I read your name & address.

                     IF YOU LIKE IT - SUPPORT IT


FONECOST V2                       Page 8


PROBLEMS

Known problems include the holes left when running as a DA from within
VANTERM. This appears to happen when any accessory is used not just
FONECOST. If running from CHAMELEON the on screen display wont be
cleared when 'timer off' or 'quit' is selected. Similarly if you use
QUICK ST, if VT52 emulation on TOS text is turned off, then the
display wont be cleared.

AND FINALLY

Thank you for reading this document. If you enjoy using FONECOST then
please register. The registration pack is available now and it is a
low price.  If you have any idea's, suggestions or bug reports then
please let us know. Software development is a two way process.


I can be contacted as follows:

Richard Gorbutt
Ainley Publishing & Communications.
16 Copyground Court
Copyground Lane
HIGH WYCOMBE
Bucks
HP12 3HG

or electronically via:

CiX:          raggorb@cix.compulink.co.uk
CompuServe:   100014,2337
Prestel:      011156193
