IBM SPSS Modeler Job Properties - General

By default, the General properties tab appears when you click an IBM® SPSS® Modeler stream in the job canvas.

The General properties tab contains the following information:

Job step name. The name of the job step. Typically, the name of the job step is the name of the IBM SPSS Modeler stream, appended with the suffix _step. However, you can modify the job step name.

To modify the name of the job step, type the revised name in the Job step name field. Your changes are reflected in the job canvas.

IBM SPSS Modeler Stream. The name and path of the original IBM SPSS Modeler stream. The source stream is not modifiable.

Override Type Use this option to specify whether the settings in either a job step or the node in a stream take priority during execution.
  • Job overrides stream If you select this option, when you execute the job, the node properties use the values that you set in the job step.
  • Stream overrides job Selecting this option disables the node property controls in the job step; the only exceptions are some of the credential controls. If you change the node properties in the stream, when you execute the job step, the changed node properties are used.
The Override Type options affect the credential settings in the following ways:
  • If you choose Job overrides stream, you can edit the credential selection controls, and your selected credentials take effect at run-time.
  • If you choose Stream overrides job, there are two possible cases:
    • When you create nodes in SPSS Modeler Client that use credentials, and if the authentication mode is Stored credential, and the credential name exists in IBM SPSS Collaboration and Deployment Services, the credential selection control is unavailable. However, if the credential name does not exist in IBM SPSS Collaboration and Deployment Services, you can use the credential selection control; your selected credentials take effect at run-time.
    • When you create nodes in SPSS Modeler Client that use credentials, if the authentication mode is Username and password, you can use the credential selection control; your selected credentials take effect at run-time.

Object version. The labeled version of the IBM SPSS Modeler stream to use. From the Object version drop-down list, select the labeled version that you want to use.

Iterative Variable List. If the step acts as an iterative consumer, identify the variable from the iterative producer providing the values for the step. An iterative producer step must appear immediately before the step in the job for the step to act as an iterative consumer.

IBM SPSS Modeler server. The IBM SPSS Modeler server or server cluster on which the stream will be executed. The list contains all servers and server clusters currently configured to execute IBM SPSS Modeler steps. To change the server, select from the IBM SPSS Modeler Server drop-down list. To create a new server definition, click New to launch the server definition wizard.

IBM SPSS Modeler login. The credential information used to access the IBM SPSS Modeler server or server cluster. To change the credentials, select a credential definition from the IBM SPSS Modeler Login drop-down list. To define new credentials, click New to launch the credentials definition wizard.

Content Repository Server. The content repository server allows a job to save files to an IBM SPSS Collaboration and Deployment Services Repository. Typically, the content repository server is specified when refreshing models using IBM SPSS Modeler. To specify a content repository server, select a server from the Content Repository Server drop-down list. To create a new server definition, click New to launch the server definition wizard. To generate a content repository server definition based on the current server information, click Generate. A server definition is created and automatically populated in the Content Repository Server field.

Content Repository Login. The login information for the content repository server. To specify a content repository login, select a credential from the Content Repository Login drop-down list. To create a new login, click New to launch the content repository login wizard. If single sign-on is not used to connect to the IBM SPSS Collaboration and Deployment Services Repository, click Generate to generate a content repository server login based on existing security settings. A content repository login is created and automatically populated in the Content Repository Login field. Login generation is not available when using single sign-on.

Warning expression. Define warnings for job steps connected by a Conditional connector. The warning expression (e.g., completion_code, warning, or success) must be lowercase.

To use warning expressions:

  1. Connect two job steps with a Conditional connector. In the Expression field for the conditional connector, type warning==true.
  2. Navigate to the General tab of the parent job step.
  3. In the Warning expression field, specify a warning code--for example, completion_code==18. This expression overrides the default warning code, if any.

When the job is run, the system will execute the parent job step. Then the system will evaluate the condition for warning==true. If true, the system will look at the warning expression specified and determine if the condition was met. If the condition specified in the warning expression was met, the system proceeds to the next job step.

Type. The way you want to run the stream.

  • Run Stream. With this option, you can run the complete stream or, if the stream contains branches, choose one or more branches to run. In the latter case, the Run Options list is displayed. All branches are checked by default, meaning that all branches will execute when the stream runs. Uncheck any branches that you do not want to execute; doing so can improve performance.
    Note: If the stream contains a script and is configured to "Run Script" on execution, no execution branches will be displayed in the list in the IBM SPSS Collaboration and Deployment Services job editor.
  • Model Management. Choose this option if you want the stream to make use of model management features, such as evaluation, refresh and score. Choose the feature from the Types list that is displayed. Evaluation Options

    Performance. Specify the threshold percentages for the following categories: Bad or Good. A percentage for Better is not user-defined. The system subtracts the Good percentage from 100 to arrive at the Better threshold. Threshold values are mandatory for evaluation streams.

    Metrics. The measurement criteria by which the stream's effectiveness is assessed. Valid values include Accreditation, Accuracy, and Gains. If Gains is selected, then a percentile needs to be specified as well. If Accreditation is selected, then the accreditation step needs to be specified. Valid values include "Collect Statistics" and "Run Evaluation".

    Refresh Options

    Lists all model-nugget relationships in the stream that can be refreshed using the node names defined in the stream. Select a specific relationship to be refreshed by checking the box before the relationship. Uncheck a relationship to prevent it from being refreshed when the step executes. To select all relationships for refresh, click the Check All button. To unselect all relationships, click the Uncheck All button.

    Score Options

    Choose the branch or branches you want to designate as scoring branches.

Guidelines for Providing IBM SPSS Modeler and Content Repository Information

For all IBM SPSS Modeler job steps, both IBM SPSS Modeler server and IBM SPSS Modeler login information are required.