configure component

Returns configuration parameter information for a component in either a Replication Server or an Adaptive Server; or sets the value of a specified configuration parameter. Components are monitored objects within a server. Replication Server components are connections, logical connections, and routes; Adaptive Server Enterprise components are RepAgent threads.

Syntax

configure {connections | logical connections | routes | repagents} component_name
	[for] {server_name | group_name} [param[= value]]

Parameters

connections, logical connections, routes, repagents – Specifies the type of component to configure. Replication Server components are connections, logical connections, routes; Adaptive Server Enterprise components are RepAgent threads.
component_name – Specifies the name of the component to configure.
server_name – Specifies the server that contains the requested component.
group_name – Specifies the name of a group. You can modify the group_name parameter for each different component in the group.
param – Specifies the name of a component’s configuration parameter.
value – The value to be assigned to the configuration parameter specified in the param option.

Examples

Example 1 – Returns a list of all configuration parameters for the connection “inventory_pds.vendor” in the server INVENTORY_RS:
```
configure connection inventory_pds.vendor
    for INVENTORY_RS
```
Example 2 – Returns the dsi_cmd_batch_size configuration parameter information for the connection “inventory_pds.vendor” in the server INVENTORY_RS:
```
configure connection inventory_pds.vendor
    for INVENTORY_RS dsi_cmd_batch_size
```
Example 3 – Sets the dsi_cmd_batch_size configuration parameter to 15000 for the connection “inventory_pds.vendor” in the server INVENTORY_RS:
```
configure connection inventory_pds.vendor
    for inventory_rs dsi_cmd_batch_size = 15000
```

Usage

configure component returns the following result set if a value parameter is not included:

Column Descriptions for configure component
Column	Description
`Server`	The name of the server that contains the parameters.
`Component Name`	The name of the component that contains the parameter.
`Component Type`	The type of the component (connection, route, or RepAgent).
`Category`	The name of the category for the parameter. Categories are used to group related parameters together.
`Parameter Name`	The name of the parameter.
`Current Value`	The current value of the parameter.
`Pending Value`	The pending value becomes the value of the parameter after the component is restarted.
`Default Value`	The default value of the parameter.
`Legal Values`	A string that defines the legal values for the parameter. This can be a list, or a numeric range.
`Restart Required`	A flag indicating whether the server must be restarted for the parameter to take effect.