Using the COM+ Feature

The syntax of Configure System to use the COM+ feature is

ConfigureSystem /COM /S <SystemName> [/PL <PoolSize>] [/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 a runtime system to use the COM+ features. *Note:* This argument is mandatory. If you do not pass this argument, the error message "Mandatory Input Missing or Invalid: /COM /S " appears.
/S <SystemName>	Specifies the name of a deployed system for which the COM+ feature is enabled. *Notes:* This argument is mandatory. If you do not pass this argument, the error message "Mandatory Input Missing or Invalid: /COM /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, the error message "Provide a valid Runtime System Name" appears. If you pass an invalid value, the error message System is not available" appears. If you provide empty quotes, " ", or an invalid system name, an error message specifying that the system 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 the Sample system where the maximum number of users simultaneously connected to Sample is 500, type ConfigureSystem /COM /S Sample /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 ConfigureSystem /COM /S Sample /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 the 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: ConfigureSystem /COM /S Sample /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: ConfigureSystem /COM /S Sample /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 a deployed system. *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 specifying that the argument is invalid along with the argument appears and the usage of the utility, for reference.
If you do not pass the mandatory arguments, an error message specifying that the mandatory input is missing and a reference to those arguments appears along with the usage of the utility.
If you pass an incorrect command, the error message Invalid input specified appears.
If you pass an incorrect argument, an error message specifying that the argument is invalid along with the argument appears and the usage of the utility, for reference.
If you pass any incorrect values for an argument, an error message specifying that the argument is invalid along with the argument appears and the usage of the utility, for reference.
If you pass duplicate arguments, the error message "Encountered duplicate arguments. Please address the duplicates before proceeding" appears.

Example

The following example sets the Datareader feature, sets the "Multi" value to 20, sets the Transaction Isolation Level to "Read Committed", and sets the Non-Phased SQL feature of the CUSTLIST report in the Sample system respectively.

ConfigureSystem /DR /S Sample /RPT CUSTLIST /RPV true

ConfigureSystem /MLT /S Sample /MO 20

ConfigureSystem /TIL /S Sample /TO Read Committed

ConfigureSystem /PS /S Sample /PO false