Workbench User Guide : 16. Managing and Deploying Applications : How You Can Create an Application Image : Use the MakeImage Utility
 
Share this page                  
Use the MakeImage Utility
The easiest way to use the MakeImage utility is to access it from the Develop tab.
To use the MakeImage utility
1. Select the application you want to image in the Applications portlet of the Develop tab.
2. Click Project, Image.
The Make Image dialog appears.
3. Set parameters for the specified application.
See the descriptions for each of these parameters in Parameters for the MakeImage Utility.
4. Click Go.
Parameters for the MakeImage Utility
You can specify the following parameters using the Make Image dialog:
Output File
Specifies the name of the image file to create. Image files end with the extension .img. Click Browse to display a standard File Selection dialog.
Included Applications Override (-i)
Specifies the filename of the file that lists the applications to include when imaging this application.
Click Browse to display a standard File Selection dialog to select the override file to use. For more information about the format of override files, see How You Can Image Included Applications.
Application Name Override (-a)
Specifies a new name for the application image file
Library (-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 resulting 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.
Force Compilation (-f)
Forces recompilation of all application components, even those that have not been changed since the last compilation
Display Errors (-e)
Causes OpenROAD to write the component's 4GL script and any errors to the Trace window, if any component has compilation errors
Treat Warnings as Errors (-w)
Instructs OpenROAD to treat compiler warnings as errors.
Generate SCPs (-s)
Causes OpenROAD to generate Service Call Procedures for the application before making an image
Generate SCP Metadata (-m)
Causes OpenROAD to generate SCP metadata for the application before making an image
Metadata Interface Name (-n)
Lets you enter a metadata interface name if you select Generate SCP Metadata. OpenROAD supplies a default name.
Metadata Interface Version (-r)
Lets you enter a metadata interface version if you select Generate SCP Metadata. OpenROAD supplies a default version.
Username (-u)
Lets you use this command as if you were another user, username.
You, not username, own all files created by OpenROAD.
This entry field can be used only if Execute in Background is enabled.
Log Path (-L)
Specifies the name of a log file. This entry field can be used only if Execute in Background is enabled and Trace Window is set to Yes. If the log path specified is not a full path, the file is created in the ingres\files directory.
Trace Window (-T)
Lets you control display of the Trace window by entering one of the following values:
All
Specifies that the Trace window does appear
Yes
Specifies that the Trace window appears but suppresses informational messages output by the system
Yes (Minimized)
Specifies that the Trace window appears minimized as an icon
No
Specifies that the Trace window does not appear, and a log file is not created
Note:  This entry field can be used only if Execute in Background is enabled.
Append to Log File (-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.
Execute in Background
Begins a new process while you are using this utility.
If enabled, Execute in Background makes Username, Log Path, Trace Window, and Append to Log File available for use.
Note:  You can set defaults for this utility using the Set Tool Defaults dialog. see Set Defaults.