Command Line Method for Renaming an Application (RenameApp)
You can use the RenameApp utility to rename existing applications and components. Start the RenameApp utility by entering the following command at the command line:
w4gldev renameapp database application newname [-ccomponent]
[-nowindows] [-uusername]
[-T{yes|yes,min|yes,logonly|all|all,min|all,logonly|no}] [-Ttitletitle] [-A]
The following parameters and flags are available from the command line:
database
Specifies the name and location of the database in which the application resides
application
Specifies the name of the application to rename if -ccomponent is not specified. If -ccomponent is specified, specifies the name of the application in which the component resides.
newname
Specifies the new name of the application or component
-ccomponent
If specified, indicates the component to be renamed with newname
-nowindows
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.
-uusername
Lets you use this command as if you were another user, username.
Note: You, not username, own all files created by OpenROAD.
-T
Controls the display of the Trace window by entering one of the following values:
yes
Specifies that the Trace window appears but suppresses all informational system messages
yes,min
Specifies that the Trace window appears minimized as an icon, and all informational system messages are suppressed
yes,logonly
Specifies that the Trace window does not appear, but all messages are saved in a log file without informational system messages
all
Specifies that the Trace window does appear and all messages are written
all,min
Specifies that messages are written to the Trace window, which appears minimized as an icon
all,logonly
Specifies that the Trace window does not appear, but all messages are saved in a log file
no
Specifies that the Trace window does not appear, and no log file is created
-Ttitletitle
Replaces the title of the OpenROAD Trace window with title. If the title contains spaces, you must enclose it with single or double quotes.
-A
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.
Last modified date: 12/20/2023