Volume Replicator 7.4.1 Administrator's Guide - Windows

Receiving a message

To receive an IBC message, run the command:

vxibc -g <diskgroup> [-n | -R <receive_timeout>] \[-l <buf_length>]
 [-f <filename>] receive <application_name> <rvg>

This command receives the IBC message that was sent from the Primary RVG to the Secondary host. The application_name must be previously registered for the Secondary RVG. Secondary replication is frozen at the point-in-time on the Secondary's update stream at which the IBC message was inserted at the Primary RVG. Secondary replication remains frozen until an unfreeze operation is performed or the freeze_timeout specified when the IBC message was sent expires. The default behavior for the receive operation is that until the IBC message is received the operation is not complete. For example, when you use the command from the command prompt, and you are running the receive command then you do not get the next command prompt until the IBC message is received. If the receive command is used with the -n option then the command is non-blocking, that is, the command is completed immediately even if the message has not been received.

If the operation succeeds, the received message is displayed. An unsuccessful exit code indicates that messages were dropped due to delivery time-outs and the drop count is displayed to standard error. If an error occurs while receiving a message, the error message is displayed with the drop count of messages.

For example, to receive an IBC message run the command:

vxibc -g vvrdg1 -R 120  -f  msg.txt receive app1 vvrRvg1

This command receives the message and stores it in a file named msg.txt.