Kapitel 3: Sonderfunktionen

vistraxAdmin unterstützt verschiedene Kommandozeilenparameter, die bei Programmstart mitgegeben werden können. Umfassen Sie Parameterwerte unbedingt mit Anführungszeichen, sollten diese ein Leerzeichen enthalten.

Setzt die Datenbankkonfiguration beim Programmstart und zeigt die Daten wahlweise an. Die Option “silent” unterdrückt jegliche Dialoge und alle Fehlerausgaben, anschließend beendet sich vistrax Admin umgehend. Die Option “config” zeigt jegliche Dialoge und alle Fehlerausgaben an, anschließend beendet sich vistrax Admin umgehend.

Parameter:

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

Beispiel:

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

Verschlüsselt das angegebene Passwort und gibt das Ergebnis in der MS-DOS-Eingabeaufforderung aus. Danach beendet sich vistrax Admin umgehend. Das verschlüsselte Passwort kann mit dem Parameter -dbcryptedpassword in vistrax und vistraxWelcome verwendet werden. Dies vermeidet eine Ablage bzw. Übertragung des Passwortes in Klartext.

Parameter:

-cryptpassword:[password]

Beispiel:

vistraxAdmin.exe -cryptpassword:"VxAdmin4DB!"

Die Rückgabewerte lassen sich in der MS-DOS-Eingabeaufforderung (Konsole) durch Auswertung der Umgebungsvariable %ERRORLEVEL% behandeln. Im Fehlerfall wird ein Wert ungleich 0 zurückgegeben.

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