home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / timing / voycost_1 / !VoyCost / !Help < prev    next >
Text File  |  1995-12-12  |  13KB  |  341 lines
  1. !VoyCost 
  2. ~~~~~~~~
  3. © Dave Ward 1995 (With help from Roddy Simpson)
  4. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  5.  
  6. Purpose  : Allows you to keep track of your phone bill for the Voyager 
  7.            software suite. 
  8. Dated    : 12/12/95
  9. Version  : V0.09
  10.  
  11.  
  12. Order of Contents
  13. ~~~~~~~~~~~~~~~~~
  14.  
  15. Contents of acrhive.
  16.  
  17. What is !VoyCost?
  18.  
  19. How to set !VoyCost.
  20.  
  21. History.
  22.  
  23. Bugs! 
  24.  
  25. Contacting me.
  26.  
  27. Disclaimer and terms/conditions.
  28.  
  29.  
  30. Contents of acrhive.
  31. ~~~~~~~~~~~~~~~~~~~~
  32.  
  33. !VoyCost application contains :
  34.  
  35.     !Boot
  36.     !Run
  37.     !RunImage
  38.     !Sprites
  39.     !Sprires22
  40.     ConFig
  41.     Templates
  42.     !Help                 - This File
  43.     BTCalls               - Draw file of currect BT charges
  44.                             (Not contained with update archive)
  45.  
  46.  
  47. What is !VoyCost?
  48. ~~~~~~~~~~~~~~~~~
  49.  
  50. Overview.
  51. ---------
  52.  
  53. This application will, when loaded attempt to display your current expected 
  54. phone bill call charges made via the Voyager internet software.
  55.  
  56. This application will try to read !Voyager's 'DialLog' file that records all
  57. calls made by !Voyager, this file is in ASCII format and so is readable to 
  58. humans but it is not very clear at a clance what is what and it gives not 
  59. idea on the expected cost of the forthcomming phone bill, this is what 
  60. !VoyCost trys to give the information to the user in a clear, easily 
  61. understandable way giving full costings *.
  62.  
  63. PLEASE NOTE : Voyager does not start its counter when it first connects but 
  64. after about 5 secounds kater when to has connected and fullt handshaken 
  65. with your pop.  And If Voyager crashes it will not record your current call 
  66. details and so there may be various oddities.  This application is only 
  67. ment to be a rough costings.
  68.  
  69. (*) - Only if the correct charges are entered into the 'config' file.
  70.  
  71. How?
  72. ----
  73.  
  74. PLEASE NOTE : The application should already be set for BT's local call rate 
  75. and current VAT.
  76.  
  77. To load - Make sure !VoyCost is on a read/writable media e.g. Hard Disk.
  78.           Make sure !Voyager has been seen by the filer.
  79.           Double click on !VoyCost application.
  80.           !VoyCost will display a window showing: 
  81.           
  82.           the start date  - The date the first entry was entered into the 
  83.                             the log file.
  84.           
  85.           The finish date - the last date entered into the logfile.
  86.           
  87.           Day Time Calls  - this shows the amount of seconds of day time 
  88.                             calls contained within the logfile as well as 
  89.                             the expected cost (inc VAT).
  90.                             
  91.           Night Time Calls- this shows the amount of seconds of night time 
  92.                             calls contained within the logfile as well as 
  93.                             the expected cost (inc VAT).
  94.           
  95.           Weekend Calls   - this shows the amount of seconds of weekend time 
  96.                             calls contained within the logfile as well as 
  97.                             the expected cost (inc VAT).
  98.           
  99.           Total Calls     - This show the toal number of seconds and total
  100.                             expected cost (inc VAT).
  101.           
  102.           PhoneBill Button- When this is clicked upon a file is created in 
  103.                             !VoyCosts directory that can be entered into 
  104.                             edit for display or printing that shows a 
  105.                             breakdown of calls made and the expected cost of 
  106.                             each call and the total cost.  An option can be 
  107.                             set that allows the output to be directed to the 
  108.                             current text editor e.g. !Edit or !Zap as well 
  109.                             as the file so the file can be easily printed 
  110.                             out for reference to the forthcomming phone 
  111.                             bill. 
  112.           
  113.           Re-Set Button   - When this buuton is double-clicked upon !VoyCost 
  114.                             firstly copies the old logfile contained within 
  115.                             !Voyager in !VoyCost's directory and saves it as 
  116.                             'OldLog' for save keeping (it is only kept here 
  117.                             until the'Re-set' button is pressed again). Then
  118.                             a new file is created in it place totaly blank. 
  119.           
  120.                             PLEASE NOTE : If this option is activated twice 
  121.                             it will totaly remove the old logfile and so 
  122.                             will loss any data held within.
  123.           
  124.           OK Button       - When pressed it will close down the !VoyCost 
  125.                             application.  This also happens if theuser 
  126.                             closes the 'close' icon at the top of the window.
  127.                             
  128. If you select 'PhoneBill' - The disk drive will whir and a file called 
  129.                             PhoneBill will be created within VoyCost's 
  130.                             application directory and if 'Automatic Editing' 
  131.                             is then an Edit window will apear with the file 
  132.                             already loaded.  This file gives a breakdown of 
  133.                             your calls including Date, Time, Type of Call, 
  134.                             Duration, Cost and Cost inclusive of VAT. 
  135.           
  136.           
  137. How to set !VoyCost.
  138. ~~~~~~~~~~~~~~~~~~~~
  139.  
  140. There are many option that can be set to get the correct costings and 
  141. various customising of the application, these option are held within a 
  142. ASCII file in !VoyCost's directory called 'ConFig'.  If you want to 
  143. change the file just load this file into !Edit or !Zap and change the 
  144. relavent areas, these areas are:
  145.  
  146. Day Time Charge
  147.  
  148.     This points to the value for your day time charge per minute in 
  149.     pence current BT charges are 3.36p local rate ex VAT
  150.  
  151. Night Time Charge 
  152.  
  153.     This points to the value for your night time charge per minute in 
  154.     pence current BT charges are 1.4p local rate ex VAT
  155.  
  156. Weekend Charge        
  157.  
  158.     This points to the value for your weekend time charge per minute in 
  159.     pence current BT charges are 0.85p local rate ex VAT
  160.  
  161. Start Of Day Time          
  162.  
  163.     This sets the start for the day time rate, currently BT start the
  164.     day time rate at 8:00 . This option must be in the 24h clock and 
  165.     only whole hours.
  166.  
  167. Start Of Night Time Charge 
  168.  
  169.     This sets the start for the night time rate, currently BT start the 
  170.     night time rate at 18:00 . This option must be in the 24h clock and 
  171.     only whole hours.
  172.  
  173. Min cost
  174.  
  175.     This option set the minimun cost per call, currently BT impose a 4.2p 
  176.     minimum all rate ex VAT.
  177.     
  178. Discount
  179.  
  180.     This option allows a discount percentage to be set e.g. for BT's 
  181.     Family & Friends scheme that give a 5% discount to selected phone 
  182.     numbers.
  183.  
  184. Automatic Editing
  185.  
  186.     This option allows !Edit or !Zap to be automatical loaded (If 
  187.     already seen be the filer) when the user selects the 'PhoneBill' 
  188.     button this outputted file is saved to disk as normal and is 
  189.     directed to your text editor, to set this option to load up your 
  190.     text editor and to direct the PhoneBill file to theeditor 
  191.     automaticaly just enter a 'Y' or a'y' in the relavent line.
  192.     
  193. VAT %
  194.  
  195.     This option allows the user to enter the current VAT rate if not 
  196.     already added.  Current rate of VAT = 17.5%.  If you do not know your 
  197.     charges without VAT just enter the charges inclusive of VAT and then 
  198.     set VAT to 0, this might be the case if you subcribe to a cable 
  199.     company like myself.     
  200.     
  201. No of Second to add
  202.  
  203.     This option allows the user to set the number of seconds to add to 
  204.     each call, this option exists because Voyager does not start its 
  205.     clock untill it has fully handshaken, and this can be up to 20 
  206.     secounds in my experience but normally about 13 seconds.
  207.     With this option set at 13 seconds my phone bill for a month was 
  208.     only only out by 0.6p (and I have not got my operators correct 
  209.     costings, I worked then out myself). 
  210.     
  211. So a commpleted config file to use BT's local call rate and have a 5% 
  212. discount and to automaticaly load up !Edit would look like this:
  213.  
  214. Day Time Charge            :3.36
  215. Night Time Charge          :1.4
  216. Weekend Charge             :.85
  217. Start Of Day Time          :8
  218. Start Of Night Time Charge :18
  219. Min cost                   :4.2
  220. Discount                   :5
  221. Automatic Edit loading     :Y    
  222. VAT %                      :17.5
  223. No of seconds to add       :13
  224.  
  225. PLEASE NOTE : The spaces in the config file are important.  And any money 
  226. value can have only 6 charactors e.g. .12345 or 1.2345 or 12.345 or 123456 
  227. are all valid inputs. 
  228.  
  229. Makeing !VoyCost load automaticaly when !Voyager is started.
  230. ------------------------------------------------------------
  231.  
  232. I use this software to be loaded before Voyager to tell you what you 
  233. can expect the phone charges to be later, this can be made possible by 
  234. placing a command like this:
  235.  
  236.     Run <VCCCalc$Dir>.!Run
  237.     
  238. On the line under the line 'Set VTiInternet$Dir <Obey$Dir>' of the !Voyager 
  239. !Run file.
  240.     
  241. History.
  242. ~~~~~~~~
  243. V0.03 Differs from V0.02 by allowing the minimum charge to be set in the 
  244. config file, also a bug in this area of code and a major bug in adding up.
  245.  
  246. V0.04 Displays the starting date and the finishing date of the voyager log 
  247. file and produces a phone bill type output so that you can check it easily 
  248. with your phone bill.
  249.  
  250. V0.05 Now displays cost in pounds (helped from Roddy Simpson , Wimpslot 
  251. increased to 20k
  252.  
  253. V0.05a Shows the total in red and makes the user double click on the reset 
  254. button to activate it.
  255.  
  256. V0.06 Allows 4 charactors to be taken from the config file e.g. 1.12 are 
  257. fine, also the discount feature as some people have a discount attached to 
  258. there bill e.g. BT's family and friends gives a 5% discount to each call 
  259. made to a certain number. A config file that has set a 7.5% discount
  260. would look like this:
  261.  
  262. Day Time Charge            :3.7
  263. Night Time Charge          :1.47
  264. Weekend Charge             :0.98
  265. Start Of Day Time          :8
  266. Start Of Night Time Charge :18
  267. Min cost                   :3.53
  268. Discount                   :7.5
  269.  
  270. V0.07 Allows the phone bill file to automaticaly sent to !Edit, !Zap or
  271. any other app that will load when filetype FFF/Text is run, this option is 
  272. set in the config file, if you want automatic loading of edit then hae a 
  273. 'Y' or 'y' at the end of the line 'Automatic Editing' or a 'N' if you do 
  274. not want this option.  Plus a couple of minor improvments.
  275.  
  276. V0.08 VAT can now be seperated, in the phonebill a seperate column is now 
  277. used to show cost of each call without VAT added.
  278.  
  279. V0.09 'No of second to add' feature added to the program to make it more 
  280. accurate as Voyager is not very accurate.
  281.  
  282. Bugs! 
  283. ~~~~~
  284. There are three slight thing to be improved possibly, these are when you 
  285. double-click on the 'Re-set button the button does not go back to a 
  286. normal colour untill it is clicked on again.  And if no text editor has 
  287. been seen by the filer and the 'Automatic Edit Loading' is on then when 
  288. you select 'PhoneBill' the text is directed to the screen in a horrid way.
  289. The program does not understand the change in time areas e.g. if a call is 
  290. started on Friday at 23:55 and continues till Saturday at 0:05 only 10 
  291. minutes it will be wholely charged as at Fridays rate and not split in to 
  292. 5 minutes friday rate and 5 minutes saturday rate. (This does not hinder most people as most people would not start a call so close to a change of call 
  293. type as they could easily wait 5 minutes and getthe call cheaper).
  294.  
  295. If you find any more please tell me.  Or if the program is not working 
  296. accurately please tell me, and please send my all information possible e.g. 
  297. a copy of your phone bill, and your Voyager 'DialLog' file so I can correct 
  298. the program.
  299.  
  300. And also please email me to say if it is accurate enough. 
  301.  
  302. Contacting me.
  303. ~~~~~~~~~~~~~~
  304.  
  305. Bug reports and comments may be sent to me at this address :-
  306.  
  307. At 
  308.         e-mail me on dave.ward@argonet.co.uk 
  309.  
  310. OR
  311.  
  312.     Digital Databank (01707-329306)
  313.  
  314.     usernumber #1808
  315.  
  316.  
  317. PLEASE TELL ME IF YOU USE OR DO NOT USE THIS SOFTWARE AND IF SO WHY?
  318. ~~~~~~                ~~~    ~~~~~~~~~~                         ~~~~
  319.  
  320. Disclaimer and terms/conditions.
  321. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  322.  
  323. Disclaimer
  324. ----------
  325.  
  326. This application is supplied "as seen".  No warranty (either implied or 
  327. stated) is given concerning the fitness of this program for any particular
  328. purpose.  I will not be liable for any type of damage that the use of this
  329. program may cause.
  330.  
  331. Terms and Conditions
  332. --------------------
  333.  
  334. This application is Freeware.  I retain copyright, but it may be freely
  335. distributed as long as:-
  336.  
  337. 1) All the files accompanying this message remain intact and unaltered and 
  338.    are only distributed together.
  339. 2) Only reasonable charges are made for its distribution (by reasonable I 
  340.    mean a maximum limit of £1.50 for a DD disc and £2 for a HD disc, 
  341.    allowing for inflation as time rolls on, of course!)