Running The O$Converter

PLEASE READ THIS DISCLAIMER:

Raining Data Corp disclaims any responsibility for, or liability related to, Software obtained through the Omnis Conversion Tools Web page. IN ALL CASES, YOU SHOULD MAKE SECURE BACKUP COPIES OF ALL LIBRARIES BEFORE CONVERSION. IN NO EVENT WILL RAINING DATA CORP BE LIABLE FOR ANY INDIRECT, PUNITIVE, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES HOWEVER THEY MAY ARISE AND EVEN IF RAINING DATA CORP HAS BEEN PREVIOUSLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

To Convert Your Library File

Open your copy of Omnis Studio and open the O$Converter library. The splash screen will appear and the menu O$Converter will be installed automatically.

The splash screen displays a list of active Modules and Sub_modules found in the converter. This window is also used to activate and deactivate modules. Active modules are checked in the tree list, modules that are not active will not run.

From the main O$Converter menu choose the option 'Convert...' a dialog box will appear. If the Omnis7 library that you have just run through the pre-conversion library is not listed press the 'Open' button and navigate to it. You may need to change the file type selector to "*.lbr" if you did not previously modify its extension to "*.lbs".

As soon as you select your OMNIS 7^3 library , Omnis Studio will prompt you to ask if you wish to convert this library. Select 'Yes'. At this point the built-in conversion takes place.

Note that this conversion process and the changes that are made are described in detail in the manual 'Omnis Studio Conversion' that is supplied with Omnis Studio.

After the conversion has taken place, the trace log displays any conversion error that the automatic converter found. Close the trace log window. It is recommended that you close the converted library at this point and take a copy of the library file so that you can easily rerun the library through the O$Converter again later if required. From the O$ Converter menu again choose the option 'Convert...' and re-select your newly converted Studio library that will now appear in the list. Select it with the mouse in the list and press the button 'Convert'.

A warning message will appear. If you wish to proceed with the conversion press 'Yes'. You may also be invited to review your Conversion Log Options. Press 'No' if you do not wish to do so.

Certain modules require that parameters are set up prior to the conversion in order to control processing. If these parameters have not been set up or require review then the relevant window that provides the module's user interface may open at this time and the conversion may be terminated. If this happens then you will need to set the parameters as required and then restart the conversion. You can open the available module parameter windows using the 'Modules' menu on the 'Select library to be converted window.' If a module is disabled in the menu then it is probably because the module has been made not active in the About window.

At this stage you will be advised that the datafile "O7_YourLibraryName.df1" generated by the O7Analyzer library must be converted to Omnis Studio. Proceed with the conversion of the datafile.

Once conversion of the datafile is complete, a progress window will appear showing the converter module that is currently being executed and the class and method that is being processed. The progress bar indicates how many modules have completed. Since the modules do varying amounts of work the progress bar is not an indication of how much time will elapse before completion of the conversion. Depending on the size of the library and the performance of the computer running the conversion, the process may take a long time.

When O$Converter has finished the Conversion Log Window will open. The Log window reports the changes made by a specific post conversion module to the library and any errors detected by the converter. Note that due to the limitations of the converter there may be more problems with the converted code other than those reported in the log. It is recommended that you run the converted library though the Method Checker that is available on the Add-On Tools menu on the IDE toolbar.

After conversion of the library using the O$Converter it is recommended that you quit out of Omnis Studio before attempting to examine the library in the Omnis Studio IDE.