Command Line Method of Creating Numbered Application Versions (VersionApp)

To create numbered versions of an application, start the VersionApp utility by entering the following command at the command line:

w4gldev versionapp database application [-nowindows] [-uusername] [-Lfilename]
    [-p{abort|ignore|version}] [-w{ignore|version}]
    [-rremark] [-f] [-l]
    [-T{yes|yes,min|yes,logonly|all|all,min|all,logonly|no}] [-A]

The following parameters and flags are available from the command line:

Specifies the name and location of the database in which the application resides

Specifies the name of the application to create a numbered version for

Lets the application run without the window manager running. This option does not provide full batch mode execution, because some interaction with the application still may be required through the Trace window.

Lets you use this command as if you were another user, username.

Note: You, not username, own all files created by OpenROAD.

Specifies the name of a log file. If the log path specified is not a full path, the file is created in the %II_SYSTEM%\ingres\files directory.

Specifies how to handle your private versions of components in the application. Options include:

Directs OpenROAD to abort the command if there are private versions

Directs OpenROAD to ignore the private versions and use the highest numbered version of the component in this version of the application

Directs OpenROAD to save all your private versions and give them version numbers

Specifies how to handle the saved versions of components that have been changed since you created the last highest version number of that component. Options include:

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.

Directs OpenROAD to save the working version of the component as a numbered version and include it in the application version

Defines a remark for the application version

Forces compilation of all components in the version

Ignores locks (unlocks any locked components)

Controls the display of the Trace window by entering one of the following values:

Specifies that the Trace window appears but suppresses all informational system messages

Specifies that the Trace window appears minimized as an icon, and all informational system messages are suppressed

Specifies that the Trace window does not appear, but all messages are saved in a log file without informational system messages

Specifies that the Trace window does appear and all messages are written

Specifies that messages are written to the Trace window, which appears minimized as an icon

Specifies that the Trace window does not appear, but all messages are saved in a log file

Specifies that the Trace window does not appear, and no log file is created

Appends the trace output of the current command to the end of the existing error log file.

Note: The error log file, w4gl.log, is located in %II_SYSTEM%\ingres\files.

An exit code of zero (0) means success; a non-zero exit code indicates an error.