How You Can Delete All Versions of a Component

You can use the Workbench's Delete menu command to delete components. For more information about using Delete, see Delete Applications and Components.

You can also use the PurgeApp utility to purge all the numbered versions of a component that are not included in any application versions.

Delete all Numbered Versions of a Component Using the PurgeApp Utility

The fastest method of accessing the PurgeApp utility is from OpenROAD Workbench.

1. Select the component you want to delete in the Applications portlet of the Develop tab.

3. (Optional) Select the Execute in Background option if you want to run the utility as a new process. Then specify any of the other options described in Parameters for the PurgeApp Utility.

Note: You can set defaults for this utility using the Set Tool Defaults dialog. see Set Defaults.

The following describes the parameters for the PurgeApp utility:

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

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

Lets you control display of the Trace window by entering one of the following values:

Specifies that the Trace window does appear

Specifies that the Trace window appears but suppresses informational messages output by the system

Specifies that the Trace window appears minimized as an icon

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.

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.

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.

Command Line Method of Deleting Numbered Component Versions (PurgeApp)

The PurgeApp utility lets you remove all component versions in your application that are not included in any of your application versions. You may delete only numbered versions using this utility.

To purge your application components, start the PurgeApp utility from the command line using the following command:

w4gldev purgeapp database application [-nowindows] [-uusername] [-Lfilename]
[-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 from which you want to purge components

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.

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.