IDE Failure or Corrupted Workspace

tentergf.gif (577 bytes) A server failure may cause cause IDE errors on the client, or prevent you from saving the workspace. After the server has been restarted, you may be able to reconnect without losing any work. See the list of related topics at the end of this document, for a link to more information on   recovering from a server failure.

Workspace Recovery
If VisualAge for Java terminates abnormally, for example because of a power failure, the workspace is not saved. If something causes the workspace to become corrupted, you can not save it. In either of these situations, you will not lose the source code changes that you have saved; they are safely stored in the repository and can be re-added to the workspace if necessary. You may lose some workspace information, if you have made any of the following changes since the last time you saved the workspace:

To recover from a corrupted workspace error or from an IDE failure:

  1. If the IDE is still open, save any important Scrapbook pages and then close all VisualAge for Java windows. You will not be able to save the workspace.
  2. tentergf.gif (577 bytes) If a server outage caused the client IDE to fail, confirm that the server has been restarted.
  3. Restart the IDE. VisualAge for Java will attempt to recover the workspace and resynchronize it with the repository.
  4. If the IDE starts successfully, the workspace might not contain open editions that you created or methods that you saved since you last saved the workspace. These changes are stored in the repository. To retrieve them, re-add or replace open editions. You may also need to reset your IDE options if you changed them without saving the workspace.
  5. Select Save Workspace from the File menu in any window.

Failure to Recover a Corrupted Workspace
When you try to restart the IDE, you may see a message indicating that VisualAge for Java could not recover the workspace. If this happens, you must restore the workspace file, ide.icx.

If you have a backup copy of the ide.icx file, restore that. If you do not have a backup copy, you will have to reinstall the workspace that was provided with VisualAge for Java, as described below.

Once you have restored the workspace file and restarted the IDE, you can retrieve the work you had saved in the repository by re-adding or replacing your open editions in the workspace, and you can reset your IDE options. When you have recustomized the workspace, select Save Workspace from the File pull-down menu.

Reinstalling the Workspace
To reinstall the original VisualAge for Java workspace file:

  1. Delete the corrupted workspace file (ide.icx) from the VisualAge for Java program subdirectory.
  2. Run the VisualAge for Java installation program. If you accept the default directory shown in the install wizard, and select the same components that you chose when you originally installed the product, then only the ide.icx file will be reinstalled.
  3. Start the IDE. VisualAge for Java will connect the fresh workspace to the existing source code repository.
  4. tentergf.gif (577 bytes) Choose a new workspace owner by selecting your name from the list of repository users.
  5. As was the case when you first installed VisualAge for Java, the only projects that you see in the Workbench are the standard class libraries. The IDE options revert to their default settings. Re-add the editions of projects, packages, and classes that you need from the repository, and reset the IDE options that you prefer.
  6. Select Save Workspace from the File pull-down menu to save the workspace.

Your workspace should now be fully recovered and ready to use.


Workspace
Repository


Saving the Workspace
Adding Projects and Packages from the Repository to the Workspace
Adding Classes and Methods from the Repository to the Workspace
Replacing Editions in the Workspace (Reloading)
Setting IDE Options


Important Files to Back Up
Repository Files