Command Line Method for Compiling Applications (CompileApp)
To access the CompileApp utility, enter the following command at the command line:
w4gldev compileapp database application [-nowindows] [-ccomponent]
[-uusername] [-Lfilename] [-e] [-f] [-l] [-w] [-wopen] [-js filepath]
[-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 compile
-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.
-ccomponent
Specifies the name of a component to compile
-uusername
Lets you use this command as if you were another user, username.
Note: You, not username, own all files created by OpenROAD.
-Lfilename
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. You may include the following replacement parameters in the file name.
%p
Replaced by the Process Identifier (PID)
%d
Replaced by the current date in YYYYMMDD format
%t
Replaced by the current time in HH_MM_SS format
-e
Specifies that the component's 4GL script and any errors should be written to the Trace window, if any component has compilation errors
-f
Forces recompilation of all application components, even those that have not been changed since the last compilation.
If you are compiling a single component (with the -ccomponent parameter), this parameter forces compilation of the specified component.
-l
Ignores locks (unlocks any locked components)
-w
Instructs OpenROAD to treat compiler warnings as errors
-wopen
Produces a warning error at compilation time for any SQL statement that is not compliant with OpenSQL
-js filepath
Converts the 4GL modules into JavaScript modules, storing them in the specified file path. If you use -js without the -c (component) flag, all modules in the application will be transpiled (compiled and translated) into JavaScript. The -js flag implicitly forces 4GL modules to be recompiled, thus you need not specify -f (forcecompile). If the 4GL code cannot be compiled successfully for a component, no JavaScript will be generated for it. For more information on transpiling JavaScript from 4GL, see
How You Can Transpile JavaScript Modules from Your 4GL Components and Applications.
-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. An error exit code can be returned when a compilation warning is issued and the -w (warnings as errors) flag is set.
Last modified date: 12/20/2023