Command Line Method for Creating an Application Image (MakeImage)
To create an application image, start the MakeImage utility by entering the following command at the command line:
w4gldev makeimage database application file [-nowindows][-uusername]
[-f] [-l] [-vversion] [-aappname] [-e] [-w] [-ifilename]
[-Lfilename] [-s] [-m] [-nappname] [-rversion]
[-T{yes|yes,min|yes,logonly|all|all,min|all,logonly|no}] [-Ttitletitle] [-A]
You can specify the following parameters using the w4gldev makeimage command line utility:
database
Specifies the name and location of the database in which the application resides
application
Specifies the application that you want to make an image of
file
Specifies the name of the image file to create. Image files end with the extension .img.
-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.
-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
-f
Forces recompilation of all application components, even those that have not been changed since the last compilation.
This flag corresponds to the Force Compilation option on the Make Image dialog. For more information, see
Use the MakeImage Utility.
-l
Causes all components of the application, including non-executable components (that is, include scripts, field templates, and frame templates) to be included in the generated image file. Such an image file is sometimes referred to as an “application library” and can be used as a library of templates during development.
-vversion
Specifies which version of the application to use when creating the image file. Because the -m and -s flags can generate SCP calls and SCP meta data only for the current working version of an application, the -s and -m flags are ignored when -v is specified, and a warning message is generated.
-aappname
Renames the application in the image file to appname
-e
Causes OpenROAD to write the component's 4GL script and any errors to the Trace window, if any component has compilation errors.
This flag corresponds to the Display Errors option on the Make Image dialog box. For more information, see
Use the MakeImage Utility.
-w
Instructs OpenROAD to treat compiler warnings as errors.
-i
Specifies the filename of the file that lists the applications to include when imaging this application.
This flag corresponds to the Included Applications Override field on the Make Image dialog box. For more information, see
Use the MakeImage Utility.
-s
Note: Causes OpenROAD to generate Service Call Procedures and include them in the application. For example:
w4gldev makeimage corsac::apped4fs myasoapp myasoapp.img -s -Tall
This flag corresponds to the Generate SCPs option on the Make Image dialog box. For more information, see
Use the MakeImage Utility.
-m
Causes both Service Call Procedures and SCP metadata to be generated and included in the application image file. For example:
w4gldev makeimage corsac::apped4fs myasoapp myasoapp.img -m -Tall
This flag corresponds to the Generate SCP Metadata option on the Make Image dialog box. For more information, see
Use the MakeImage Utility.
-nappname
Causes the specified ASCII text name to be used as the interface name for the SCP metadata. By default, the interface name is the application name. For example:
w4gldev makeimage corsac::apped4fs myasoapp myasoapp.img -m -nmyapp
This flag corresponds to the Metadata Interface Name field on the Make Image dialog box. For more information, see
Use the MakeImage Utility.
-rversion
Causes the specified version number (ASCII text) to be used as the metadata interface's version for the SCP metadata. By default, the interface version is -1 (working version). For example:
w4gldev makeimage corsac::apped4fs myasoapp myasoapp.img -m -r1.1
This flag corresponds to the Metadata Interface Version field on the Make Image dialog box. For more information, see
Use the MakeImage Utility.
-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
The -T flag corresponds to the Trace Window field on the Make Image dialog box. For more information, see
Use the MakeImage Utility.
-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.
This flag corresponds to the Append to Log File option on the Make Image dialog box. For more information, see
Use the MakeImage Utility.
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.