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}] [-A]

You can specify the following parameters using the w4gldev makeimage command line utility:

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

Specifies the application that you want to make an image of

Specifies the name of the image file to create. Image files end with the extension .img.

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.

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.

This flag corresponds to the Log Path option on the Make Image dialog. For more information, see Use the MakeImage Utility.

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.

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.

This flag corresponds to the Library option on the Make Image dialog. For more information, see Use the MakeImage Utility.

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.

Renames the application in the image file to appname

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.

Instructs OpenROAD to treat compiler warnings as errors.

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.

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.

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.

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.

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.

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

This flag corresponds to the Trace Window field on the Make Image dialog box. For more information, see Use the MakeImage Utility.

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.