Using command line arguments

You can append command line arguments (also referred to as flags) to the initial modelerclient command to alter the invocation of IBM® SPSS® Modeler.

Several types of command line arguments are available, and are described later in this section.

Table 1. Types of command line arguments
Argument type Where described
System arguments See the topic System arguments for more information.
Parameter arguments See the topic Parameter arguments for more information.
Server connection arguments See the topic Server connection arguments for more information.
IBM SPSS Collaboration and Deployment Services Repository connection arguments See the topic IBM SPSS Collaboration and Deployment Services Repository Connection Arguments for more information.
IBM SPSS Analytic Server connection arguments See the topic IBM SPSS Analytic Server connection arguments for more information.

For example, you can use the -server, -stream and -execute flags to connect to a server and then load and run a stream, as follows: 

modelerclient -server -hostname myserver -port 80 -username dminer 
-password 1234 -stream mystream.str -execute

Note that when running against a local client installation, the server connection arguments are not required.

Parameter values that contain spaces can be enclosed in double quotes—for example:

modelerclient -stream mystream.str -Pusername="Joe User" -execute

You can also execute IBM SPSS Modeler states and scripts in this manner, using the -state and -script flags, respectively.

Note: If you use a structured parameter in a command, you must precede quotation marks with a backslash. This prevents the quotation marks being removed during interpretation of the string.

Debugging command line arguments

To debug a command line, use the modelerclient command to launch IBM SPSS Modeler with the desired arguments. This enables you to verify that commands will execute as expected. You can also confirm the values of any parameters passed from the command line in the Session Parameters dialog box (Tools menu, Set Session Parameters).