Parameters for the ImportComp Utility
You can specify the following parameters using the Import a Component dialog:
Input File
Specifies the path and name of the file from which the component is being imported. Click Browse to display a standard File Selection dialog.
Component Name (-c)
Specifies the name of the component that is to be created or merged into
Input File Format
Specifies the format of the application file to be imported:
EXP
Specifies the OpenROAD proprietary ASCII format
XML (-xml)
Specifies XML format
Any
Allows OpenROAD to determine the format of the application file. OpenROAD first tries to import using its proprietary format; if this fails, it imports using XML format.
Name Conflict (-n)
Specifies how to treat name conflicts with 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
Display Errors (-e)
If any component has compilation errors, causes OpenROAD to write the component's 4GL script and any errors to the Trace window
Force Compilation (-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.
Username (-u)
Lets you use this command as if you were another user, username. This entry field can be used only if Execute in Background is enabled.
Note: You, not username, own all files created by OpenROAD.
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 %II_SYSTEM%\ingres\files.
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 (see
Set Defaults).