Invantive Query Tool Multi-Platform can be started with options on the command line. They are meant for a first start on a device without a licence and for the diagnosis of a start which does not come up; everything else is done in the window. An option is written as `/name` or `/name:value`. The forms `-name` and `--name` are accepted as well, and an equals sign may be used instead of the colon, so a command written for the Microsoft Windows products keeps working. Options are not case sensitive and may be given in any order. An argument which is no option of the product is ignored. ## Asking for the Usage ``` Invantive.QueryTool /help ``` The usage is written to the terminal that started the program and the program ends directly afterwards. `/?` and `/h` do the same, as do `-h` and `--help`. Started from the desktop or the dock there is no terminal to write to and nothing is shown, so ask for the usage from a terminal. Available from release 27.0. ## Registering a Licence A licence key can be handed over on the command line, which registers it on the device and uses it for this run: ``` Invantive.QueryTool /license-key:12345-67890-12345-67890-12345 ``` The same key can be provided through the environment variable `INVANTIVE_LICENSE_KEY`; the option takes precedence over the variable. Without either, the licence registered on the device is used, and when there is none the product asks for one; see [[Invantive Query Tool Multi-Platform/License Registration|License Registration]]. ## Diagnosing a Start Which Fails Three options exist for the diagnosis of a start which does not come up or of an editor which does not accept keyboard input: - `--gui-only`: start the user interface without starting the engine. No licence is checked and no database can be opened, so a window which appears with this option and not without it places the problem in the engine rather than in the user interface. - `--no-tm`: start without syntax highlighting in the editor. - `--diag`: report window activation, keyboard focus and the contents of the editor continuously on the status bar. Messages about problems during the start are written to the error output of the terminal, so start the product from a terminal when it does not come up. ## See Also - [[Invantive Query Tool Multi-Platform/Installation|Installation]] - [[Invantive Query Tool Multi-Platform/License Registration|License Registration]] - [[Environment Variables]]