configure server

Description

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:

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