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:
NOTE: As previously noted, it is essential that you make a backup copy of all source files before you attempt a conversion.- 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.
- As each file is converted, the utility changes its status from Not Conv to ..., and concludes with xxx–changes.
- 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.
- 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.
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 |