configure server

Returns configuration parameter information for a Replication Server or Replication Agent and Mirror Replication Agent (MRA), or sets the value of a specified configuration parameter. Also retrieves and sets RMS-specific parameters.

Syntax

configure server {server_name | group_name} [RMS] [param [= value]]

Parameters

server_name – Specifies the server to be configured.
group_name – Specifies the name of a group. Modify group_name for each server in the group.
RMS – Specifies RMS parameters.
param – Specifies the name of a server’s configuration parameter.
value – The value assigned to the configuration parameter specified in the param option.

Examples

Example 1 – Returns a list of all configuration parameters for the server INVENTORY_RS:
```
configure server INVENTORY_RS
```

Example 2 – Returns the memory_limit configuration parameter information for the server INVENTORY_RS:

configure server INVENTORY_RS memory_limit

Parameter     Parameter  Current  Pending  Default
Name          Type       Value    Value    Value
------------  ---------  -------  -------  -------
memory_limit  NULL       20       55       NULL

Legal   Category  Restart    Description
Values            Required
------  --------  --------   -------------------------
NULL    NULL       NULL        NULL

Example 3 – Sets the memory_limit configuration parameter to 50 for the server INVENTORY_RS:
```
configure server inventory_rs memory_limit = 50
```
Example 4 – Retrieves all RMS-specific parameters:
```
configure server INVENTORY_RS RMS
```
Example 5 – Changes the user name used by the RMS to connect to the server:
```
configure server INVENTORY_RS RMS username = ‘rsa’
```

Usage

configure server supports Replication Server, Replication Agent, and remotely monitored RMS configurations.
configure server can retrieve and set RMS-specific parameters for all types of servers. The server and the RMS use these parameters to communicate.

configure server returns the following result set if you do not include a value parameter:

Default configure server Result Set
Column	Description
`Parameter Name`	The name of the parameter.
`Parameter Type`	The type of parameter.
`Current Value`	The current value of the parameter.
`Pending Value`	The pending value becomes the value of the parameter after the server 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.
`Category`	The name of the category for the parameter. Categories are used to group related parameters together.
`Restart Required`	A flag indicating whether the server must be restarted in order for the parameter to take effect.
`Description`	The parameter description.