Command Line Method of Importing Components from a File
To import one or more components from a file, start the BackupApp utility from the command line:
w4gldev backupapp in database application file [-nowindows]
[-ccomponent | -l] [-xml] [-uusername] [-e] [-f]
[-n{prompt|abort|replace|version}]
[-T{yes|yes,min|yes,logonly|all|all,min|all,logonly|no}] [-A]
The following parameters and flags are available from the command prompt:
in
Specifies the import mode of the BackupApp utility
database
Specifies the name and location of the database in which the application resides
application
Specifies the name of the application from which the component is being imported
file
Specifies the name of the file from which the component is being imported (.exp or .xml)
-ccomponent
Specifies the name of the component that is to be created or merged into
-l
Directs the ImportComp utility to treat the file parameter as the name of a file containing a list of component source files or component name and component source file pairings (separated by a comma)
-xml
Specifies XML format
-uusername
Lets you use this command as if you were another user, username.
Note: You, not username, own all files created by OpenROAD.
-e
Specifies that the component's 4GL script and any errors should be written to the Trace window, if any component has compilation errors
-f
Forces compilation of the application component before it is 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, the component is copied into the database marked “out of date,” and is compiled the first time you compile or run the application.
-noption
Specifies how to treat name conflicts. The option can be one of the following values:
prompt
Requests a prompt when there is a conflict
abort
Directs OpenROAD to abort this utility and to not import the component
replace
Replaces the old component with the new component
version
Specifies that if an application component being imported already exists, the existing application or component is versioned before being replaced
Default: abort
-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
-A
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.