BACK




CHAPTER 5: Special Functions

Command Line Parameters

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

Import of a License File

Imports a license file and terminates vistrax immediately. An error is returned if the license is invalid.

Attention!

Administrator rights are required.

Note

If there is only a license key as text, then a license file can be created by using the windows program notepad.exe. Start it, copy the text into the document and save it as a text file vistrax license.vxl.

Configuration of Database and LDAP Connections

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]

Example: 

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

ATTENTION!

Administrator rights are required.

Note

The password must be entered during each login and will not be saved

Return Codes

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



BACK