═══ 1. The VisPro Conversion Utility ═══

The VisPro Conversion Utility allows you too easily convert your VX-Rexx 
projects to any one of the VisPro products that you select and are installed on 
your machine. 

For more information, look in help index under Getting started. 


═══ 2. Search Path ═══

The Search Path is the starting path for where you want to begin a search for 
any VX-Rexx projects.  By default, the VisPro Conversion Utility reads the 
setting in your CONFIG.SYS to determine where to start. 

If you want to specify another search path, you would delete anything within 
the Search Path entryfield and replace it with, for example:  C:\OS2. Once you 
have changed the Search Path, select the Search push button and the Project 
Container will show the search results. 


═══ 3. Project Container ═══

The Project Container displays a list of VX-Rexx project files (.VRP) that were 
located during either the initialization or for a search. 

You can double click on a project name, to open the Converting VX-Rexx project 
window 


═══ 4. Accept push button ═══

The Accept push button, takes the currently selected project within the Project 
Container, and opens the Converting VX-Rexx project window so that you may 
begin your conversion. 


═══ 5. Search push button ═══

The Search push button gets the contents of the Search Path and locates any 
project file (*.VRP) that it can find.  Once the search routine has completed 
it will display it's result in the Project Container. 


═══ 6. Converting VX-Rexx project window ═══

The Converting VX-Rexx project window displays the following items: 

      -project name that you are converting 
      -status of the conversion program (IDLE means that no action is being 
      executed) 
      -Convert push button which begins the conversion 
      -Cancel push button closes the Converting VX-Rexx project window 


═══ 7. Convert push button ═══

The Convert push button will convert the project that is listed within the 
Project Name entry field. 


═══ 8. Cancel push button ═══

The Cancel push button, closes the Converting VX-Rexx project window window, 
with no action being taken upon the project that is displayed within the 
Project name entry field. 


═══ 9. Project Name entry field ═══

The Project Name entry field displays the project that will be converted when 
the Convert push button is clicked. 


═══ 10. Limitations ═══

The following are some known limitations that you may run into with the VisPro 
Conversion Utility. 

-Add on objects.  The VisPro Conversion Utility will display a window which 
informs you of controls that are not supported when they are encountered.  If 
one of these controls are encountered, a push button will be displayed in their 
place with the add on objects events.  Some of these controls are: charts, DDE 
client, timer, image radio button, image pushbutton, query editor and 
connection. 

-Control data.  Control data is data that contains, for example, the number of 
cells in a value set or the maximum length of an entry field. 

-Form styles.  The form will always default to a plain window, with no modality 
set or information line tips set.  To change these in the VisPro products, open 
the form->settings and select the styles that you want from the Styles notebook 
page. 

Note:  VX-Rexx sometimes will not write out all of the data for a .VRT file. 
If you encounter a problem with the VisPro Conversion Utility, then go back to 
your VX project and save the projects windows to .VRT files again 


═══ 11. .VRT files ═══

A .VRT file, is a plain text file the VX-Rexx writes out to the filename that 
you have selected.  This file contains all the code for a particular window 
which includes objects, menus and sub-procedures.  The VisPro Conversion 
Utility uses these .VRT files to construct your VisPro project. 

Here is how you would create a .VRT file from the project view: 

      Select the Windows menu item 
      Select File List 
      Select the window that you want to save as a .VRT file 
      From the Files -- Project window, select the File menu 
      Select Save as Text... (any name is fine, as long as it has the .VRT 
      extension) 

 One of the files that should be converted, is the Main file window.  In order 
 to determine which is the Main file window from the project view: 

      Select the Run menu item 
      Select Run options 

 Note:  By pressing the F5 key, you will bypass the first two steps in creating 
 the .VRT file. 

 Note:  VX-Rexx sometimes will not write out all of the data for a .VRT file. 
 If you encounter a problem with the VisPro Conversion Utility, then go back to 
 your VX project and save the projects windows to .VRT files again 


═══ 12. Getting started ═══

The VisPro Conversion Utility is very easy to use.  If your projects are 
located within the VX-Rexx projects directory, then you press the Accept push 
button which opens the Converting VX-Rexx project window.  Select the Convert 
push button and the VisPro Conversion Utility takes the .VRP filename and 
creates a VisPro project with the same name.  The converted project, will be 
located within the VisPro projects directory depending upon which products you 
have selected for conversion.