Command Line Method of Importing an Application from a File

To import an application from a file, start the backup app utility from the command line:

w4gldev backupapp in database application file
          [-xml] [-uusername] [-e] [-f]
          [-n{prompt|abort|replace|version}] [-m] [-t]
          [-T{yes|yes,min|yes,logonly|all|all,min|all,logonly|no}] [-A]

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

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

Specifies the name of the application to import

Specifies the name of the file from which the application or component is being imported

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.

Specifies that the component's 4GL script and any errors should be written to the Trace window, if any component has compilation errors

Forces compilation of the application components before they are loaded into the database.

If there is a compilation error, the component is still loaded into the database, but is marked as “out of date.”

If you do not include this parameter, components are copied into the database marked “out of date,” and are compiled the first time you compile or run the application.

Specifies how to treat name conflicts. The option can be one of the following values:

Directs OpenROAD to abort this utility and to back out any components that were already added

Replaces the old component with the new component

Specifies that if an application or application component being imported already exists, the existing application or component is versioned before being replaced

Merges the components from the input file into the existing application

Specifies that transactions are committed after each component is added to the database

Important! Using this parameter decreases contention and log file use. However, if your database server crashes or the ImportApp utility is aborted before completion, only some of the application components are loaded.

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.