home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac_os2 / etelr16.zip / READ.ME < prev    next >
Text File  |  1994-06-09  |  8KB  |  179 lines
  1. This is the read.me file for E-Teller 1.6
  2. 9 June 1994
  3.  
  4. Installation
  5.    General Instructions (also for 1.5 to 1.6 users)
  6.    Previous Users
  7.       1.4 to 1.5
  8.       1.0 to 1.4
  9.  
  10. What do I need to run E-Teller?
  11.  
  12. File Descriptions
  13.  
  14.                         Installation - General Instructions
  15.  
  16.    The easiest way to install E-Teller is to copy this archive into E-Teller's
  17.    personal subdirectory and unzip it.  Two subdirectories will be created:  
  18.    Help and Formats.  The e-teller.hlp file is unzipped into the former, and the 
  19.    report format scripts into the latter (these must reside in the subdirectories 
  20.    just named) . Then copy the DLL for VX-Rexx 2.0a into a subdirectory 
  21.    specified by the libpath statement in your config.sys file.  
  22.    NOTE: VROBJ.DLL is not supplied in this archive.  It can be found at the
  23.    rexx.uwaterloo.ca site in pub/os2/vxrexx/vrobj20a.zip.  E-Teller requires
  24.    version 2.0a of the DLL.
  25.  
  26.    If you're a NEW USER, you can safely delete the et_cmd.zip file. 
  27.  
  28.    If you're a 1.5 USER, you may (or may not) be happy to learn that E-Teller 
  29.    comes with it's own version of an INF help file.  All of the various *hlp.txt 
  30.    files have been integrated into one file named e-teller.hlp.  In fact, this 
  31.    is a plain ascii file, but it's heavily marked up (well, in spots) so that 
  32.    E-Teller's help facility can find topics quickly.  In short, you can delete 
  33.    the numerous *hlp.txt files in the ...\help\ subdirectory.  The e-teller.hlp 
  34.    file still has to be placed in the ...\help\ subdirectory, however.  Perhaps 
  35.    someday, I'll be able to afford a real IPF compiler and create a real INF 
  36.    file!  You may safely delete the et_cmd.zip file, since none of the file
  37.    formats have changed in version 1.6
  38.  
  39.    If you're a 1.4 USER, you can delete the et_cmd.zip file after you've extracted
  40.    the etfix15.cmd file and have run it (it converts et_fix.ini and et_fixed.ini to
  41.    run in version 1.5 and 1.6 - see below 'From 1.4 to 1.5').
  42.  
  43.    If you're a 1.0 - 1.3 USER, you must run the Rexx scripts in cmd_14.zip 
  44.    first, running etfix15.cmd *last* (see below 'From 1.0 to 1.4').
  45.  
  46.  
  47.                            Installation - Previous Users
  48.                                   From 1.4 to 1.5
  49.  
  50.    ET_FIX and ET_FIXED have been changed (again) - sorry, but I promise it's 
  51.    the last time (I think).  They're no longer INI files but straight ascii.  
  52.    You will have to run the etfix15.cmd rexx script in order to convert these 
  53.    INI files (you can find it in the et_cmd.zip archive).  Also, there was a bug 
  54.    in 1.4 whereby the date for a fixed transaction was not properly saved.  The 
  55.    etfix15.cmd script will notify you if it finds such an error and suggest a 
  56.    date for you.  
  57.  
  58.                                   From 1.0 to 1.4
  59.  
  60.    A number of changes were made in version 1.4.  As a result, installation is a 
  61.    little more complex:  
  62.  
  63.    1) replace the existing VROBJ.DLL with the one in the archive.  Version 1.4
  64.       requires the DLL for VX-Rexx 2.0a.
  65.    2) account file format has changed.  To convert your account *.ini files
  66.       (excluding ET_FIX and ET_FIXED), either drag them on to the
  67.       FIXACCT.CMD file or pass the account *.ini filenames as command
  68.       line parameters from an OS/2 window (one filename per invocation).
  69.    3) As a direct result of #2, the ET_FIX and ET_FIXED files must be
  70.       converted, too.  To convert these two files, simply start the
  71.       FIX_FIX.CMD file (no parameter required).
  72.    4) Once you've converted both the account *.ini files, ET_FIX.INI and
  73.       ET_FIXED.INI, and once you're satisfied that the conversion went
  74.       well, you can delete the FIXACCT.CMD and FIX_FIX.CMD files.  The
  75.       best way to check the accuracy of the conversion on the account
  76.       *.ini files is to load them into E-Teller.  If you don't get an error
  77.       message, then they were properly converted.  For ET_FIX and
  78.       ET_FIXED, you need only check the filenames in both INIs.
  79.       Previously, the format was:
  80.  
  81.          [day of month]
  82.             drive:\path\filename.ini = transaction(s)
  83.  
  84.       Now, that should read:
  85.  
  86.          [day of month]
  87.             drive:\path\filename.clr = transaction(s)
  88.  
  89.       In other words, only the extension of the filename should have been
  90.       changed.  All else remains the same.
  91.    5) Because of an error in E-Teller 1.3, a useless entry was created in
  92.       your OS2.INI file.  To clean it up, first make a backup copy of the
  93.       OS2.INI file (just in case) and run DEL_ERR.CMD.  This Rexx script
  94.       will not blindly change your OS2.INI file.  It will prompt you before
  95.       making *any* modification to the file.  For your own peace of mind,
  96.       DEL_ERR.CMD proceeds as follows:
  97.  
  98.       1) Check for 'Main' entry in OS2.INI
  99.       2) If found, get the keys contained in 'Main' and list them.
  100.       3) List the keys that should be contained in 'Main' according
  101.          to the error in E-Teller 1.3.
  102.       4) Ask user if 'Main' should be deleted.  If no,
  103.       5) Ask the user if individual keys should be deleted.  If yes,
  104.       6) Prompt user for each key.  If told not to delete, show next.
  105.    6) Because the layout of E-Teller's main window has changed, and 
  106.       because the way in which window/object size, position, etc. is stored
  107.       and read has changed, you will have to delete your current e-teller.ini
  108.       file.  If you don't, then the Accounts and Ledger containers will be
  109.       improperly positioned.  I considered including another small program to
  110.       do this for you, but since the information contained in E-Teller.ini is not
  111.       vital to its operation, I didn't see the point.
  112.  
  113.                           What Do I Need to Run E-Teller?
  114.  
  115.    To run E-Teller, you need, in addition to the files contained in this archive
  116.    (see below):
  117.  
  118.       1) Rexx support installed (mandatory)
  119.       2) PMDCALC.EXE or any other calculator program (optional).
  120.       3) A text editor/printer since E-Teller Report relies on an external
  121.          program to operate.  EPM is a good candidate.
  122.  
  123.                                  File Descriptions
  124.  
  125.    The archive should contain the following 18 files:
  126.  
  127.    Execs.
  128.       etne.exe
  129.          used by E-Teller (required)
  130.       etreport.exe
  131.          stand-alone report program which can be invoked from within E-Teller
  132.          (optional, but pretty necessary)
  133.       e-teller.exe
  134.          E-Teller (required)
  135.       et_month.exe
  136.          used by E-Teller (required if you want to take advantage of the fixed
  137.          transaction feature)
  138.       q2et.exe 
  139.          a Quicken to E-Teller file conversion program (optional) 
  140.  
  141.    ZIPs
  142.       help.zip
  143.          contains e-teller.hlp which must reside in a subdirectory named 'help'
  144.          (optional, but the help facility is built-in, so you may as well keep the 
  145.          help file) 
  146.       formats.zip
  147.          contains two format scripts used by E-Teller Report.  These must reside
  148.          in a subdirectory named 'formats' (required if you plan to use E-Teller
  149.          Report)
  150.       et_cmd.zip
  151.          conversion scripts supplied with versions 1.4 and 1.5.
  152.  
  153.    MISC
  154.       register.txt
  155.          registration form
  156.       read.me
  157.          installation instructions (expendable)
  158.       whats.new
  159.          new features in version 1.5 (expendable)
  160.       file_id.diz
  161.          BBS file description file (expendable)
  162.       history.txt
  163.          E-Teller development history (expendable)
  164.  
  165.  
  166.    ICOs
  167.       e-teller.ico
  168.          E-Teller's icon (optional)
  169.       bank.ico
  170.          used by E-Teller to represent bank accounts (optional)
  171.       ccard.ico
  172.          used by E-Teller to represent credit card accounts (optional)
  173.       fix.ico
  174.          used by E-Teller to represent the et_fix.dat fixed transaction file 
  175.          (optional)
  176.       fixed.ico
  177.          used by E-Teller to represent the et_fixed.dat fixed transaction file 
  178.          (optional)
  179.