The paspropconv tool migrates 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. It is important 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 instance's bin directory to have the environment variables read when 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: Use the file to create the comments section of the pasoename.ubrokername.oemerge file. Currently, 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 release 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 Migrate Classic AppServer Applications to PAS for OpenEdge.

Syntax

paspropconv --ubrokerPropsFile absolute-path-of-ubroker.properties 
--ubrokerMergeFile name-of-the-ubroker-merge-file --ubrokerName 
UBroker.AS.ubrokername --pasoeAppName ABL-application-name 
--pasoeWebAppName ABL-web-app-name --pasoeMergeFile pasoe-merge-filename
pasoeSetEnvFile name-of-setting-evn-variables-file 
convNotesDBFile name-of-the-file-containing-conversion-notes 
--logFile log-filename --loggingLevel logging-level 
--logAppend 0-or-1 mergepropExe name-of-mergeprop-utility
--help

Parameters

--ubrokerPropsFile
Specify the absolute path of the ubroker.properties file. This parameter is required, unless you use ubrokerMergeFile.
--ubrokerMergeFile
Specify the absolute path of the ubrokerMergeFile that is generated using mergeprop. This parameter is required, unless you use ubrokerPropsFile.
--ubrokerName
Specify the fully qualified name of the Classic AppServer broker (UBroker.AS.brokername).
--pasoeAppName
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, then specify the name of your PAS for OpenEdge instance.
--pasoeWebAppName
(Optional) 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
(Optional) 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 pasoeAppName.ubrokername.oemerge.
--pasoeSetEnvFile
(Optional) 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 pasoeAppName_setenv.sh/.bat (for UNIX/Windows).
--convNotesDBFile
(Optional) Specify the name of the file. This file is generated on running paspropconv. By default, the generated file will be named paspropconv_notesdb.en.
--logFile
(Optional) Specify the name of the paspropconv tool's log. By default, the log is named paspropconv.log.
--loggingLevel
(Optional) 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
(Optional) This parameter determines whether information captured for every execution of paspropconv replaces the existing information in the log or appends it to the end of the log. If you want information replaced, then specify 0. If you want information appended, then specify 1, which is the default value.
--mergepropExe
(Optional) Specify the full pathname of the mergeprop utility, if you are not using the default location (oe-install-dir/bin/mergeprop.bat). The default value is mergeprop.
--help
If you need help with the paspropconv tool, then run paspropconv --help to see the complete list of parameters available with the tool.