16. Managing and Deploying Applications : How You Can Create an Application Image : Command Line Method for Creating an Application Image : Parameters for the MakeImage Command Line Utility
 
Share this page                  
Parameters for the MakeImage Command Line Utility
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.
-uusername
Lets you use this command as if you were another user, username.
Note:  You, not username, own all files created by OpenROAD.
-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 (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.
This flag corresponds to the Library option on the Make Image dialog box. For more information, see Use the MakeImage Utility.
-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 (see Use the MakeImage Utility).
-i
Specifies the name of the application for which an image will be generated.
This flag corresponds to the Included Applications Override field on the Make Image dialog box. For more information, see Use the MakeImage Utility (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 (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 (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 (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 (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
This flag corresponds to the Trace Window field on the Make Image dialog box. For more information, see Use the MakeImage Utility (see Use the MakeImage Utility).
-A
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.
This flag corresponds to the Append to Log File option on the Make Image dialog box. For more information, see Use the MakeImage Utility (see Use the MakeImage Utility).