<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Transitional//EN">
<HTML>
<HEAD>
  <!--
    *************************************************************************************
    * Copyright (c) 2005 VERITAS Software Corporation. All rights reserved. *

      For third-party license citations, please see the bottom of this file.
    *************************************************************************************
  -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="TEMPLATEBASE" content="DocCD Manual Pages 1.4">
<meta name="LASTUPDATED" content="06/13/05 11:54:08">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="vxrlink.fm">
     
<title>vxrlink</title>

</HEAD>

<BODY bgcolor="#FFFFFF" link="#000066" vlink="#0000ff" marginheight="0" topmargin="0">
<basefont=1>

<a name="433229"></a>

<div align="left">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
 <tr>
   <td height="2" border="0" cellspacing="0" cellpadding="0" colspan="2" bgcolor="#000000">
   </td>
 </tr>
 <tr>
   <td height="15" width="50%" border="0" cellspacing="0" cellpadding="0" bgcolor="#cccccc">
    <img src="images/vxsymbol.gif" height="20" width="31" border="0" cellspacing="0" cellpadding="0" align="left">
     
     
   </td>
   <td align="right" width="50%" bgcolor="#cccccc">

<!-- Header Breadcrumbs -->
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="vxresize_vxvm_manpages65_428209.html" title="Previous - vxresize">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxrootmir_vxvm_manpages67_428605.html" title="Next - vxrootmir">Next</a>
&nbsp;&gt;&nbsp;&nbsp;</font>
   </td>
 </tr>

 <tr>
  <td bgcolor="#CCCCCC" colspan="2" height="15" align="right">
  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Product:  
<a href="vxvm_manpages_splashpage_docCD_vxvm_manpages1_103036.vxhd" title="Volume Manager Manual Pages for Storage Foundation title page ">Volume Manager Manual Pages for Storage Foundation</a>
  &nbsp;&nbsp;
  </font>
  </td>
 </tr>
 <tr>
  <td bgcolor="#CCCCCC" colspan="2" height="15" align="right">
  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Manual:  
<a href="man1m_titlepage_docCD_vxvm_manpages2_73700.vxhd" title="Maintenance Commands (1m) title page ">Maintenance Commands (1m)</a>
  &nbsp;&nbsp;
  </font>
  </td>
 </tr>


</table>
</div>

<div align="left">
 <table border="0" width="100%" bgcolor="#FFFFFF">
  <tr>
   <td width="100%" valign="top" bgcolor="#FFFFFF">

<!-- Start Main Topic Content -->
        <a name="startcontent"></a>
	
<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="429788"></a>vxrlink</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429818"></a> NAME</font>
</h3>
<p>
<a name="429823"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxrlink - perform VERITAS Volume Manager operations on RLINKs </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429826"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="429831"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r </b></font><em>rvg</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>assoc</b></font> <em>rvg</em> <em>rlink </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="429861"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-a</b></font>\ |\ <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c </b></font><em>checkpoint</em>\ |\ <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r </b></font><em>rvg</em>] <br><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>att</b></font> <em>rlink1</em> [<em>rlink2</em>..\|.] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="429894"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r</b></font> <em>rvg</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c</b></font> <em>checkpoint </em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>checkdelete </b></font><em>rlink </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="429942"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r</b></font> <em>rvg</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cplist</b></font> <em>rlink </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="429972"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r </b></font><em>rvg</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>det</b></font> <em>rlink </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430002"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r </b></font><em>rvg</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font> <em>rlink </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430032"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c </b></font><em>checkpoint</em>\ |\ <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-w</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r </b></font><em>rvg</em>] <br><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pause</b></font> <em>rlink </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430065"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r </b></font><em>rvg</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>recover</b></font> <em>rlink </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430095"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r </b></font><em>rvg</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c </b></font><em>checkpoint <br></em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>restore</b></font> <em>rlink </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430128"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r </b></font><em>rvg</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>resume</b></font> <em>rlink </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430158"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-e</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-i </b></font><em>interval</em> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t </b></font><em>timestamp_freq</em>]] <br>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r </b></font><em>rvg</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stats</b></font> <em>rlink </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430191"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-i </b></font><em>interval</em> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t </b></font><em>timestamp_freq</em>]] <br>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r </b></font><em>rvg</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>status</b></font> <em>rlink </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430233"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r </b></font><em>rvg</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>updates</b></font> <em>rlink </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430272"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r </b></font><em>rvg</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>verify</b></font> <em>rlink</em>\ |\ <em>rvg </em>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430302"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430307"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink </b></font>utility performs VERITAS Volume Manager (VxVM) operations on RLINKs (<em>rlinks</em>). <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink</b></font> is specific to VERITAS Volume Replicator (VVR), which requires a valid license. The first operand is a keyword that determines the specific operation to perform. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430373"></a>Each operation can be applied to only one disk group at a time. Any <em>rlink</em> and <em>rvg </em>operands are used to determine a default local disk group, according to the standard disk group selection rules described in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M). When an <em>rvg</em>\ is not specified, the RVG currently associated with the specified RLINK is used. A specific local disk group can be selected with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430439"></a> KEYWORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430445"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>assoc</b></font></font>
</p>
<p>
<a name="434021"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Associates an <em>rlink</em> with an <em>rvg</em>. Both the <em>rlink</em> record and the <em>rvg</em> record are modified. Alternatively the association could be specified during the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> of the RVG. Secondary RVGs (that is, an RVG that does not have the primary attribute set) have at most one <em>rlink</em> associated with them. Where as a primary RVG has one <em>rlink </em>for each secondary RVG associated with it with a maximum of 32. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430512"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>att</b></font></font>
</p>
<p>
<a name="434056"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Attaches an <em>rlink</em> to an <em>rvg</em>. The <em>rlink</em> must already be associated with the <em>rvg</em> before the attach operation. </font>
</p>
<p>
<a name="425109"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When a primary <em>rlink</em> is successfully attached, VVR sets up a connection between the primary and secondary hosts and replicates the writes received by the primary data volumes to the corresponding secondary data volumes. Before attaching a primary <em>rlink</em> ensure that the secondary RLINKs are attached, the secondary Storage Replicator Log(SRL) is associated with the secondary RVG, and all of the secondary data volumes are associated with the secondary RVG. For the attach to succeed on the primary, the <em>remote_host</em>, <em>remote_dg</em>, and <em>remote_rlink</em> attributes must be set on both the primary and the secondary RLINKs. The attributes can be set, while creating the RLINKs, using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit set</b></font> command. The attach fails if the primary RVG does not have an SRL associated with it. The exception to this rule is when the primary RVG is in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>passthru</b></font> error mode and does not need an SRL associated with it. In this case, the application writes are passed directly to the data volumes and replication is not taking place. </font>
</p>
<p>
<a name="425126"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An attach on the primary requires that one of the options <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-a</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c</b></font><em> checkpoint</em>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> is specified. </font>
</p>
<p>
<a name="425129"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An attach of a secondary RLINK does not require any options because the attach only indicate the readiness of the RLINK to be used for replication. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430748"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>checkdelete</b></font></font>
</p>
<p>
<a name="434132"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Deletes the specified Secondary checkpoint. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425135"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> This command must be run only on the Primary. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425137"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">By default, VVR allows the creation of a maximum of 46 checkpoints. When the number of checkpoints exceeds this number, VVR prompts you to select which of the checkpoints should be deleted. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430811"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cplist</b></font></font>
</p>
<p>
<a name="434194"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays information about all existing checkpoints associated with the given <em>rlink</em>, including their name, size, and percentage of SRL used. If SRL usage reaches 100%, the checkpoint overflows and becomes unusable, as indicated by the  output message &quot;&lt;Checkpoint overflowed&gt;.&quot; Note that only secondary checkpoints (created using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink -c</b></font> <em>checkpoint</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pause </b></font>on the secondary) are associated with an rlink. Primary checkpoints (created using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrvg -c</b></font> <em>checkpoint</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>checkstart </b></font>on the primary) are associated with the RVG, and can be listed using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrvg cplist</b></font>. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425155"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cplist</b></font> command must be run only on the Primary. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430939"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>det</b></font></font>
</p>
<p>
<a name="434233"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Detaches an <em>rlink</em> from an <em>rvg</em>. This makes the RLINK STALE. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425161"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> A STALE RLINK requires a full resynchronization of its data volumes before replication can be resumed. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430986"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font></font>
</p>
<p>
<a name="434268"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Dissociates an <em>rlink</em> from the <em>rvg</em> with which it is associated. This can not be executed if the RLINK is currently attached. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431017"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pause</b></font></font>
</p>
<p>
<a name="434295"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Pauses updates to the <em>rlink</em> until <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink resume </b></font>is executed.  New updates are logged while the RLINK is paused, and are applied once the RLINK is resumed. </font>
</p>
<p>
<a name="425174"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">On the primary, if the Data Change Maps(DCMs) are being replayed on the RLINK to be paused, the replay pauses until the RLINK is resumed. If more than one RLINK is involved in the replay, the replay pauses for all RLINKs involved. Resuming the paused RLINK allows the replay to resume for all RLINKs. Detaching the paused RLINK allows the replay to resume for the remaining attached RLINKs. </font>
</p>
<p>
<a name="425182"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">On the secondary a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c</b></font><em> checkpoint </em>option is valid and can be used to mark a point at which a backup of the secondary has been taken. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425187"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-w</b></font> option is used only on the secondary side and only in special cases to force the secondary RLINK into the FAIL state. This might have to be done before restoring the secondary from an online backup. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431214"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>recover</b></font></font>
</p>
<p>
<a name="434344"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Recovers <em>rlink</em> after rebooting machine. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431227"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>restore</b></font></font>
</p>
<p>
<a name="434367"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Restores the <em>rlink</em> from FAIL state to ACTIVE. Valid only for secondary RLINKs. Used when restoring data volumes at a secondary site from online backup data maintained at the secondary site (as opposed to restoring secondary data volumes using data copied from the primary site). </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425203"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> This keyword must be used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c</b></font> option to specify the checkpoint corresponding to the backup that is used to perform the restore. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431310"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>resume</b></font></font>
</p>
<p>
<a name="434402"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Resumes updates to an <em>rlink</em> in the PAUSE state. After updates are resumed, all updates that were logged while the RLINK was paused are written to the secondary. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431350"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stats</b></font></font>
</p>
<p>
<a name="434445"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays network statistics for the given <em>rlink</em>. The displayed values are cumulative, except when used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-i</b></font> <em>interval</em> option. When used with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-i</b></font> <em>interval</em> option, the first line of statistics provide cumulative values and subsequent lines show the change during the last <em>interval</em> seconds. </font>
</p>
<p>
<a name="425221"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The following values are displayed under the heading <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Messages</b></font>: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431424"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>#</b></font></font>
</p>
<p>
<a name="434471"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Number of messages transmitted. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431437"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Blocks</b></font></font>
</p>
<p>
<a name="434490"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Number of 1024-byte blocks transmitted. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431450"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RT</b></font></font>
</p>
<p>
<a name="434509"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Average round-trip time per message. </font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425234"></a>The following values are displayed under the heading <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Errors</b></font>: </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431479"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Timeout</b></font></font>
</p>
<p>
<a name="434532"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Number of timeouts errors. A timeout error occurs when an acknowledgement for a message is not received from the remote host within the timeout period. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431501"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Stream</b></font></font>
</p>
<p>
<a name="434551"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Number of stream errors. Stream errors occur when the RLINK attempts to send messages faster than the network can handle. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431523"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Memory</b></font></font>
</p>
<p>
<a name="434570"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Number of errors because of insufficient buffer space on the Secondary. </font>
</p>
<p>
<a name="425250"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The heading <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Flow Control</b></font> displays values that indicate how fast the RLINK is trying to send messages. If VVR is using the UDP transport protocol, the values <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Delays</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NW Bytes</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NW Delay</b></font> are displayed. If VVR is using the TCP transport protocol, only the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Delays</b></font> value is displayed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431606"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Delays</b></font></font>
</p>
<p>
<a name="434609"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Cumulative time the RLINK had to wait while it was flow controlled. The value is displayed in one-hundredth of a second. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431637"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NW Bytes</b></font></font>
</p>
<p>
<a name="434632"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Number of bytes that can be transmitted without flow controlling and introducing any intervening wait. If an RLINK does not experience network errors, VVR steadily increases the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NW Bytes</b></font> to permit more data to be transmitted. If an RLINK experiences network error, VVR tries to flow control by reducing this number. The minumum value is 5000 bytes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431695"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NW Delay</b></font></font>
</p>
<p>
<a name="434667"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The amount of wait introduced after transmission of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NW Bytes</b></font> of a message. If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NW Bytes</b></font> is at 5000 bytes and the RLINK continues to experience errors, VVR increases <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NW Delay</b></font>. The value is displayed in one-hundredth of a second. The maximum value is 100 (1 second). A steady high value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NW Delay </b></font>usually indicates a network problem. </font>
</p>
<p>
<a name="425280"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If VVR is using the UDP transport protocol, the current value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Timeout</b></font> is displayed: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431778"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Timeout</b></font></font>
</p>
<p>
<a name="434690"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Message timeout value in milli-seconds. The value is computed dynamically. If an acknowledgement for a message is not received from the remote host within this time period, the message is considered lost and is retransmitted. </font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425291"></a>When used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-e</b></font> option, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stats</b></font> command displays extended network statistics. The displayed values are cumulative unless an interval is specified using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-i</b></font> option. In this case, cumulative values are only shown on the first line of statistics, and subsequent lines show the change during the previous interval. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425298"></a>The output of the command with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-e</b></font> option is specified is displayed under two headings: Messages and Errors. The Messages heading displays the following information: </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431922"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Number of blocks sent</b></font></font>
</p>
<p>
<a name="434729"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The number of 512-byte blocks that have been transmitted. (If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-e</b></font> option is not specified, the displayed Blocks value only indicates the number of blocks that have been acknowledged.) </font>
</p>
<p>
<a name="425311"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The Errors heading has nine fields that indicate the nature of the error that has been encountered. Three of these headings are similar to those shown by the command if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-e</b></font> option is not specified. The following errors may be shown: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432014"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>No memory available</b></font></font>
</p>
<p>
<a name="434752"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">There is not enough system kernel memory to process the message. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432036"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>No message slots available</b></font></font>
</p>
<p>
<a name="434771"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">There is not enough memory to store the packets of a message that have arrived out of sequence. (If a packet arrives out of sequence, it must be stored in a message buffer until all the related out-of-sequence packets arrive, and can be assembled.) </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432085"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>No memory available in nmcom pool on Secondary</b></font></font>
</p>
<p>
<a name="434794"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The buffer space (whose size is determined by the value of VVR tunable <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol_max_nmpool_sz</b></font>) is full, and cannot store any new messages that arrive at the Secondary. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432116"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Timeout errors</b></font></font>
</p>
<p>
<a name="434813"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays the number of times that the Primary timed out while waiting for an acknowledgement from the secondary. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432138"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Missing packet errors</b></font></font>
</p>
<p>
<a name="434832"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays the number of times that the last packet of a message was received before one or more packets of the same message had been received. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432169"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Missing message errors</b></font></font>
</p>
<p>
<a name="434851"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays the number of times that messages have arrived out of sequence. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432182"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Stream errors</b></font></font>
</p>
<p>
<a name="434870"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays the number of times that the RLINK has attempted to send messages faster than the network can handle. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432213"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Checksum errors</b></font></font>
</p>
<p>
<a name="434889"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays the number of data checksum errors. (Every time a packet is received at the secondary, VVR performs a checksum to ensure that the packet data is the same as that sent by the Primary.) </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432253"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Unable to deliver due to transaction errors</b></font></font>
</p>
<p>
<a name="434908"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays the number of times that packets could not be delivered to the secondary because of transaction errors. (If the secondary is busy with some kernel operations when a packet arrives at the secondary, the packet may not be delivered until the transaction is complete.) </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432308"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>status</b></font></font>
</p>
<p>
<a name="434959"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Only valid on the primary, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>status</b></font> displays the state of the secondary image represented by the given <em>rlink</em>. If the <em>rlink </em>is not up-to-date, the output shows the number of updates and blocks by which the image is behind, and the percentage of the SRL being used by this <em>rlink</em>. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-i</b></font> <em>interval</em> option allows the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>status</b></font> command to be executed at the given <em>interval</em>. </font>
</p>
<p>
<a name="425375"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T</b></font> option (timestamp) displays the status of the Primary showing the amount of time (as <em>hours</em>:<em>minutes</em>:<em>seconds</em>) by which the given RLINK is lagging. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425379"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> If the Primary is up-to-date, or the RLINK is in DCM mode, the timestamp is not displayed in the output. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432434"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>updates</b></font></font>
</p>
<p>
<a name="435009"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Only valid on the secondary, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>updates</b></font> displays the update ID of the latest update received by the secondary, as well as number of updates primary is ahead of secondary.  This information can be used to determine the most up-to-date secondary RVG.  The update information is invalid if the secondary has not received any updates from the primary.  The update information is unavailable if the secondary has been rebooted after the primary has gone down. </font>
</p>
<p>
<a name="425391"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T</b></font> option (timestamp) displays the amount of time by which the secondary is lagging (as <em>Mon DOM hours</em>:<em>minutes</em>:<em>seconds</em> where <em>Mon</em> is the locale-specific abbreviation of the month, and <em>DOM</em> is the day number in the month). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432558"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>verify</b></font></font>
</p>
<p>
<a name="435071"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays configuration information for the <em>rlink</em>. Configuration update messages are sent to each secondary RLINK when appropriate. Any configuration errors detected at a secondary are logged. This command displays the configuration status of the given RLINK. If an <em>rvg</em> is specified instead of an RLINK, configuration status information is displayed for each RLINK associated with the RVG. If an RVG is specified with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r</b></font> option, it is used only to help determine a default local disk group, according to the standard disk group selection rules described in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M). </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="432661"></a> OPTIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432667"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-a</b></font></font>
</p>
<p>
<a name="435094"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Use with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>att</b></font> command on the primary to attach a group of RLINKs for automatic synchronization(autosync). The autosync operation fails if all the data volumes do not have associated DCMs or if any of the RLINKs are unable to connect to the respective secondary hosts. The -a option cannot be used on the secondary or with the -f or -c option. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432729"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c</b></font><em> checkpoint</em></font>
</p>
<p>
<a name="435145"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Use with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>att</b></font> command on the primary to attach an <em>rlink</em> which is consistent up to the point indicated by the <em>checkpoint</em> string. The checkpoint indicates, to VVR, the writes that must be replayed from the primary host to the seconday hosts, to bring the secondary hosts up to date. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c</b></font> option is also required with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>restore</b></font> command to specify the checkpoint to be used for restore. Similarly, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c</b></font> option is required with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>checkdelete</b></font> command to specify a checkpoint that is to be deleted. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432818"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-e</b></font></font>
</p>
<p>
<a name="435172"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays extended statistics for errors reported by the RLINK. The output includes six additional columns that provide diagnostic information on the error conditions. This option can be used in conjunction with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-i</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t</b></font> options. In a clustered environment extended statistics will be printed only on a node which is the logowner and is running the CVM protocol version 60 or higher. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432885"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font></font>
</p>
<p>
<a name="435199"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Use with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>att</b></font> command on the primary to force an attach of an <em>rlink</em> when the secondary data volumes are completely synchronized with the primary data volumes. </font>
</p>
<p>
<a name="425445"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Use the -f option with care because it may result in loss of data if used incorrectly. Use the -f option to attach the <em>rlink </em>only if you are sure that the <em>rlink</em> is up to date. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432954"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font><em> diskgroup</em></font>
</p>
<p>
<a name="435245"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the local <em>diskgroup</em> for the operation. The <em>diskgroup</em> can be specified either by name or by disk group ID. See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M) for more information on disk groups. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432985"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-i</b></font><em> interval</em></font>
</p>
<p>
<a name="435280"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Executes the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stats</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>status</b></font> command every <em>interval</em> seconds. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433007"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r</b></font><em> rvg</em></font>
</p>
<p>
<a name="435307"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the name of the RVG with which the <em>rlink</em> is associated. If not supplied, the RLINK record is examined to retrieve the name of the associated RVG. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433038"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t</b></font><em> timestamp_freq</em></font>
</p>
<p>
<a name="435350"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies how frequently timestamps are to be output, in terms of the number of lines. For example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t 1</b></font> prints a timestamp on each line, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t 5</b></font> prints a timestamp on every fifth line. This option is only valid for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stats</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>status</b></font> commands when the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-i</b></font> option is also specified. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433096"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T</b></font></font>
</p>
<p>
<a name="435373"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink status</b></font> command, displays the status of the Secondary image represented by the given RLINK together with a timestamp that indicates the amount of time by which the RLINK is lagging. </font>
</p>
<p>
<a name="425477"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink updates</b></font> command, displays the amount of time by which the Secondary is lagging. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433161"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-w</b></font></font>
</p>
<p>
<a name="435407"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Forces a secondary <em>rlink</em> into the FAIL state. Used only in special circumstances (secondary online backup). The <em>rlink</em> is marked inconsistent. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="433191"></a> EXIT CODES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433196"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink</b></font> utility exits with a non-zero status if the attempted operation fails. A non-zero exit code is not a complete indicator of the problems encountered, but rather denotes the first condition that prevented further execution of the utility. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433226"></a>See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M) for a list of standard exit codes. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="433229"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433234"></a><a href="vxdg_vxvm_manpages33_443062.html#434590"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font></font></a>(1M), <a href="vxedit_vxvm_manpages41_434625.html#430530"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit </b></font></font></a>(1M), <a href="vxintro_vxvm_manpages47_452164.html#439378"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro </b></font></font></a>(1M), <a href="vxmake_vxvm_manpages50_437196.html#431699"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake </b></font></font></a>(1M), <a href="vxplex_vxvm_manpages56_438209.html#431636"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex </b></font></font></a>(1M), <a href="vxprint_vxvm_manpages58_439087.html#433463"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint </b></font></font></a>(1M), <a href="vxrvg_vxvm_manpages68_434599.html#430474"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrvg </b></font></font></a>(1M), <a href="vxvol_vxvm_manpages85_441003.html#433596"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol </b></font></font></a>(1M), <a href="vradmin_vxvm_manpages7_451866.html#437201"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vradmin </b></font></font></a>(1M) </font>
</blockquote>

<!-- End Main Topic Content -->

   </td>
  </tr>
 </table>
</div>

<div>
<table border="0" cellspacing="0" cellpadding="0" width="100%">
 <tr>
  <td height="18" border="0" cellspacing="0" cellpadding="0" colspan="2" bgcolor="#FFFFFF">
  </td>
 </tr>
  <td align="left"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&nbsp;&#94;&nbsp;<a href="vxrlink_vxvm_manpages66_433229.html" title="vxrlink">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="vxresize_vxvm_manpages65_428209.html" title="Previous - vxresize">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxrootmir_vxvm_manpages67_428605.html" title="Next - vxrootmir">Next</a>
&nbsp;&gt;&nbsp;&nbsp;</font>
  </td>
 <tr>
   <td height="9" border="0" cellspacing="0" cellpadding="0" colspan="2" bgcolor="#FFFFFF">
   </td>
 </tr>

<!-- Footer Breadcrumbs -->
<tr>
<td bgcolor="#FFFFFF" colspan="2" height="15" align="right">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Product:  
<a href="vxvm_manpages_splashpage_docCD_vxvm_manpages1_103036.vxhd" title="Volume Manager Manual Pages for Storage Foundation title page ">Volume Manager Manual Pages for Storage Foundation</a>&nbsp;&nbsp;</font></td>
</tr>

<tr>
<td bgcolor="#FFFFFF" colspan="2" height="15" align="right">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Manual:  
<a href="man1m_titlepage_docCD_vxvm_manpages2_73700.vxhd" title="Maintenance Commands (1m) title page ">Maintenance Commands (1m)</a>&nbsp;&nbsp;</font></td>
</tr>


 <tr>
  <td colspan="2" align="left"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" color="#000000" align="right" size="-2">
<em>VERITAS Software Corporation
</em></font><br>

<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">www.veritas.com</font><br>
  </td>
 </tr>
</table>
</div>

</BODY>
  <!--
    *************************************************************************************
    * Copyright (c) 2005 VERITAS Software Corporation. All rights reserved. *

    VERITAS, VERITAS SOFTWARE, the VERITAS Logo, and VERITAS Software Documentation 
    are trademarks or registered trademarks of VERITAS Software Corporation 
    or its affiliates in the U.S. and other countries. Other names may be 
    trademarks of their respective owners. 

    Apache Jakarta Lucene:
    Apache Software License
    Version 1.1

    Copyright (c) 2000 The Apache Software Foundation. All rights reserved.

    Redistribution and use in source and binary forms, with or without modification, 
    are permitted provided that the following conditions are met:

    1. Redistributions of source code must retain the above copyright notice, this 
    list of conditions and the following disclaimer.

    2. Redistributions in binary form must reproduce the above copyright notice, this 
    list of conditions and the following disclaimer in the documentation and/or other 
    materials provided with the distribution.

    3. The end-user documentation included with the redistribution, if any, must include 
    the following acknowledgment: "This product includes software developed by the Apache 
    Software Foundation (http://www.apache.org/)." Alternately, this acknowledgment may 
    appear in the software itself, if and wherever such third-party acknowledgments 
    normally appear.

    4. The names "Apache" and "Apache Software Foundation" must not be used to endorse or 
    promote products derived from this software without prior written permission. For 
    written permission, please contact apache@apache.org.

    5. Products derived from this software may not be called "Apache", nor may "Apache" 
    appear in their name, without prior written permission of the Apache Software Foundation.

    THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, 
    BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
    PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION 
    OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, 
    OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 
    OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 
    ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 
    NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
    ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    This software consists of voluntary contributions made by many individuals on behalf 
    of the Apache Software Foundation. For more information on the Apache Software Foundation, 
    please see <http://www.apache.org/>. Portions of this software are based upon public domain 
    software originally written at the National Center for Supercomputing Applications, University 
    of Illinois, Urbana-Champaign.
    
    This product includes WebWindow Software developed by Horst Heistermann.
    *************************************************************************************
  -->
</HTML>
