Using the Datareader Feature

The syntax of Configure System for using the Datareader feature is

ConfigureSystem /DR /S <SystemName> [/DRO <true|false>] [/DRR <true|false>][/ISP <IspecName>] [/ISV <true|false>] [/RPT <ReportName>] [/RPV <true|false>][/ ]

If you pass valid parameters to set the Datareader feature, 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 Datareader feature for the first time, the DBConfig.xml file with the configuration is created in the Data\Public folder location.

The Datareader feature cannot be used for Determine commands where a Sleep command occurs within a loop. This restriction is automatically handled by the AB Suite runtime and the default mechanism of Server-side cursors is used in such scenarios.

Parameters

Argument

Description

/DR

Specifies configuring a runtime system to use the Datareader feature to retrieve data through the Determine commands.

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

/S <SystemName>

Specifies name of a deployed system for which the Datareader feature can be enabled.

Note:

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

  • The system name is case-sensitive. The system name is the name of the Segment or else 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.

For example: If you do not pass this argument, an error message specifying that mandatory input is missing appears.

ConfigureSystem /DR /DRO true /DRR false

/DRO <true|false>

Specifies enabling or disabling the Datareader feature for all the Determine commands across the specified system.

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

For example: To set the Datareader feature in all the read loops across a system including ispecs and reports, type

ConfigureSystem /DR /S Sample /DRO true

/DRR <true|false>

Specifies enabling or disabling the Datareader feature in all reports.

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

For example: To use Datareader in reports only, type

ConfigureSystem /DR /S Sample /DRO false /DRR true

/ISP <IspecName>

Specifies the specific ispec name where the Datareader feature can be enabled.

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

/ISV < true|false >

Specifies enabling or disabling the Datareader feature for the ispec stated in the previous argument.

Note:

  • If no value or an invalid value is passed with this argument, the error message Invalid argument<s> : /ISV" 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 use Datareader in the CUST ispec, type

ConfigureSystem /DR /S Sample /DRO false /DRR true /ISP CUST /ISV true

/RPT <ReportName>

Specifies the specific report name where the Datareader feature can be enabled.

Note: If you do not pass a report name for which the Datareader feature is enabled by setting the /RPV argument, the error message "Error: Report value/name is missing" appears.

/RPV <true|false>

Specifies enabling or disabling the Datareader feature 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.

  • 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 use Datareader in the CUSTLIST report, type:

ConfigureSystem /DR /S Sample /DRO false /DRR true /RPT CUSTLIST /RPV true

/DR /

Displays command line syntax for the Datareader feature and arguments of the utility. If specified, a usage message displays and the utility exits without starting the configuring process.