-rename

Description

Renames a connection.

Syntax

ratool -rename <old_connection_name> <new_connection_name>

Parameters

old_connection_name: The name of the connection to rename.

new_connection_name: The new name for the connection.

Examples

Example 1

To rename connection RepToJMS to RepToJMS2:

ratool -rename RepToJMS NewRepToJMS

Usage

If you attempt to rename a connection that is running, the following error message displays:

RaCommand[ERROR]: Rename connection failed. Error
Message: com.sybase.connector.repra.util.RaException:
java.lang.Exception: The connection cannot be renamed
since it is running.

If the new connection name already exists, the following failure message displays:

RaCommand[ERROR]: Rename connection failes. Error message: com.sybase.connector.repra.util.RaException: java.lang.Exception: The destination name already exist.