CHAPTER 3: Special Functions

vistraxAdmin supports various command line parameters that can be given when the program starts. Please quote all parameter values containing whitespaces.

Sets the database configuration at startup and optionally displays the data. The dialog will be displayed if only -database is given (without additional parameters). The “silent” option suppresses any dialogs and all error messages, afterwards vistrax Admin terminates immediately. The “config” option shows any dialogs and all error messages, but afterwards vistrax Admin terminates immediately.

Parameters:

-database:["silent"|"config"]
-dbdriver:["msoledbsql"|"sqloledb"]
-dbauthmode:["server"|"windows"]
-dbserver:[hostname|ip]
-dbport:[port]
-dbname:[catalog]
-dbuser:[database login]
-dbencryption:["disabled"|"auto"|"forced"|"forcednocert"]
-dbpacketsize:[packet size]

Examble:

vistraxAdmin.exe -database:"silent" -dbdriver:"msoledbsql" -dbauthmode:"server" -dbserver:"localhost" -dbport:"1433" -dbname:"VISTRAX" -dbuser:"sa" -dbencryption:"auto" -dbpacketsize:4096

Encrypts the given password and outputs the result to the MS-DOS shell. vistrax Admin terminates immediately. The encrypted password can be used as a parameter value for -dbcryptedpassword in vistrax and vistraxWelcome. This prevents a usage or a transmission of the password in plain text.

Parameters:

-cryptpassword:[password]

Example:

vistraxAdmin.exe -cryptpassword:"VxAdmin4DB!"

The return values can be evaluated by processing the MS-DOS shell environment variable %ERRORLEVEL%. A value unequal 0 will be returned, if the application call fails.

0 OK
1 RUNTIME FAILED
2 SOCKET FAILED
3 OLE FAILED
4 LICENSE FAILED
5 COMXML4 FAILED
6 DB UNAVAILABLE
7 LOGIN FAILED
8 DB MANDATOR WRONG VERSION
9 DB MANDATOR FAILED
10 DB MAINFRAME FAILED
11 DB SHELLCOMMAND FAILED
12 NO ADMIN PRIVILEGE
13 DB MAIN FAILED
14 INSTALLATION INVALID
15 SESSION ALREADY RUNNING
16 MAINTENANCE ACTIVE USER CANCEL
17 CRYPTAPI FAILED