Purpose

The paspropconv tool 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 instance's bin directory 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 Learn About Migrating Classic AppServer Applications to PAS for OpenEdge in 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 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, specify the name of your PAS for OpenEdge instance.
--pasoeWebAppName
It is an optional parameter. 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 will be migrated to the ROOT ABL web application.
--pasoeMergeFile
It is an optional parameter. 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 will be named as pasoeAppName.ubrokername.oemerge .
--pasoeSetEnvFile
It is an optional parameter. 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).
--convNotesDBFile
It is an optional parameter. Specify the name of the file. This file is generated on running paspropconv . By default, the generated file will be named as paspropconv_notesdb.en .
--logFile
It is an optional parameter. Specify the name of the paspropconv tool's log. By default, the log is named as paspropconv.log .
--loggingLevel
It is an optional parameter. 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
It is an optional parameter. 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
It is an optional parameter. 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.