suspend

Stops all current replication processing and puts the Replication Agent instance into Admin state.

Syntax

suspend

Usage

  • When suspend is invoked, it stops all current replication processing in the Replication Agent instance.

    • The Log Reader component stops scanning the transaction log immediately, and the Log Transfer Interface component stops sending LTL to Replication Server immediately.

    • Any data in the Replication Agent internal queues (input and output queues of the Log Reader and Log Transfer Interface components) is removed without further processing.

    • The Replication Agent instance immediately releases all of its connections to the primary database, and drops its connection to the primary Replication Server (and RSSD, if connected).

    • The Replication Agent instance goes from Replicating state to Admin state.

    Note: The action of the quiesce command is similar to that of the suspend command, except that quiesce allows pending transactions in the Replication Agent internal queues to be processed first, before putting the Replication Agent instance in Admin state.

  • If the Replication Agent instance is in Admin state, the suspend command returns an error.

  • The suspend command is valid only when the Replication Agent instance is in Replicating state.

Related reference
quiesce
ra_status
resume
shutdown