Short:    V1.0 The Miami Phone Log Parser (MUI)
Author:   mdoyen@nordnet.fr (Maxime Doyen)
Uploader: mdoyen@nordnet.fr (Maxime Doyen)
Version:  1.0
Type:     comm/tcp
Requires: MUI 3.1+, OS2.x (V37+)

Introduction
------------
«MiamiPhone» is the analyzer for Miami phone log.  The idea of it came to
me by a friend request that wanted a MUI (© Stefan Stuntz) based phone log
analyzer for Miami (© Holger Kruse), which was not existing till now...
«MiamiPhone» is freeware but copyrighted by me, it displays a lot of
informations about the actual time and cost of your connections, and is
quite configurable.  I have tried to make it useable outside of France, I
hope it will be, because I have no idea on how phone calls are charged
abroad!  Anyway its no cost for you to try it...

Main features includes
----------------------
 - external configurable price file
 - error detection skipping
   (Online without Offline, when your computer has crashed!)
 - optional setable connect time
   (seconds between phone connect and modem online)
 - optional setable tax
 - optional setable retrenshment
 - displays total time, number of connections
 - displays total price with and without tax, and after retreshment
 - displays tax amount
 - display retrenshment gain with and without tax
 - displays detail of connections
   (number, date, online, offline, duration, price with and without tax)
 - localized (french catalog provided, and .cd file)

Requirements
------------
 - Kickstart 2.0 or higher
 - Workbench 2.1 or higher
 - MUI 3.1 or higher (not provided)
 - Miami phone log file(s)

How to uses it
--------------
1) You must be registered to Miami to be able to logging the phone.  Please
read Miami documentation about how to configure it.

2) You must then configure the "MiamiPhone.price" file.  Here are some
explanation on how to do so (see also the example file):

* TIME ZONE
Here you will define the time zone, hour by hour and day by day, from
Sunday to Saturday and from 00:00:00 to 23:59:59.  Each day is splitted in
23 slices of a hour.  First slice is from 00:00:00 to 00:59:59, second is
from 01:00:00 to 01:59:59, etc.  Each of this slice must be associated to a
tariff, e.g a number from 0 to 9. Example:

  Sunday is the same tariff for all day, let's say its tariff0:
d0: 000000000000000000000000 :Sun
  Monday is tariff0 from 0h to 8h, tariff1 from 8h to 19h, and then tariff0:
d1: 000000001111111111100000 :Mon

* TARIFF ZONE
Here you will define the tariff of above time zone.  You are limited to 9
different tariff, which must be in currency/seconds.  If we continue with
the example, we will set:

t0: 0.001932
t1: 0.003864

* CONNECTION SPECIFIC
Here you will define if necessary specific charge and time from your
phone network. I will explain this with an example. In France a connection
is charged 0.615 Fr the first 3 mns and then different tariff dependings
on time and destination call. When we compute the cost of a call, we must
charge the first 3 mns at 0.615, and then apply the right tariff. The two
values "cc" (connect cost) and "ct" (connect time) are for this specific
purpose. With the example cc must be 0.615 and ct 180 (this must be in seconds).

NB: the formula applied to compute the cost of a call is:

 cost call = connect cost + [(number of seconds - connect time) * tariff]

3) You can now run «MiamiPhone»

4) Now you should set other parameters, they will be saved and restored
as well later:
filename     -> the phone log file to parse
connect      -> the missing connect time (in seconds), this is time between
                hangup and real online (when miami write in the phone log)
tax rate     -> the tax applied in your country
retrenshment -> an optional reduction to your phone company

Contact:
--------
Feel free to mail me suggestions, comments, or bug report at:
<mdoyen@nordnet.fr> (please specify "MiamiPhone" in object mail field)


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
    1233     832 32.5% 21-Aug-98 00:00:00  MiamiPhone.info
    1233     800 35.1% 21-Aug-98 00:00:00 +Catalogs.info
    1364     770 43.5% 21-Aug-98 00:00:00 +MiamiPhone.catalog
    3281    1008 69.2% 21-Aug-98 00:00:00 +mp_english.cd
   19320   11532 40.3% 21-Aug-98 00:00:00 +MiamiPhone
    1693    1200 29.1% 21-Aug-98 00:00:00 +MiamiPhone.info
     747     366 51.0% 21-Aug-98 00:00:00 +MiamiPhone.price
    3906    1821 53.3% 21-Aug-98 00:00:00 +ReadMe
    1835    1323 27.9% 21-Aug-98 00:00:00 +ReadMe.info
    1083     531 50.9% 21-Aug-98 00:00:00 +ReadMe.mui
    1415     530 62.5% 21-Aug-98 00:00:00 +ReadMe.mui.info
-------- ------- ----- --------- --------
   37110   20713 44.1% 26-Aug-98 19:31:06   11 files
