configure component

Description

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:

**Table 9-4: 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.