usd.exe command

Previous Next

The table below lists the command line options available for use with the usd.exe command.

Option

Purpose

-A

Starts the Authorizer

-D

Runs the Definer. Works only in combination with the -ddfile option, because the repository of USoft Developer itself is only presented in a file.

-app <name>

Runs USoft Developer on the repository specified by <name>. USoft Developer will search for the repository in the <name>.CON file, and for the <name> resource files. Under X-Windows, these files must all be in the XAPPLRESDIR directory.

-d

Debug option.

-database <name>

Specifies which database is to be used. This parameter is mandatory for SQL Server (OLEDB) and for ODBC, and optional for Oracle, but USoft recommends you specify this parameter also for each Oracle connection.

-ddfile

Reads the repository from flat files instead of from your RDBMS. If you use this option, you must use the -app option to let USoft Developer know which files to look for.

-ddodbc

Reads the repository from an ODBC-enabled RDBMS.

-ddoracle

Reads the repository from the Oracle RDBMS.

-ddowner name

Specifies that the application must be run on a repository owned by another user than the one under whose name you log in. To be used in combination with the -app option if you are NOT using the -ddfile option.

-endusermsgs

Replaces all technical error messages with a standard message:

"internal error (code). Contact your system administrator"

-exe action

Executes the specified action when USoft Developer has been started. For example, to immediately start the Course table, run the following command:

 

usd.exe -exe table(COURSE)

-generate file-specification

Generates an ESI flat file from the command line. The option is followed by the file specification. For example:

 

usd.exe –generate C:\usd90\app\MYAPP.esi

This option does not create a GUI and exits the process after the file has been created..

-iconic

Iconizes USoft Developer immediately after it has been started. Useful in combination with the -exe option (UNIX only).

-messagesToFile

Specifies that all messages, including error messages at startup, are sent to the Messages.log file in the working directory.

-name name

Runs USoft Developer under the specified name. This name will be placed in the window's title bar. In resource files, you can use it to refer to a specific application. In this way, it is possible to have resources for different applications in the same USDIx file, e.g. to see the difference between the Definer and USoft Developer running on the application tables.

-nologin

Performs a dummy login. This is useful if you do not want to log on to the database, e.g. for test purposes.

If you specify this option, make sure that the application is read from flat files.

-odbc

Specifies that the application tables are in an ODBC enabled RDBMS.

-oledb

Specifies that connections are made via OLE DB; used by USoft to connect to Microsoft SQL Server V7.0.

-oracle

Specifies that the application tables are in the Oracle RDBMS.

-owner name

Specifies who the owner of the application tables is. You only need to use this, if another user owns the tables.

-password name, or

-pw name

Specifies your RDBMS password. You only need to use this option if you want to log in automatically. Use this option in combination with -u (username).

-r value

Specifies that all SQL statements must be written in the specified file. If the file already exists, the SQL statements will be appended. Use with -d.

-run -script-file-name

Executes the actions that are defined in the script file, and exits the application when the actions are finished.

-title name

Specifies the text displayed in the window's title bar. The difference with the -name option is that -title ONLY concerns the window's title.

-u name 

or:

-user name

Specifies your RDBMS username. You only need to use this option if you want to log in automatically. Use this option in combination with -pw (password).

-xrm

Specifies a resource.