Analytica Command Line

The desktop Analytica.exe process is launched with a command line having the format:

Analytica.exe [options] [filename]

The brackets mean that these are optional. When filename has one or more spaces, you need to put double quotes around the filename. Or, you can put double quotes around the filename even if it doesn't have spaces. The filename will usually have the extension *.ana. When no filename is specified, Analytica launches to the intro screen. When a filename is specified, it loads that model file.

Options

Each option can be prefixed either with a forward slash, /, or with a minus, -. Option values appear after a colon. There can be no spaces within the option or its value. When an option value contains a space, the option value must be quoted using double quotes.

• /rlmDiag:filename: Writes diagnostic information about licenses to filename. This is very useful if you are encountering problems with a license that you believe has been activated, but is not working. After launching Analytica with this option, exit Analytica and either review the log file in a text editor, or email the diagnostic file to support@lumina.com for assistance. The diagnostic file logs the information about licenses that it finds on your computer, and hence is very useful for debugging license problems.

  Example usage: Analytica.exe /rlmDiag:"c:\Temp\rlmDiag.log"

• /roam:days: Specifies the number of days to roam a floating license. Or, if days is -1, it releases a roamed license. See License Roaming.

  Example usage: Analytica.exe /roam:7

• /lic:licenseName: Uses the specified license name without changing which license is selected by default. The license must already be activated (i.e., the license must be in your C:\ProgramData\Lumina\Licenses folder).

  Example: Analytica.exe /lic:analytica_optimizer_761_2

• /rlm:server: Specifies the server name (or port@serverName) that is running a Reprise License Manager with the desired centrally managed (e.g., floating) license.

• /eval:expression: (new to Analytica 6.0). Specifies an Analytica expression that is evaluated immediately after the model file that is specified on the command line finishes loading. The evaluating occurs after any proactively evaluated variables or buttons in the model. It does not dirty the model. The expression can include global variable assignments, and button identifiers. You will almost certainly want to include double quotes around the expression, and you need to escape any interior quotes by proceeding the quote with a backslash. The parameter is ignored if filename is not specified on the command line. See Running a model in a command line workflow.

• Example usage: Analytica.exe /eval:"Claimant=\"JDoe\";Run_Batch;Exit" "Claim analysis.ana"

  In this example, Claimant is the identifier of an input variable in the model and Run_batch and Exit are names of a buttons in the model.

• /comment:text: (new to Analytica 6.0) The text is a comment that is ignored by Analytica. In one example usage, ACP3 adds a comment to each spawned processes to differentiate them in task manager.

• /NoSplash: (new to Analytica 6.0) Don't show the splash screen at startup (which normally displays for 3 seconds).

The remaining options exist for internal purposes and aren't generally used by end-users:

• /embedding: The Windows operating system uses this parameter when launching Analytica as a OLE-link server. Not used by end-users. Causes Analytica to launch quietly (without a GUI), load an indicated model, and exposes key OLE interfaces to Windows enabling an external application to complete the link to the model's data.

• /solverDevLic: This parameter is sometimes used by Analytica developers, but not generally by end-users. It indicates that the licenses from Frontline Systems found in the Solver.lic file are developer licenses rather than runtime licenses.

• /forcerelease: This parameter is used by Analytica quality assurance engineers during beta testing periods. It causes a beta release to behave like a final release build with regard to licensing.

• /config:filename: This is an option used by ACP3 (by Suan.exe) and not in Desktop Analytica. The specified config file contains settings that define the ACP3 server configuration.

Accessing the Command line from a model

The expression GetProcessInfo('Command line') returns the command line used to launch the process.