Document Imaged Applications Using the QueryImage Utility

The QueryImage utility produces a report containing the following information about a binary image file:

• The name and properties of the application in the file (and any included applications)

• The names and properties of the components in each application

The easiest method of accessing the QueryImage utility is from the Develop tab.

3. Select the image file you want to query, and set parameters.

See the descriptions for each of these parameters in Parameters for the QueryImage Utility.

Note: QueryImage can be accessed from the Start menu or command prompt as described in Command Line Method for Documenting an Application Image.

You can specify the following parameters using the Query Image File dialog:

Specifies the name of the image file. Click Browse to display a standard File Selection dialog.

Specifies the name of file to which the report is to be written. Click Browse to display a standard File Selection dialog.

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.

Lets you control display of the Trace window by entering one of the following values:

Specifies that the Trace window appears but suppresses informational messages output by the system

Specifies that the Trace window appears minimized as an icon

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.

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.

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.

Command Line Method for Documenting an Application Image (QueryImage)

To generate a report on an application image, start the QueryImage utility by entering the following command at the command line:

w4gldev queryimage imagefile outfile [-nowindows] [-Lfilename]
[-T{yes|yes,min|yes,logonly|all|all,min|all,logonly|no}] [-A]

The following parameters and flags are available from the command line:

Specifies the name of the image file

Specifies the name of the file to which the report is to be written

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.

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.

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

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.