[[:en:v3:vistraxadmin:systemmenue|BACK]] \\ \\ \\ ====== CHAPTER 3: Special Functions ====== ===== Command Line Parameters ===== vistrax Admin supports various command line parameters that can be given when the program starts. Please quote all parameter values containing whitespaces. === 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] Examble: vistrax Admin.exe -database:"silent" -dbdriver:"msoledbsql" -dbauthmode:"server" -dbserver:"localhost" -dbport:"1433" -dbname:"VISTRAX" -dbuser:"sa" -dbencryption:"auto" -dbpacketsize:4096 **Administrator rights are required. ** **The password must be entered during each login and will not be saved ** === Encryption of Passwords === 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: vistrax Admin.exe -cryptpassword:"VxAdmin4DB!" === 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 16 MAINTENANCE ACTIVE USER CANCEL 17 CRYPTAPI FAILED 21 DB ACCESS FAILED 22 MESSAGE INITIALIZATION FAILED 23 TIMEZONE INITIALIZATION FAILED 24 MAIN THREAD INITIALIZATION FAILED \\ \\ [[:en:v3:vistraxadmin:systemmenue|BACK]] \\ \\