The paspropconv tool or utility is introduced in OpenEdge 11.7.3. It is useful for migrating application logic from a Classic AppServer to a Progress Application Server for OpenEdge (PAS for OpenEdge) instance. The tool takes as input the properties of a Classic AppServer from either a ubroker.properties file or a .merge file (created using the mergeprop utility) and generates several files, including:
pasoename.ubrokername.oemerge — This file contains two sections. The first section explains all the conversions made while adapting the Classic AppServer properties to PAS for OpenEdge. It also indicates properties that were not adapted, properties that you should review and modify, and other important information. Please take time to read this section. The second section can be used to add the new values to your PAS for OpenEdge instance using the oeprop utility.
pasoeAppName_setenv.sh and pasoeAppName_setenv.bat — These environment files are generated if there is a corresponding [Environment.ubrokerName] section in the ubroker.properties or the .merge file. Copy the platform-specific file to the bin directory of the instance to have the environment variables read at the time your PAS for OpenEdge instance starts.
paspropconv.log — Review this file for any errors that may have occurred during the conversion process.
paspropconv_notesdb.en — This file is used to create the comments section of the pasoename.ubrokername.oemerge file. Presently, it is available only in English.
Note: The paspropconv utility requires $DLC/bin/mergeprop.bat to work. Therefore, it is bundled with the Classic AppServer in OpenEdge 11.7.3. If you are using an earlier version of the Classic AppServer, use the mergeprop -listall command to create a .merge file. Then, you can use the .merge file for conversion using paspropconv.
For more information, see Progress Application Server for OpenEdge: Quick Start Guide.
Specify the absolute path of the ubroker.properties file. This parameter is required, unless you use ubrokerMergeFile.
--ubrokerName UBroker.AS.ubrokername
Specify the fully qualified name of the AppServer broker (UBroker.AS.brokername).
--ubrokerMergeFile name-of-the-ubroker-merge-file
Specify the absolute path of the ubrokerMergeFile that is generated using mergeprop. This parameter is required, unless you use ubrokerPropsFile.
--pasoeAppName ABL-application-name
Specify the name of the ABL application to which you want to migrate your application logic. If you want to migrate the application logic to the default ABL application, specify the name of your PAS for OpenEdge instance.
--pasoeWebAppName ABL-web-app-name
Specify the name of the ABL web application, inside the ABL application that you already specified, to which you want to migrate your application logic. By default, the application logic is migrated to the ROOT ABL web application.
--pasoeMergeFile pasoe-merge-filename
Specify the name of the file that is one of the expected file outputs of running the paspropconv tool. You will subsequently merge the contents of this file with your PAS for OpenEdge instance's openedge.properties file. By default, the file is named as pasoeAppName.ubrokername.oemerge.
Specify the name of the file that you will later copy to the PAS for OpenEdge instance's bin folder, so that environment variables are properly set when the instance is started or restarted. This file is generated on running paspropconv. By default, the generated files are named as pasoeAppName_setenv.sh/.bat (for UNIX/Windows).
Specify the name of the file that will have the conversion notes. This file is generated on running paspropconv. By default, the generated file is named as paspropconv_notesdb.en.
--logFile log-filename
Specify the name of the paspropconv tool's log. By default, the log is named paspropconv.log.
--loggingLevel logging-level
This parameter determines how much information is captured in the tool's log. Possible values are 0, 1, 2, 3, 4, and 5. By default, the parameter is set to 2.
--logAppend 0-or-1
This parameter determines whether information captured for every execution of paspropconv replaces the existing information in the log or appends to the end of the log. If you want information replaced, specify 0. If you want information appended, specify 1, which is the default value.
--mergepropExe name-of-mergeprop-utility
Specify the full pathname of the mergeprop utility, if you are not using the default location (install-dir/bin/mergeprop.bat). The default value is mergeprop.
--help
If you need help with the paspropconv tool, run paspropconv --help to see the complete list of parameters available with the tool.
Note: You must prefix each parameter listed above with a double dash (--), otherwise the command will not work.
pasoename.ubrokername.oemerge — This file contains two sections. The first section explains all the conversions made while adapting the Classic AppServer properties to PAS for OpenEdge. It also indicates properties that were not adapted, properties that you should review and modify, and other important information. Please take time to read this section. The second section can be used to add the new values to your PAS for OpenEdge instance using the oeprop utility.