Defining the Multi Behavior

The syntax of Configure System to define the "Multi" behavior in Determine commands is

ConfigureSystem /MLT /S <SystemName> [/MO <MultiOnlineValue>] [/MR <MultiReportsValue>][/ISP <IspecName>] [/ISV <IspecValue>] [/RPT <ReportName>] [/RPV <ReportValue>][/ ]

You can define the "Multi" behavior when the Server-side cursors are used to read records from a database. By defining the "Multi" behavior, a database retrieves a block of multiple records into an intermediate memory buffer. You can specify the number of records to retrieve in each block by defining the "Multi" value.

Note: The "Multi" behavior of Server-side cursors is useful when Datareader cannot be used. Although the "Multi" behavior can be specified for a whole system, all reports, or for an individual ispec and report, it is recommended to define the "Multi" behavior for individual reports, where the Datareader feature is enabled. This ensures a significant performance optimization.

If you pass valid parameters to set the "Multi" behavior, the message "Successfully updated the configuration" appears. The DBConfig.xml file available at the Data\Public folder is automatically updated with the values set in the arguments.

Note: If you are configuring AB Suite runtime with the "Multi" behavior for the first time, the DBConfig.xml file with the configuration is created in the Data\Public folder location.

Parameters

Argument

Description

/MLT

Specifies configuring a runtime system to set the "Multi" behavior in the Determine commands.

Note: This argument is mandatory. If you do not pass this argument, the error message "Mandatory Input Missing or Invalid: /MLT /S " appears.

/S <SystemName>

Specifies the name of a deployed system for which the "Multi" behavior is defined.

Notes:

  • This argument is mandatory. If you do not pass this argument, the error message "Mandatory Input Missing or Invalid: /MLT /S " appears.

  • The system name is case-sensitive. The system name is the name of the Segment or Alternate Name, if it has been defined.

  • If you do not pass any value or pass an invalid value, the error message "Missing value for required parameter/s: System Name" appears.

  • If you provide empty quotes, " ", or an invalid system name, an error message specifying that the system is not available appears.

/MO <MultiOnlineValue>

You can specify a "Multi" value for a whole online system.

Notes:

  • If no value or an invalid value is passed with this argument, the error message Invalid argument<s> : /MO" appears.

  • The "Multi" value must be an integer that is greater than one, else an error message appears.

For example: To set "Multi" for the Sample system, type

ConfigureSystem /MLT /S Sample /MO 20

/MR <MultiReportsValue>

You can specify a "Multi" value in all reports.

Notes:

  • If no value or an invalid value is passed with this argument, the error message Invalid argument<s> : /MR" appears.

  • The "Multi" value must be an integer that is greater than one, else an error message appears.

For example: To set "Multi" for all reports, type

ConfigureSystem /MLT /S Sample /MR 20

/ISP <IspecName>

Specifies a specific ispec name for which the "Multi" value can be defined.

Note: If you do not pass an ispec name for which the "Multi" value is defined by setting the /ISV argument, the error message "Error: Ispec value/name is missing" appears.

/ISV <IspecValue>

You can specify a "Multi" value for the ispec stated in the previous argument.

Notes:

  • If no value or an invalid value is passed with this argument, the error message Invalid argument<s> : /ISV" appears.

  • The "Multi" value must be an integer that is greater than one, else an error message appears.

  • If you do not pass any value for this argument for which the ispec name is stated previously, the error message "Error: Ispec value/name is missing" appears.

For example: To set "Multi" for the SALE ispec, type

ConfigureSystem /MLT /S Sample /ISP SALE /ISV 20

/RPT <ReportName>

Specifies a specific report name for which the "Multi" value can be defined.

Note: If you do not pass a report name for which the "Multi" value is set through the /RPV argument, the error message "Error: Report value/name is missing" appears.

/RPV <ReportValue>

You can specify a "Multi" value for the report stated in the previous argument.

Notes:

  • If no value or an invalid value is passed with this argument, the error message Invalid argument<s> : /RPV" appears.

  • The "Multi" value must be an integer that is greater than one, else an error message appears.

  • If you do not pass any value for this argument for which the report name is stated previously, the error message "Error: Report value/name is missing" appears.

For example: To set "Multi" for the CUSTLIST report, type:

ConfigureSystem /MLT /S Sample /RPT CUSTLIST /RPV 20

/MLT /

Displays command line syntax for setting the "Multi" behavior and arguments of the utility. If specified, a usage message displays, and the utility exits without starting the configuring process.