Progress
ADM 2 Guide


Performing the Conversion

Progress Software Corporation strongly recommends that before you attempt a conversion as described in this section, you make a backup copy of all source files. This backup copy should be separate from and in addition to the original source files that are saved into the V8–ADM directory structure as described in Step , later in this section.

Press the Start Conversions button to initiate file conversion according to the sort sequence that you have established. You can convert only files whose status is shown as Not Conv.

NOTE: The Conversion Utility does not require the AppBuilder to be running because the utility converts by parsing the code; the files are not loaded into the AppBuilder. However, the application databases should be connected.

The Conversion Process

The Conversion Utility executes by performing the following steps:

  1. The utility moves the files from their current directory structure to a similar structure with a root name V8–ADM. V8–ADM is a subdirectory of the root directory originally defined in the Directory fill-in field in the upper portion of the utility window. Note that this structure will always be created. If it already exists, it will be overwritten.
  2. NOTE: As previously noted, it is essential that you make a backup copy of all source files before you attempt a conversion.

  3. As each file is converted, the utility changes its status from Not Conv to ..., and concludes with xxx–changes.
  4. If an error occurs during the conversion process, the utility displays an error alert box that identifies the problem and prompts you to either stop the process (that is, do not attempt to perform any more file conversions) or continue with more files. Regardless of your choice, the utility attempts to convert the file that caused the error and marks its code with an &MESSAGE statement. The statement indicates that a problem occurred during the conversion of the file and notes that the file must be adjusted manually. (Most files require some manual intervention after conversion.) This message displays each time you compile the file, flagging it as untrustworthy until you correct the problem manually.
  5. Once the conversion is complete, the utility replaces each original file that was copied to the V8–ADM directory structure with the corresponding converted file.
NOTE: To abort conversion processing, press the Abort Conversions button. The Conversion Utility finishes processing only the current file, stopping before the next scheduled file.

The following figure shows how the Conversion Utility window might look once the conversion process is complete:

Table B–4 identifies and describes possible status labels in this window.

Table B–4: Conversion Status Labels Displayed in the Browser 
Status
Description
No-change
The file has been converted, but no changes were made.
...
The conversion process is currently taking place.
xxx-changes
The file has been converted and some number of changes were made. (The xxx represents a numeric value that identifies how many conversion-related changes were made to a given file.)
Comp.Err.
After the conversion attempt, the compiler found some errors.
Version 9
The Conversion Utility determined that the file was either previously converted, or was built as a Version 9 file and therefore no conversion attempt was made.

Errors and the Conversion Utility Log File

The Conversion Utility cannot handle all coding styles and possible code constructs. These situations require manual intervention. To facilitate this, the utility generates a log file named V89conv.log in your working directory. This log identifies what procedures were converted, approximately how many changes were made to the file, whether the file was compiled, and if the compiler encountered errors. Also, if the Conversion Utility determines that it had difficulty converting a procedure, this log attempts to capture that information and report where the problem occurred. For information on modifying the Conversion Utility, see the "Customizing the Conversion Utility" section.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095