This document explains how to recover from a defective iCash file. It is intended for users that have experienced data corruption on their iCash document files and have no recent backup available. Despite iCash tries to secure and protect your data integrity, it is important to create backups regularly to external supports like HDs or DVDs. That will prevent data loss or massive corruption caused by a defective hard drive or a system crash.
An iCash file that has become damaged will typically have symptoms similar to the following:
The file cannot be opened by the program.
The program crashes with an error message when the user performs typical operations such as viewing detail information, editing records, generating reports, etc
The program displays inconsistent information.
iCash built-in recovery tool
When you run into such problems you should first try to recover your file using the built-in iCash recovery tool. It is quite simple, just launch iCash, select the faulty file from the 'Recent Documents' windows and use the "File | Tools | Recover Database" menu. iCash will create a fresh new file and will copy all your data to it. However, if your file is badly damaged this procedure will likely fail and iCash will crash. In such case you will have to use a backup copy as explained below.
By default (if you haven't deactivated it), iCash performs automatic backups every-time you close a document or open a document that needs low level updates. Those backups are actually copies of the iCash document files without compression.
The backups are created in the '~/Library/Application Support/Maxprog/iCash/Backups' folder on Mac OS X and the 'My Documents\Maxprog\iCash\Backups' directory on Windows. (Note that on Mac OS X older versions backups may be created in the
'~/Documents/Maxprog/iCash/' folder). Each document backup is saved to a folder with the same name. Only the 16 more recent backup files are maintained. They are labeled with the backup date, for example '2005-10-13 19-43-09' which means 'October 13, 2005 19:43:09'.
For example our Backup folder for our accounting files looks like this:
('~/Library/Application Support/Maxprog/iCash/Backups/Max Programming LLC/' folder)
It is then very easy to copy any of those files to your working directory. Try with the newest first, then rename it and use it as usual. If it doesn't open, try with previous one. Alway perform copies, don't simply move the file.
If this method fails and you are using iCash 3.1.3 or higher, you have a second chance. You can use the XML dump files iCash creates each time you open a document. They are stored in the '~/Library/Application Support/Maxprog/iCash/XML Dumps' folder on Mac OS X and in the 'My Documents\Maxprog\iCash\XML Dumps' directory on Windows. (Note that on Mac OS X older versions XML dump files may be stored in the
'~/Documents/Maxprog/iCash/' folder). Again, only the 16 more recent XML dump files are maintained. They are labeled with the backup date, for example '2005-10-13 19-43-09' which means 'October 13, 2005 19:43:09'. You can use those files to rebuild your original document. You just need to launch iCash, select the 'File | Import | XML Dump' menu and open the XML dump file of your choice - try most recent first. A whole new document will be created with your data.
Note that this automatic backup system is useless if you lose your whole hard drive. It is recommended to perform backups to an external drive regularly. Also note that if you have deactivated automatic backups from the iCash preferences you will no longer be able to take advantage of this feature.
If you want to make the most of the software that you have acquired at Maxprog, do not miss the Stan's Blog. It is a library of Tutorials and Tips covering specific features and tipical problems you may have when using our tools. This page is updated regularly depending on the topics discussed in our public forums and issues reported thru our HelpDesk. If you are interested on what we are currently working on (or want to participate in beta testings) don't miss the Stan's Logbook.
For years, MAX Programming has provided companies around the globe with sophisticated and innovative solutions. Our commitment to quality is not only evident in our products, but also in our people. It is our mission in Professional Support Services to ensure that our products perform to the fullest of their ability in order to meet the business objectives of our customers. We provide the tools and information required for improved productivity. To accomplish this, we offer an array of services including: Technical Support, Education Services and Consulting Services.
iCash is a software intended to control your personal finance, keeping track of incomes, expenses, credits, debts and Banks transactions for you. As simple as creating the accounts you need and move money between them! You don't even need to know about accounting or even care about it! Your finances depends largely on good organization that lets you know where your money comes from and to where it goes.
iCash is an easy-to-use, full featured and multi-purpose Personal Finance Manager tool for macOS and Windows intended to help you control all kinds of money issues. iCash can serve several small accounting needs for either private users, or clubs, associations, self-employed, small businesses or simply to be used at home, making keeping track of incomes, expenses and Banks transactions a snap.
With a few clicks you can begin creating accounts and making transactions in minutes.
iCash is versatil and user-friendly. For this reason it doesn't use the principle of double-entry bookkeeping making it much easier to be used by people with very little or no accounting knowledge at all.
Simply create accounts for all your expenses, incomes, Banks... and start moving money between them! iCash will then allow you to find out where all your money comes from and where it goes. All accounts are well organized according to user-defined categories and built-in types so reports can be tailored to include all records or only ones meeting specified criteria.
Cash also allows you to have as many money manager documents as necessary so you can control almost anything from Clubs, associations, home and so on at the same time.