Workbench User Guide : 16. Managing and Deploying Applications : How You Can Create Application Versions Using the VersionApp Utility : Parameters for the VersionApp Utility
 
Share this page                  
Parameters for the VersionApp Utility
You can specify the following parameters on the command line or using the Version dialog in the VersionApp utility:
Remark (-r)
Defines a remark for the application version
Checked In (-w)
Specifies how to handle the saved versions of components that have been changed since you created the last highest version number of that component:
Ignore
Directs OpenROAD to ignore the saved versions and include the highest numbered version of the components. This option fails if there are no numbered versions of the component.
Version
Directs OpenROAD to save the working version of the component as a numbered version and include it in the application version
Default: Version
Private Versions (-p)
Specifies how to handle your private versions of components in the application:
Abort
Directs OpenROAD to abort the command if there are private versions
Ignore
Directs OpenROAD to ignore the private versions and use the highest numbered version of the component in this version of the application
Version
Directs OpenROAD to save all your private versions and give them version numbers
Default: Abort
Force Compilation (-f)
Forces compilation of all components in the version
Ignore Locks (-l)
Unlocks any locked versions of components
Username (-u)
Only the database administrator for the database, the Ingres system administrator, or a superuser can use this parameter.
Lets you use this command as if you were another user, username.
You, not username, own all files created by OpenROAD.
This entry field can be used only if Execute in Background is enabled.
Log Path (-L)
Specifies the name of a log file. This entry field can be used only if Execute in Background is enabled and Trace Window is set to Yes. If the log path specified is not a full path, the file is created in the ingres\files directory.
Trace Window (-T)
Lets you control display of the Trace window by entering one of the following values:
All
Specifies that the Trace window does appear
Yes
Specifies that the Trace window appears but suppresses informational messages output by the system
Yes (Minimized)
Specifies that the Trace window appears minimized as an icon
No
Specifies that the Trace window does not appear, and a log file is not created
Note:  This entry field can be used only if Execute in Background is enabled.
Append to Log File (-A)
Appends the trace output of the current command to the end of the existing error log file. Otherwise, that log file is replaced. This entry field can be used only if Execute in Background is enabled.
Note:  The error log file, w4gl.log, is located in %USERPROFILE%\AppData\Local\OpenROAD\Profiles\installation_ID. If the -L flag is passed, a new name and location can be provided for the OpenROAD log file.
Execute in Background
Begins a new process while you are using this utility.
If enabled, Execute in Background makes Username, Log Path, Trace Window, and Append to Log File available for use.
Note:  You can set defaults for this utility using the Set Tool Defaults dialog. see Set Defaults.