Returns help information for Sybase Replication Agent configuration parameters, or sets the value of a specified configuration parameter.
ra_config [param [, value]]
The name of a Sybase 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 use_rssd
This command returns the current value of the use_rssd 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 option, it returns a list of all Sybase Replication Agent configuration parameters.
If ra_config is invoked with the param option, it returns information only for the specified configuration parameter.
If ra_config is invoked with the param and value options, 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
The following information is returned for each configuration parameter:
Parameter name – the name of the parameter.
Parameter type – 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 ra_config is invoked.
Pending value – if different from the current value, 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 Sybase Replication Agent instance 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 – refers to the Sybase Replication Agent component affected by the value of the parameter.
Restart – refers to parameters that require the Sybase Replication Agent instance to be shut down and restarted before a change in value takes effect.
When ra_config is invoked with either no option, or only the param option, the command is valid when the Sybase Replication Agent instance is in 4either Admin or Replicating state.
If ra_config is invoked when the Sybase Replication Agent instance is in Replicating state, with the param and value options for a parameter that can be changed only in Admin state, it returns an error.
When ra_config is invoked with the param and value options, the command is always valid when the Sybase Replication Agent instance is in Admin state.
When pdb_setrepproc is invoked to mark a procedure or procedures, a replication definition is created at Replication Server for each procedure that gets marked for replication, if this property is set to true.
When pdb_setreptable is invoked to unmark a table or tables, the replication definition is dropped at Replication Server for each table that gets unmarked for replication, if this property is set to true.
When pdb_setrepproc is invoked to unmark a procedure or procedures, a replication definition is dropped at Replication Server for each procedure that gets unmarked for replication if this property is set to true.
When pdb_xlog is initialized and table auto marking is enabled, a replication definition is created for each table that is marked for replication if this property is set to true.
Replication definition names for tables always begin with the prefix "ra$," followed by a unique alphanumeric identifier (maximum of 8 characters), and ending with a table or object name. For example, for a replicate name of "My Table," the resulting repdef name is "ra$0x7952_mytable." For an especially long replicate name of "mytable89012345678901234567890" (30 characters), the resulting repdef name is "ra$0x7952_mytable8901234567890" (30 characters maximum).
Replication definition names for procedures are the same name as the procedure.
See Chapter 2, “Configuration Parameters,” for more information.