Returns help information for Replication Agent configuration parameters, or sets the value of a specified Replication Agent configuration parameter.
ra_config [param[, value]]
The name of a Replication Agent configuration parameter.
The value to be assigned to the configuration parameter specified in the param option. You can use the keyword default to set the specified parameter to its default value.
ra_config pdb_convert_datetime
This command returns the current value of the pdb_convert_datetime configuration parameter.
ra_config scan_sleep_max, 60
This command changes the value of the scan_sleep_max parameter to 60.
If ra_config is invoked with no options specified, it returns a list of all Replication Agent configuration parameters. The following information is returned for each configuration parameter:
parameter name
parameter type – This is actually the datatype of the parameter’s value. For example, string, numeric, or boolean.
current value – The value of the parameter in effect at the time the ra_config command is invoked.
pending value – If different from the current value, this is the value to which the parameter was set by a previous invocation of the ra_config command, but which has not yet taken effect.
default value – The value of the parameter when the Replication Agent configuration file is created.
legal values – The values that are allowed for the parameter, for example, a range of numbers or a list of specific strings.
category – This refers to the Replication Agent component affected by the value of the parameter.
restart – This refers to parameters that require the Replication Agent instance to be shut down and restarted before a change in value takes effect.
If ra_config is invoked with only a param option specified, it returns information only for the specified configuration parameter.
If ra_config is invoked with both param and value options specified, it changes the setting of the specified configuration parameter to the value specified in the value option.
You can use the keyword default in place of the value option to reset a configuration parameter to its default value. For example:
ra_config use_rssd, default
When ra_config is invoked with no options or only the param option specified, the command is valid when the Replication Agent instance is in either Admin or Replicating state.
If ra_config is invoked in the Replicating state, with both the param and value options specified for a parameter that can be changed only in the Admin state, it returns an error message.
When ra_config is invoked with both the param and value options specified, the command is always valid when the Replication Agent instance is in the Admin state.
For information on configuration parameters, see Chapter 5, “Sybase Replication Agent Configuration Parameters”.
pdb_setrepcol, pdb_setrepproc, pdb_setreptable, pdb_xlog, ra_help, ra_set_login
