Configuring Component Settings

The syntax of Configure Runtime command-line utility to use the COM+ feature is

ConfigureRuntime.exe /COM /A <ApplicationName> [/PL <ApplicationPoolSize>] [/RL < RecycleLifetimeLimit>] [/RM <RecycleMemoryLimit>][/RE <RecycleExpirationTimeout>] [/RC <RecycleCallLimit>] [/RA <RecycleActivationLimit>] [/MN <MinimumPoolSize>] [/MX <MaximumPoolSize>] [/CT <CreationTimeout>] [/RN <RoleName>] [/UN <UserName>] [/?]

Parameters

Argument	Description
/COM	Specifies configuring the runtime infrastructure components to use the COM+ features. This argument is mandatory. If you do not pass this argument, the error message "Mandatory Input Missing or Invalid: /COM /A " appears.
<Runtime Infrastructure COM+ Application name>	Specifies the name of an internal runtime infrastructure COM+ application for which the COM+ feature is enabled. For example, “AB Suite <x.x> Report Session Manager”, “AB Suite <x.x> Runtime Manager”. Note that this is not used for user-generated runtime systems. Refer to Configure System Utility (ConfigureSystem.exe) for configuring user-generated applications. *Notes:* This argument is mandatory to use the COM+ feature. If you do not pass this argument, the error message "Mandatory Input Missing or Invalid: /COM /A " appears. The application name is case-sensitive. If you do not pass any value, the error message "Provide a valid Application Name" appears. If you pass an invalid value, the error message “Application is not available" appears. If you provide empty quotes, " ", or an invalid application name, an error message specifying that the application is not available appears.
/PL <PoolSize>	You can specify the application pool size value to run multiple instances of an application. A single instance of an application can effectively support 70-100 concurrent users. Hence, you can set the pool size value as 1 for every 70-100 concurrent user. *Notes:* The pool size value must be an integer that is greater than one, else an error message appears. If no value is passed with this argument, the error message "Missing input values or value does not fall within the expected range" appears. If an invalid value is passed with this argument, the error message "Value does not fall within the expected range" appears. For example: To set the pool size of an AB Suite application where the maximum number of users simultaneously connected to the application is 500, type ConfigureRuntime.exe /COM /A "AB Suite 7.0 Runtime Manager" /PL 5 To set the pool size of an AB Suite application in a 32-bit Debugger environment where the maximum number of users simultaneously connected to the application is 500, type ConfigureRuntime.exe /COM /A "AB Suite 7.0 (32 bit) Runtime Manager" / PL 5 Here, setting the Pool Size value to 5 is ideal to achieve application pool optimization.
/RL <RecycleLifetimeLimit>	Specifies the amount of time after which DllHost is recycled. *Notes:* The value specified must be an integer specifying the time in minutes, else an error message appears. If no value is passed with this argument, the error message "Missing input values or value does not fall within the expected range" appears. If an invalid value is passed with this argument, the error message "Value does not fall within the expected range" appears. For example: To recycle DllHosts once a week, which is 100800 minutes, type ConfigureRuntime.exe /COM /A "AB Suite 7.0 Runtime Manager"/RL 100800
/RM <RecycleMemoryLimit>	Specifies the memory limit in KB of a DllHost process after which it automatically enters the recycling state. The default value is 0. *Notes:* It is recommended to set the Memory Limit to a value around 750,000 KB to 800,000 KB. If no value is passed with this argument, the error message "Missing input values or value does not fall within the expected range". appears. If an invalid value is passed with this argument, the error message "Value does not fall within the expected range" appears.
/RE <RecycleExpirationTimeout>	Specifies the amount of time that DllHost is in "Recycling" state before being forcibly shut down. The default value is 15 minutes. You must set this value high to ensure that the session encompasses the longest user sessions. *Notes:* The value specified must be an integer specifying the time in minutes, else an error message appears. If no value is passed with this argument, the error message "Missing input values or value does not fall within the expected range" appears. If an invalid value is passed with this argument, the error message "Value does not fall within the expected range" appears.
/RC <RecycleCallLimit>	Specifies the maximum number of instances of an application (DllHost) that can be processed before it is recycled. *Notes:* If no value is passed with this argument, the error message "Missing input values or value does not fall within the expected range" appears. If an invalid value is passed with this argument, the error message "Value does not fall within the expected range" appears.
/RA <RecycleActivationLimit>	Specifies the amount of time that DllHost is in "Recycling state after which it is activated. *Notes:* If no value is passed with this argument, the error message "Missing input values or value does not fall within the expected range" appears. If an invalid value is passed with this argument, the error message "Value does not fall within the expected range" appears. The value specified must be an integer specifying the time in minutes, else an error message appears.
/MN <MinimumPoolSize>	Specifies the minimum number of segment objects in a pool. The DllHost requires a pool of segment object instances to execute multiple instances of an application. The default value for minimum pool size is 0. *Notes:* It is recommended to set the minimum pool size and the maximum pool size to the same value. This means that the same number of segment objects is created as soon as the DllHost starts running and there is always exactly the same number of objects available. If no value is passed with this argument, the error message "Missing input values or value does not fall within the expected range" appears. If an invalid value is passed with this argument, the error message "Value does not fall within the expected range" appears. For example: To set the minimum pool size of the Sample system, type: ConfigureRuntime.exe /COM /A "AB Suite 7.0 Deployment Server"/MN 5
/MX <MaximumPoolSize>	Specifies the maximum number of segment objects in a pool. The default maximum pool size value is 1048576. *Notes:* Since the default value is a very large number, it is advisable to set it to a lower value to optimize the memory usage. If no value is passed with this argument, the error message "Missing input values or value does not fall within the expected range" appears. If an invalid value is passed with this argument, the error message "Value does not fall within the expected range" appears.
/CT <CreationTimeout>	Specifies the amount of time after which the creation of new segment objects is stopped. The default value is 60000 minutes. *Notes:* The value specified must be an integer specifying the time in minutes, else an error message appears. If no value is passed with this argument, the error message "Missing input values or value does not fall within the expected range" appears. If an invalid value is passed with this argument, the error message "Value does not fall within the expected range" appears.
/RN <RoleName>	Specifies the various COM+ user roles. *Notes:* If you do not pass any value or pass an invalid value for this argument, the error message "Error: Provide a valid Role Name. Role Name is not available in the COM+ application." appears. If user name is not specified, the error message "Provide users of the role" appears. For example: To allow a user to be a member of Application Operators role for setting the minimum and maximum pool settings of the Sample system, type: ConfigureRuntime.exe /COM /A "AB Suite 7.0 Runtime Manager"/MN 5 /MX 5 /RN Application Operators Refer to the Agile Business Suite Installation and Configuration Guide for more information on how to determine the available COM+ roles.
/UN <UserName>	Specifies a system or domain user for internal AB Suite runtime components. *Notes:* If you do not pass any value or pass an invalid value for this argument, the error message "Error: One or more users are not valid." appears. If role name is not specified, the error message "Provide a role name for the user" appears.
/COM / ?	Displays command line syntax for setting the COM+ property and arguments of the utility. If specified, a usage message displays, and the utility exits without starting the configuring process.

Troubleshooting Error Messages

If you provide incorrect option for an argument, an error message appears specifying that the argument is invalid along with the argument and the usage of the utility appears for reference.
If you do not pass the mandatory arguments, an error message appears specifying that the mandatory input is missing and a reference to those arguments along with the usage of the utility.
If you pass an incorrect command, an error message appears as, “Invalid input specified”.
If you pass an incorrect argument, an error message appears specifying that the argument is invalid along with the argument and the usage of the utility appears for reference.
If you pass any incorrect values for an argument, an error message appears specifying that the argument is invalid along with the argument and the usage of the utility appears for reference.