usd.exe command

Previous Next

Starts a USoft application, or starts a user application built with USoft.

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 repository tables are stored in a different database account than the application tables.

To be used in combination with the -app option if you are NOT using the -ddfile option.

You only need this option if you have repository tables and application tables in different accounts.

This corresponds to the "Separate Properties for Repository and Application" option on the Project Properties, Database tab of USoft Binder.

-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 the MS SQL Server database platform.

-oracle

Specifies the Oracle database platform.

-owner name

Specifies the database user who is the owner of the application tables at RDBMS level.

You only need to use this option if this is a different database user from the user that you log on with (identified by -u or -user).

-password name

or:

-pw name

Specifies your RDBMS password. Use this option in combination with -u (username).

You only need to use these options if you want to log in automatically.

-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-path

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.

-user name

or:

-u name

Specifies your RDBMS username. Use this option in combination with -pw (password).

You only need to use these options if you want to log in automatically.

-xrm

Specifies a resource.