<!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:18">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="vxmake.fm">
     
<title>vxmake</title>

</HEAD>

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

<a name="450355"></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="vol_pattern_vxvm_manpages90_440877.html" title="Previous - vol_pattern">Previous</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">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="man4_titlepage_docCD_vxvm_manpages89_73700.vxhd" title="Devices (4) title page ">Devices (4)</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="437313"></a>vxmake</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="437336"></a> NAME</font>
</h3>
<p>
<a name="437341"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxmake - format of a vxmake description file </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="437344"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437349"></a>Descriptions of configuration records can be given to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> utility either on the command line or in a file. Descriptions given on the command line can specify only one new record.  Descriptions given in a description file can specify more than one record.  The description file format is a convenient way of indicating record contents for other uses as well.  For example, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint</b></font> utility can print records in this format to provide input to a shell or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>awk</b></font> script that can be more easily parsed than other verbose formats. </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="437424"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Although it is possible to use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> to create new volumes from an appropriate description file, it is recommended that you use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvoladm</b></font>, or the graphical user interface instead. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<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="437454"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The Configuration Backup and Restore utilities, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigbackup</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigrestore</b></font>, are the recommended method for backing up and restoring volume hierarchies. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437475"></a>In many places within the utility set where a user can specify a field name and a value, a format is used that specifies only one configuration field, rather than complete configuration records. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="437496"></a> RECORD DESCRIPTION FORMAT</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437501"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> description files specify configuration records, one after another.  Each record description specifies a record type, name, and zero or more fields. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437522"></a>The record type is a single keyword from the set <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plex</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dm</b></font>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dg</b></font>, to indicate a volume, plex, subdisk, disk media, or disk group record, respectively.  The record name must be specified on the same line as the record type keyword. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437561"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> utility does not take disk media or disk group record descriptions on input.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint</b></font> utility can print descriptions of disk media and disk group records in this format though. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437591"></a>Fields are specified as a field name and a field value separated by a single <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>=</b></font> character.  A record description can span more than one line if its continuation lines begin with a character that is a space or tab.  Empty lines are ignored and do not end a record description. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437621"></a>Comments can be included in a record description.  A comment is introduced with the character <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>#</b></font>, either at the beginning of a line, or after a blank that is not used as part of a field value. Comments continue until the next new line character or until the end-of-file. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437660"></a>A field specification normally ends with the next white-space character.  A field can be extended until the end of a line by preceding the field value with one double-quote character (&quot;).  Such quoted strings extend until the next newline, rather than until a double quote.  This makes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> descriptions easier to generate within shell scripts. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437708"></a>An example of a valid configuration file is </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="437726"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vol&nbsp;v1&nbsp;usetype=gen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;simple&nbsp;gen&nbsp;volume&nbsp;with&nbsp;no&nbsp;plexes</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="437731"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">plex&nbsp;p1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;plex&nbsp;with&nbsp;no&nbsp;subdisk</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="437736"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">plex&nbsp;p2&nbsp;sd=s1:0,s2:1&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;striped&nbsp;plex&nbsp;with&nbsp;two&nbsp;columns</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="437741"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;and&nbsp;a&nbsp;comment</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="437751"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;comment=&quot;This&nbsp;is&nbsp;a&nbsp;comment</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="437756"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;layout=stripe&nbsp;ncolumn=2&nbsp;stwidth=64k</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="437766"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">plex&nbsp;p2&nbsp;sd=s3:16384&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;free&nbsp;plex&nbsp;with&nbsp;hole&nbsp;at&nbsp;beginning</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="437776"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">#&nbsp;subdisks</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="437781"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">sd&nbsp;s1&nbsp;disk=disk01&nbsp;len=1g+512m&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;offset=0</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="437786"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">sd&nbsp;s2&nbsp;disk=disk02&nbsp;len=512m-1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;offset=0</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="437791"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">sd&nbsp;s3&nbsp;path=disk03&nbsp;len=32768&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;offset=512m-1</font>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="437801"></a> FIELD DESCRIPTION FORMAT</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437806"></a>Sometimes a utility gets field descriptions from somewhere other than a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> description file and uses that field description to set a field in a volume, plex, or subdisk record.  In these cases, the utility itself has a quoting convention for separating one field from another.  An example of a utility that does this is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437845"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font> utility takes field descriptions from the command line.  For example, the following <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font> command sets a comment for the record named <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v1</b></font>: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="437909"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxedit&nbsp;set&nbsp;comment=&quot;Henry&nbsp;\&quot;Hank\&quot;&nbsp;Finklestein's&nbsp;volume&quot;&nbsp;v1</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437922"></a>Shell quoting conventions are sufficient to allow for double quotes and spaces, so no quoting conventions are defined for these simple field descriptions. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="437952"></a> FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437957"></a>Within <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> description files any volume, plex, or subdisk field can be specified.  However, some field settings are ignored. This allows a user to use a command such as: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="438001"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxprint&nbsp;-vpshm&nbsp;v1</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438017"></a>to get a set of record descriptions that can be fed back into <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>, possibly with some changes.  If this is done, then any field that cannot be set is ignored, but the resulting record hierarchy, plex layout, and subdisk offsets are the same, along with most or all fields that are normally administrator-definable. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438071"></a>Different fields have different properties with respect to the description language.  The classes of fields are </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438090"></a><em>boolean</em></font>
</p>
<p>
<a name="450757"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Boolean fields contain a truth value.  The value for a boolean field can be either <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font>.  Alternately, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>yes</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>no</b></font>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font> can be used.  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint </b></font>prints truth values as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438145"></a><em>device-number</em></font>
</p>
<p>
<a name="450796"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Device numbers define the major and minor number of a device.  These numbers are in the form <em>major-number</em>.<em>minor-number</em> where <em>major-number</em> and <em>minor-number</em> are both simple numbers.  In some cases, the device number will be <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VOLNODEV</b></font>, indicating that the device number is undefined. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438212"></a><em>enumeration</em></font>
</p>
<p>
<a name="450815"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An enumeration field can be set to one of a set of symbolic values. The set of symbolic values for enumeration fields are specified in the field descriptions below.  The enumeration fields are listed in this manual page in upper case.  These enumeration constants can be given as input in either all upper-case letters, or all lower-case letters. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438279"></a><em>length-number</em></font>
</p>
<p>
<a name="450846"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Fields which define object sizes of some type, such as volume lengths, plex offsets, or stripe widths, have the syntax of standard VERITAS Volume Manager length numbers, as defined in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M). This syntax consists of one or more numbers separated by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>+</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>- </b></font>to indicate addition or subtraction. </font>
</p>
<p>
<a name="425143"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each separate number in the string can have a prefix of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>0x</b></font> to indicate that the number is in hexadecimal, or a prefix of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>0</b></font> to indicate octal.  Suffix characters can be used to specify the unit for the number.  Defined suffixes are: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>b</b></font> for 512-byte blocks, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>s</b></font> for standard system sectors, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>k</b></font> for kilobytes, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>m </b></font>for megabytes, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>g</b></font> for gigabytes.  Suffix letters can be specified either upper case or lower case. </font>
</p>
<p>
<a name="425151"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The size of a sector is system dependent.  On most systems it is 512 bytes, the same as blocks.  On systems that support disks with differing sector sizes, one standard sector size is chosen as the standard. </font>
</p>
<p>
<a name="425156"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The unit for a number is in sectors by default.  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint</b></font> prints length numbers as a decimal number of sectors, with no unit suffix. </font>
</p>
<p>
<a name="425159"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Since <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>b</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>B</b></font> are valid digits in a hexadecimal number, a single space must be used to separate the hexadecimal number from the suffix.  Double quote are not necessary in Record Description Format, unlike the rules for string-valued fields that contain spaces. </font>
</p>
<p>
<a name="425164"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Unless otherwise indicated, all length numbers must be greater than or equal to zero. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438609"></a><em>name</em></font>
</p>
<p>
<a name="450924"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A record name field can be an arbitrary string of up to fourteen characters.  However, a name cannot contain a null byte, white-space characters, or the character <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438652"></a><em>record ID</em> or <em>sequence number</em></font>
</p>
<p>
<a name="450947"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">These types are 64-bit numbers encoded as two 32-bit unsigned simple numbers.  These are values assigned to records or to configuration changes, respectively.  The record ID assigned to a record is guaranteed to be unique within that disk group.  Also, that record ID will never be reused if the record is deleted. </font>
</p>
<p>
<a name="425179"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Every time the configuration of a disk group is updated, the configuration update sequence number is increased.  The configuration update sequence number only increases; it never decreases.  This can be used to determine the order in which records were changed, or as a quick test for what has changed since a known time in the past. </font>
</p>
<p>
<a name="425185"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Record IDs and sequence numbers have the form <em>high-part</em>.<em>low-part</em>, where both <em>high-part</em> and <em>low-part</em> are simple unsigned numbers. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438829"></a><em>simple-number</em></font>
</p>
<p>
<a name="450996"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Simple numbers are used for counts or for other purposes besides representation of a length of offset.  Simple numbers can be specified in decimal (default), hexadecimal, or octal using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>0x</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>0</b></font> prefixing convention.  No suffixes or arithmetic are defined for simple numbers. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438896"></a><em>string</em></font>
</p>
<p>
<a name="451015"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Other types of string fields can contain any characters other than a null byte or a newline.  Different string fields have different length restrictions. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438938"></a>Some additional one-of-a-kind field types also exist.  These are described in the description for the corresponding field. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438956"></a>Many fields have aliases that can be used in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake </b></font>descriptions.  In all cases, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint -m</b></font> format uses the first name given for each field.  However, alias field names can be used in format strings specified to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint</b></font> with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-F </b></font>option.  All field names containing underscores have an alias that is identical but lacks the underscores.  For example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>start_opts </b></font>has an alias of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>startopts</b></font>. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="439034"></a> VOLUME RECORD FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439039"></a>The following fields are defined for volume records: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439046"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>active</b></font></font>
</p>
<p>
<a name="451066"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean.  This is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if the volume was open and had at least one pending write at the time of the last system failure. Utilities can use this flag to indicate that plex consistency recovery should be performed.  If this flag is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>, the volume should not require any recovery. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439113"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>badlog</b></font></font>
</p>
<p>
<a name="451097"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean.  This flag is set to <em>on</em> if write failures occur on all logging subdisks for a volume that has dirty region logging enabled.  Dirty region logging cannot be re-enabled until this flag is turned off.  This flag can be turned off by changing the logging type of the volume to <em>NONE</em> and setting it back to <em>DRL</em>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439180"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bdev</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dev</b></font>)</font>
</p>
<p>
<a name="451120"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The block device number for the volume.  This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439211"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cache_name</b></font></font>
</p>
<p>
<a name="451139"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string containing the name of the cache if the volume is a cache volume that is used in space-optimized instant snapshot operation. This field is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439254"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cascaded</b></font></font>
</p>
<p>
<a name="451158"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether an instant snapshot volume reads data from a sibling snapshot volume instead of from its parent volume. This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439297"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cdev</b></font></font>
</p>
<p>
<a name="451177"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The character (raw) device number for the volume.  This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439328"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment</b></font></font>
</p>
<p>
<a name="451196"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A comment-type field of up to 40 characters.  This is reserved for use by local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439359"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>config_id</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>config_epoch</b></font></font>
</p>
<p>
<a name="451231"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Simple unsigned number fields.  These are the lower and upper 32 bits, respectively, of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>update_tid</b></font> field.  These fields are provided for backward compatibility with earlier releases of VxVM. This field is not printed by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-m</b></font> flag to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint</b></font>. </font>
</p>
<p>
<a name="425259"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">These are read-only fields and attempts to set them will be ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439445"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>detach_tid</b></font></font>
</p>
<p>
<a name="451253"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The configuration update sequence number in effect the last time the plex was detached by an I/O failure.  This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439488"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fastresync</b></font></font>
</p>
<p>
<a name="451272"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean. This indicates whether or not FMR is enabled. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439507"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>forceminor</b></font></font>
</p>
<p>
<a name="451295"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean.  If this is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font>, then the volume can use one of the reserved minor numbers (zero through four). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439538"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fstype</b></font></font>
</p>
<p>
<a name="451314"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A name field.  This is the file system type associated with the volume contents.  A usage type is free to use or ignore this value. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439569"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>group</b></font></font>
</p>
<p>
<a name="451333"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is either a group name or a decimal group ID.  The value specifies the user that owns the volume block and character devices. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439600"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>hasdcomap</b></font></font>
</p>
<p>
<a name="451356"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether the volume has a data change object (DCO) volume. The value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>instant</b></font> field indicates whether the DCO supports instant snapshot operations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439655"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>incomplete</b></font></font>
</p>
<p>
<a name="451375"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether the contents of an instant snapshot volume are dependent on another volume (that is, it is not fully synchronized). This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439711"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>inst_invalid</b></font></font>
</p>
<p>
<a name="451394"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether an instant snapshot volume is not usable. A volume fails to start if this flag is set on. This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439755"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>inst_src_guid</b></font></font>
</p>
<p>
<a name="451413"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The global unique ID of the source volume for an incomplete snapshot volume. This field is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439786"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>instant</b></font></font>
</p>
<p>
<a name="451432"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether the DCO that is associated with a volume supports instant snapshot operations. </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="425306"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Instant snapshot operations require that the DCO version is 20 or greater. Version 0 DCOs do not support such operations. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425309"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439867"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>iosize</b></font></font>
</p>
<p>
<a name="451462"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The smallest I/O size allowed on the volume.  This corresponds to the largest sector size for any disk included in the volume.  The current release of VxVM does not support disks with differing sector sizes.  As a result, in the current release this value will always match the system default sector size (normally 512 bytes). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439934"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>iscachevol</b></font></font>
</p>
<p>
<a name="451481"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether a volume is being used as a cache volume for space-optimized instant snapshot operations. This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439977"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>kstate</b></font></font>
</p>
<p>
<a name="451512"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An enumeration field.  This is the kernel-enabled state of the volume. Possible values are <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENABLED</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DISABLED</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DETACHED</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440008"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>lasterr</b></font></font>
</p>
<p>
<a name="451531"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A simple number field.  This is the sequence number of the last error on the volume.  It is a read-only field and attempts to set it are ignored.  This number does not have a default multiplier, so lack of a suffix specifies a simple integer. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440063"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>len</b></font></font>
</p>
<p>
<a name="451558"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A length number field.  This is the volume length.  If a volume is created in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> with a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plex</b></font> attribute that associates plexes, the volume length will default to the length of the shortest associated plex.  If no plexes are associated at creation time, the volume length defaults to zero, though a warning will be printed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440130"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>log_len</b></font></font>
</p>
<p>
<a name="451581"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The length for the volume's logging area.  This is primarily intended for use with future logging types.  When used with dirty region logging, the only currently available method of logging, the value of <em>log_len</em> must be an even number of blocks between two and ten blocks long. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440197"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>logmap_len=</b></font><em>size</em></font>
</p>
<p>
<a name="451608"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the maximum usable size of a DRL or DCM log. This value must be a positive integer multiple of the alignment value for the disk group (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M)). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440240"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>log_serial_lo</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>log_serial_hi</b></font></font>
</p>
<p>
<a name="451631"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Simple unsigned number fields.  These values, taken together, yield a value that is increased for every log write that occurs to a volume with logging enabled. </font>
</p>
<p>
<a name="425357"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">These are read-only fields and attempts to set them are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440302"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>log_type</b></font></font>
</p>
<p>
<a name="451665"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An enumeration field.  This is the logging type for the volume. Possible values are: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>UNDEF</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NONE</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DRL</b></font>.  The first two possible values indicate that logging is disabled, and the third value indicates use of dirty region logging, where block numbers for write operations are logged before the corresponding blocks are actually written to disk. </font>
</p>
<p>
<a name="425367"></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>UNDEF</b></font> value indicates that no logging policy has yet been chosen.  If a log subdisk is associated to a volume with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>UNDEF</b></font> policy, the policy will be changed to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DRL </b></font>automatically. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440436"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>logging</b></font></font>
</p>
<p>
<a name="451707"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field.  This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if logging is enabled on the volume.  Logging is enabled for a volume if the log type for the volume supports logging, the volume is enabled, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>badlog</b></font> flag is not set, and the volume has at least one enabled, associated plex with an enabled log subdisk.  Normally, usage types do not enable logging if only one plex in the volume has a log subdisk. </font>
</p>
<p>
<a name="425380"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440534"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>minor</b></font></font>
</p>
<p>
<a name="451737"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A simple number field.  This is the minor number to use for the volume block and character devices.  If volumes in two disk groups attempt to use the same minor number, one of the volumes will be given a different one.  To determine the actual device number used for a particular volume, get the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cdev</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bdev</b></font> fields. </font>
</p>
<p>
<a name="425389"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If a minor number is specified as input to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>, the number will be used if it is not already in use, or is reserved; otherwise, a minor number will be chosen that is not currently in use or reserved. Minor numbers from zero to four are reserved for internal purposes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440656"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mode</b></font></font>
</p>
<p>
<a name="451767"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a symbolic or numeric file permission mode.  This can be any string that is acceptable to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>chmod</b></font>(1) for setting the mode of a file. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440699"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>open</b></font></font>
</p>
<p>
<a name="451790"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field.  This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if the volume is open or mounted. This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440730"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_num</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nplex</b></font>)</font>
</p>
<p>
<a name="451813"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number field.  This is the number of plexes associated with the volume.  This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440761"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plex</b></font></font>
</p>
<p>
<a name="451836"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A list of names for plexes to associate with the volume.  The names are separated in the list by a comma or by blanks.  If a list is specified as input to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>, then the indicated plexes will be associated with the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440816"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil2</b></font></font>
</p>
<p>
<a name="451863"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Comment-type fields of up to fourteen characters.  These are the permanent utility fields, which are preserved across a reboot.  The first field is reserved for usage-type utilities.  The second field is reserved for utilities, such as VERITAS Enterprise Administrator (VEA), that use the usage-type utilities and that need to store their own state into records. The third field is reserved for local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440907"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>read_pol</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pref_name</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pref_plex_rid</b></font>, </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440914"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>current_read_pol</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>creadpol</b></font>) <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>read_pol</b></font> is an enumeration field.  This is the read policy for the volume.  Possible values are <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ROUND</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PREFER</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SELECT</b></font>.  A value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ROUND</b></font> indicates round-robin read scheduling, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PREFER</b></font> indicates a preferred plex.  Round-robin scheduling scatters reads evenly between all plexes.  Preferred-plex read scheduling attempts to use a single plex for all reads. </font>
</p>

<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425434"></a>Typically, if a volume consists of one striped plex and one non-striped plex, it is better to read only from the striped plex. This is because the striped plex can handle more write traffic and is thus more likely to be free to accept read requests with a minimum of delay. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425440"></a>If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SELECT</b></font> read policy is used, the actual read policy (round-robin or preferred plex), is chosen automatically.  The policy chosen with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SELECT</b></font> is to prefer a striped plex if there is exactly one striped plex in the volume, and to use round-robin otherwise.  The read policy that is actually in effect is stored in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>current_read_pol</b></font>. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425447"></a>If a preferred plex policy is in effect, either because <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PREFER </b></font>is set or because the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SELECT</b></font> policy chose the preferred-plex policy, the value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pref_name</b></font> indicates the name of the preferred plex.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SELECT</b></font> policy sets the value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pref_name</b></font> automatically.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ROUND</b></font> policy ignores any value stored in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pref_name</b></font>. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425454"></a>The record ID for the preferred plex can be set or displayed with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pref_plex_rid</b></font>. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441249"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>r_all</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>r_some</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>w_all</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>w_some</b></font></font>
</p>
<p>
<a name="452022"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Enumeration fields.  These are the exception policies for the volume, for read errors on all plexes, read errors on some plexes, write errors on all plexes, and write errors on some plexes.  Possible values for these fields are <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NO_OP</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>FAIL_OP</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DET_PL</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>FAIL_DET_PL</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DET_VOL</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>FAIL_DET_VOL</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GEN_DET</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GEN_DET_SPARSE</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GEN_FAIL</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GEN_DET2</b></font>. </font>
</p>
<p>
<a name="425474"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Usage types normally ignore any attempts to set these fields in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441467"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>restore</b></font></font>
</p>
<p>
<a name="452048"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether the contents of a volume are being restored from an instant snapshot. This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441510"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rid</b></font></font>
</p>
<p>
<a name="452067"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID for the volume record. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441529"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rwback</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>krwback</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rwback_offset</b></font></font>
</p>
<p>
<a name="452122"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rwback</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>krwback</b></font> are booleans.  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rwback_offset</b></font> is a length number.  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rwback</b></font> is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> to enable read-writeback mode on a volume.  If this is set, then reads from the volume past <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rwback_offset</b></font> perform a recovery procedure that ensures that all plexes are consistent before the read operation completes.  Reads that occur at the current read-writeback offset will advance the offset.  If the read-writeback offset reaches the end of the volume, read-writeback will be turned off.  The value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>krwback</b></font> indicates whether read-writeback is actually in effect. </font>
</p>
<p>
<a name="425496"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">These fields are set by usage types.  Attempts to set these fields in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441675"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snap_after_restore</b></font></font>
</p>
<p>
<a name="452148"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether a snapshot volume was created while its parent volume was being restored. This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441718"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>source</b></font></font>
</p>
<p>
<a name="452167"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the source volume for an incomplete snapshot volume. This field is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441749"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>start_opts</b></font></font>
</p>
<p>
<a name="452190"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A comment-type field of up to 32 characters.  This field is used in a usage-type-dependent manner.  The existing usage types use this field as a set of options to apply to the volume for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol start </b></font>operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441804"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>state</b></font></font>
</p>
<p>
<a name="452209"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A comment field of up to fourteen characters.  This field represents a usage-type-dependent volume state. </font>
</p>
<p>
<a name="425518"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Usage types normally ignore attempts to set this field in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441866"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil2</b></font></font>
</p>
<p>
<a name="452243"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Comment-type fields of up to fourteen characters.  These are the temporary utility fields, which are cleared by a reboot.  The first field is reserved for usage-type utilities, and is typically used to define operation locks.  The second field is reserved for utilities, such as VERITAS Enterprise Administrator (VEA), that use the usage-type utilities and that need to store their own state into records.  The third field is reserved for use by local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441957"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>update_tid</b></font></font>
</p>
<p>
<a name="452262"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The configuration update sequence number for the last transaction to update this record.  This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442000"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>use_type</b></font></font>
</p>
<p>
<a name="452281"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A name field.  This is the name of the usage type for the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442019"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>user</b></font></font>
</p>
<p>
<a name="452300"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is either a user name or a decimal user ID.  The value specifies the user that owns the volume block and character devices. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442050"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vset_context</b></font></font>
</p>
<p>
<a name="452319"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The context string assigned to this volume within a volume set. This field is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442081"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vset_id</b></font></font>
</p>
<p>
<a name="452338"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The index of this volume within a volume set. This field is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442112"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vset_rid</b></font></font>
</p>
<p>
<a name="452357"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the volume set of which this volume is a member. This field is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442143"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>writeback</b></font></font>
</p>
<p>
<a name="452380"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field.  If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font>, then if a read failure on one plex of a multiplex volume the block will be read from another plex and written back to the plex with the failure.  This often corrects the I/O failure.  If the writeback succeeds, the failure is ignored and no action is taken to detach the plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442222"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>writecopy</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>specify_writecopy</b></font></font>
</p>
<p>
<a name="452411"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Boolean fields.  If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>writecopy</b></font> is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font>, then writes to the volume will be copied prior to being written to disk.  This prevents pages of memory that are undergoing changes from causing plexes in a volume to become inconsistent. </font>
</p>
<p>
<a name="425568"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Normally, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>writecopy</b></font> is not needed because the system pager ensures that a consistent version of each page is written to the volume prior to a clean system shutdown.  For most volumes, recovery after an unclean system shutdown (that is, after a panic, unintended reset, or power failure) recovers all blocks in a volume to have consistent data between each plex. </font>
</p>
<p>
<a name="425575"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">However, volumes which use the dirty region logging or RAID-5 logging features recover only those regions which were being written at the time of an unclean shutdown. If some regions were written inconsistently at some point prior to a shutdown, then recovery may not ensure consistency of these regions. (The dirty region logging feature is enabled when <em>log_type</em> is set to <em>DRL</em> and at least one plex has a log subdisk and the volume has at least two read-write mode plexes.) </font>
</p>
<p>
<a name="425584"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>specify_writecopy</b></font> is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>, VxVM automatically sets the value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>writecopy</b></font> to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if block-change logging is enabled on the volume, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font> otherwise. If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>specify_writecopy</b></font> is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font>, the setting of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>writecopy</b></font> flag is overridden and writecopy stabilization is enforced. </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="425601"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> To reduce the overhead of write operations, it is desirable to turn off <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>writecopy</b></font> altogether for block-change logging volumes. The behavior of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>specify_writecopy</b></font> may change in a future release so that when <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>specify_writecopy</b></font> is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font>, the user is responsible for setting <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>writecopy</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>, and when <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>specify_writecopy</b></font> is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>, VxVM is responsible for setting <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>writecopy</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425609"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit(1M)</b></font> manual page for more information. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="442647"></a> VOLUME SET FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442652"></a>The following fields are defined for volume set records: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442659"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>appvols</b></font></font>
</p>
<p>
<a name="452546"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A comma-separated string that lists the component volumes of the volume set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442690"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ch</b></font></font>
</p>
<p>
<a name="452565"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The content-handler string for the volume set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442709"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment</b></font></font>
</p>
<p>
<a name="452584"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A comment string that describes the volume set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442728"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>context</b></font></font>
</p>
<p>
<a name="452603"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A context string that defines the volume set for an application. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442747"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>kstate</b></font></font>
</p>
<p>
<a name="452622"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The kernel state of the volume set. This field is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442766"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>state</b></font></font>
</p>
<p>
<a name="452641"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The state of the volume set. This field is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442785"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol_num</b></font></font>
</p>
<p>
<a name="452660"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The number of volumes in the volume set. This field is read-only. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="442803"></a> PLEX RECORD FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442808"></a>The following fields are defined for plex records: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442815"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment</b></font></font>
</p>
<p>
<a name="452679"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A comment-type field of up to 40 characters.  This is reserved for use by local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442846"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>compact</b></font></font>
</p>
<p>
<a name="452702"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field.  This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if the plex is compact.  A compact plex has no holes; that is, has no regions within the length of the plex that aren't backed by a subdisk.  This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442901"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>complete</b></font></font>
</p>
<p>
<a name="452737"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field.  This is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> to indicate to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GEN_DET</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GEN_DET2</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GEN_DET_SPARSE</b></font> exception policies that the plex should be considered to be complete, relative to any volume to which the plex is associated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442968"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>config_len</b></font></font>
</p>
<p>
<a name="452768"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A length number field.  This is the offset of the first block in the plex that doesn't map to a subdisk.  If the plex is compact, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>contig_len</b></font> will equal <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>len</b></font>; otherwise, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>contig_len </b></font>will identify where the first hole in the plex is. </font>
</p>
<p>
<a name="425663"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443042"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>iomode</b></font></font>
</p>
<p>
<a name="452822"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A pseudo enumeration field.  This field does not represent an explicit enumeration field in the plex record.  Rather it represents the possible values in the plex <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_tflag</b></font> structure element (which is not accessible through the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> description format) that form the I/O mode of the plex.  Possible values are <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NONE</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RO</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>WO</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RW</b></font>, which mean no I/O is possible, read-only, write-only and read-write, respectively.  In general, only <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RW </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>WO</b></font> are useful. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443145"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>kdetach</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>iofail</b></font>)</font>
</p>
<p>
<a name="452849"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field.  This is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if the plex becomes detached as a result of an I/O failure.  If this is set, the plex contents may be out-of-date and will require recovery from another plex in the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443200"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>kstate</b></font></font>
</p>
<p>
<a name="452880"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An enumeration field.  This is the kernel-enabled state of the plex. Possible values are <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENABLED</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DISABLED</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DETACHED</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443231"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>lasterr</b></font></font>
</p>
<p>
<a name="452899"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number field.  This is the sequence number of the last error on the volume.  It is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443262"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>layout</b></font></font>
</p>
<p>
<a name="452934"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An enumeration field.  This specifies how blocks in the plex address space map onto blocks.  Possible values are <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>CONCAT</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>STRIPE</b></font>.  A value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>CONCAT</b></font> indicates that subdisks are simply concatenated together to form the blocks in the plex address space.  A value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>STRIPE</b></font> indicates that columns made up of subdisks are mapped onto the plex address space. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443341"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>len</b></font></font>
</p>
<p>
<a name="452953"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A length number field.  This is the length of the plex.  The length of a plex is computed from the end of the associated subdisk that has the largest plex offset. </font>
</p>
<p>
<a name="425706"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443403"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>log</b></font></font>
</p>
<p>
<a name="452983"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field.  This is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> to enable use of any log subdisk associated with the plex.  If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>, then any associated log subdisk is ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443446"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>log_sd</b></font></font>
</p>
<p>
<a name="453014"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A name field.  This is the name of an associated log subdisk, if such a subdisk has been associated to the plex with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd aslog </b></font>operation.  This can be specified as input to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> to specify that the subdisk should be associated to the plex by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443501"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>log_sd_rid</b></font></font>
</p>
<p>
<a name="453037"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the log subdisk.  Attempts to set this field in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443532"></a><em>ncolumn</em></font>
</p>
<p>
<a name="453064"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number of stripe columns. If the value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>layout</b></font> is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>STRIPE</b></font>, then this specifies the number of columns in the striped plex. This number must be nonnegative. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443575"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodevice</b></font>)</font>
</p>
<p>
<a name="453095"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field.  This is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if the disk for one of the subdisks in the plex has the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> flag set.  This implies that the physical disk backing a subdisk either could not be found after a reboot, or failed entirely during operation. </font>
</p>
<p>
<a name="425737"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443649"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>noerror</b></font></font>
</p>
<p>
<a name="453133"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field.  This field is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if I/O errors on the plex should <em>not</em> result in actions based on the volume exception policies.  This maps onto setting the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PL_PFLAG_NOERROR</b></font> flag in the plex <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_pflag</b></font> structure element. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443704"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil2</b></font></font>
</p>
<p>
<a name="453160"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Comment-type fields of up to fourteen characters.  These are the permanent utility fields.  The first field is reserved for use by usage-type utilities.  The second field is reserved for use by utilities, such as VERITAS Enterprise Administrator (VEA), that use the usage-type utilities and that need to store their own state into records.  The third field is reserved for use by local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443795"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font></font>
</p>
<p>
<a name="453191"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field.  This is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if the disk for one of the subdisks in the plex has the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> flag set.  This implies that the physical disk backing a subdisk was removed by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg rmdisk</b></font> operation. </font>
</p>
<p>
<a name="425764"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443869"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rid</b></font></font>
</p>
<p>
<a name="453213"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID for the plex record. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443888"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_num</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nsd</b></font>)</font>
</p>
<p>
<a name="453236"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A simple number field.  This is the number of subdisks associated with the plex.  It is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443919"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd</b></font></font>
</p>
<p>
<a name="453255"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A list of subdisks to associate with the plex.  Each subdisk is separated by a comma.  A specific plex offset can be given for a subdisk by following the subdisk name with a colon and a number.  If no plex offset is specified, then the subdisk is associated at the end of the previous subdisk in the list.  The default plex offset for the first subdisk in the list is zero. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443998"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snap_rid</b></font></font>
</p>
<p>
<a name="453274"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID (rid) of the original volume. This field is set during a snapshot operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444030"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>st_width</b></font></font>
</p>
<p>
<a name="453301"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A length number field.  If the value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>layout</b></font> is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>STRIPE</b></font>, then this specifies the length of each stripe.  This length must be non-negative and must be an even multiple of a block (512 bytes on most machines). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444085"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stale</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>recover</b></font>)</font>
</p>
<p>
<a name="453328"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field.  This is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if a disk is removed that containing one of the subdisks in the plex, or if the disk for one of the subdisks fails while the plex is in use.  If this is set, the plex contents may be out-of-date and will require recovery from another plex in the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444152"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>state</b></font></font>
</p>
<p>
<a name="453351"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A comment field of up to fourteen characters.  This is a usage-type-dependent volume state.  Typically, usage types will ignore any attempts to set this field in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444195"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil2</b></font></font>
</p>
<p>
<a name="453378"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Comment-type fields of up to fourteen characters.  These are the temporary utility fields.  The first field is reserved for usage-type utilities.  The second field is reserved for utilities, such as VERITAS Enterprise Administrator (VEA), that use the usage-type utilities and that need to store their own state into records.  The third field is reserved for local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444286"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>update_tid</b></font></font>
</p>
<p>
<a name="453397"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The configuration update sequence number for the last transaction to update this record.  This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444329"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_name</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volume</b></font>)</font>
</p>
<p>
<a name="453424"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A name field.  This is the name of the volume to which the plex is associated.  This is a read-only field when used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> utility and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444372"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol_rid</b></font></font>
</p>
<p>
<a name="453447"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the associated volume.  If the plex isn't associated, the value of this field is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>0.0</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444403"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volatile</b></font></font>
</p>
<p>
<a name="453482"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field.  This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if any subdisk associated with the plex has its <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volatile</b></font> flag set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font>; otherwise, this is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>.  This is a read-only field and attempts to set it are ignored. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="444457"></a> SUBDISK RECORD FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444462"></a>The following fields are defined for subdisk records: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444469"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment</b></font></font>
</p>
<p>
<a name="453501"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A comment-type field of up to 40 characters.  This is reserved for use by local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444500"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>config_id</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>config_epoch</b></font></font>
</p>
<p>
<a name="453536"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Simple unsigned number fields.  These are the lower and upper 32 bits, respectively, of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>update_tid</b></font> field.  These fields are provided for backward compatibility with earlier releases of VxVM. This field is not printed by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-m</b></font> flag to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint</b></font>. </font>
</p>
<p>
<a name="425846"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">These are read-only fields and attempts to set them will be ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444586"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>da_name</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>device</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>accessname</b></font>)</font>
</p>
<p>
<a name="453582"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the disk access record used to access the physical disk that backs the subdisk.  If the disk media record is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> state, then this will be empty.  This can be used as an alternative to setting <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dm_name </b></font> as a means of specifying the disk to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444665"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dev</b></font></font>
</p>
<p>
<a name="453605"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is the device number of the public region for the disk that the subdisk resides on.  If the disk is removed or failed, the value for this field is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VOLNODEV</b></font>.  This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444720"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dev_offset</b></font></font>
</p>
<p>
<a name="453632"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A length number.  This is the offset of the subdisk from the beginning of the device containing the private region of the disk that backs it. This is not defined (prints as an empty string) if the disk media record for the subdisk is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> state. This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444787"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dm_name</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>medianame</b></font>)</font>
</p>
<p>
<a name="453663"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the disk media record that the subdisk is defined on. This field is the primary means of defining the disk as input to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake </b></font></font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444830"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dm_offset</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>offset</b></font>)</font>
</p>
<p>
<a name="453686"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A length number.  This is the offset of the subdisk from the beginning of the private region of the disk that backs it.  This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444873"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dm_rid</b></font></font>
</p>
<p>
<a name="453713"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the disk media record that the subdisk is defined on. This can be used as an alternative to setting <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dm_name</b></font> as a means of specifying the disk to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444916"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>is_log</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>log</b></font>)</font>
</p>
<p>
<a name="453740"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field.  This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if the subdisk is associated with a subdisk as a log subdisk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444947"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>len</b></font></font>
</p>
<p>
<a name="453759"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A length number.  This is the subdisk length.  The length must be a nonnegative number, and must be a multiple of a standard disk block (512 bytes on most machines). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444990"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>open</b></font></font>
</p>
<p>
<a name="453782"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field.  This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if the associated volume is open or mounted. This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445021"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>path</b></font></font>
</p>
<p>
<a name="453805"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A comment-type string field of up to 32 characters.  This is the path to the block device for the public region of the disk that the subdisk resides on.  If the disk is currently failed or removed, this field is empty.  This field can be specified as an alternative to setting <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dm_name</b></font> when creating a subdisk record, in which case it will be used to determine the disk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445100"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_offset</b></font></font>
</p>
<p>
<a name="453824"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A length number.  This is the offset of the subdisk in address space of the plex address.  If the subdisk is not associated, the field is not defined (prints as an empty string).  This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445155"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_name</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plex</b></font>)</font>
</p>
<p>
<a name="453847"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A name field.  This is the name of the plex to which the subdisk is associated.  This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445198"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plex_rid</b></font></font>
</p>
<p>
<a name="453870"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the plex to which the subdisk is associated.  If the subdisk is not associated, this is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>0.0</b></font>.  This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445241"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil2</b></font></font>
</p>
<p>
<a name="453897"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Comment-type fields of up to fourteen characters.  These are the permanent utility fields.  The first field is reserved for usage-type utilities.  The second field is reserved for utilities, such as VERITAS Enterprise Administrator (VEA), that use the usage-type utilities and that need to store their own state into records.  The third field is reserved for local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445332"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rid</b></font></font>
</p>
<p>
<a name="453916"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID for the subdisk record. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445351"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>subcache</b></font></font>
</p>
<p>
<a name="453935"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether a subdisk is a component of a cache used for space-optimized instant snapshot operations. This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445394"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil2</b></font></font>
</p>
<p>
<a name="453962"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Comment-type fields of up to fourteen characters.  These are the temporary utility fields.  The first field is reserved for usage-type utilities.  The second field is reserved for utilities, such as VERITAS Enterprise Administrator (VEA), that use the usage-type utilities and that need to store their own state into records.  The third field is reserved for local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445485"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>update_tid</b></font></font>
</p>
<p>
<a name="453981"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The configuration update sequence number for the last transaction to update this record.  This is a read-only field and attempts to set it are ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445528"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volatile</b></font></font>
</p>
<p>
<a name="454020"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field.  This is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if the disk that backs the subdisk is defined to be <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volatile</b></font>.  See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk</b></font>(1M) for information on how to create a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volatile</b></font> disk with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font> disk type.  Typically, such disks represent RAM disks defined in memory that is reset by a reboot or a power failure. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="445594"></a> DCO RECORD FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445599"></a>The following fields are defined for DCO records. These fields may be used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint</b></font> but not with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake </b></font>command. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445630"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>drl</b></font></font>
</p>
<p>
<a name="454047"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether dirty region logging (DRL) is enabled for a version 20 DCO. (The DRL maps are stored in the DCO volume.) </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="425971"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> DRL support within a DCO volume requires that the DCO version is 20 or greater. Version 0 DCOs do not support this feature. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425975"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445735"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>regionsz</b></font></font>
</p>
<p>
<a name="454077"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Version 0 DCOs do not support this feature. The DCO region size in blocks. This field is read-only and does not apply to version 0 DCOs. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445778"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sequentialdrl</b></font></font>
</p>
<p>
<a name="454096"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether sequential DRL is enabled for a version 20 DCO. </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="425986"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> DRL support within a DCO volume requires that the DCO version is 20 or greater. Version 0 DCOs do not support this feature. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425990"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This field is read-only and does not apply to version 0 DCOs. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445871"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>version</b></font></font>
</p>
<p>
<a name="454126"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The version number of the DCO. </font>
</p>
<p>
<a name="425995"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Version 0 DCOs support Persistent FastResync. </font>
</p>
<p>
<a name="425997"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Version 20 DCOs support full-sized and space-optimized instant snapshot operations, DRL and sequential DRL logs within the DCO volume, and Persistent FastResync. </font>
</p>
<p>
<a name="426002"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This field is read-only. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="445982"></a> SNAP OBJECT RECORD FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445987"></a>The following fields are defined for snap object records that are used to implement instant snapshot operations (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap</b></font>(1M)). These fields may be used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint</b></font> command, but not with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> command. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446042"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>child</b></font></font>
</p>
<p>
<a name="454166"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value that indicates whether a snap object is associated with a child snapshot volume. This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446085"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>copymap</b></font></font>
</p>
<p>
<a name="454185"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value that indicates whether a snap object is in use by a copymap that is created during a reattach operation. This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446128"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>guid</b></font></font>
</p>
<p>
<a name="454204"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The global unique ID of the snap object. This field is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446159"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>parent</b></font></font>
</p>
<p>
<a name="454223"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value that indicates whether a snap object is associated with a parent volume. This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446202"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>restore</b></font></font>
</p>
<p>
<a name="454242"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value that indicates whether a snap object is the source volume for a restore operation. This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446245"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>restore_tgt</b></font></font>
</p>
<p>
<a name="454261"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value that indicates whether a snap object is the target volume for a restore operation. This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446288"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snap_delete</b></font></font>
</p>
<p>
<a name="454280"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value that indicates whether this snap object is to be deleted. This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446332"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snap_resync</b></font></font>
</p>
<p>
<a name="454299"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value that indicates whether the snapshot that is being tracked by this snap object must be resynchronized when it is restarted. This flag is read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446387"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>temp_restore</b></font></font>
</p>
<p>
<a name="454318"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value that indicates whether a snap object is a temporary state created during a restore operation. This flag is read-only. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="446429"></a> CACHE OBJECT RECORD FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446434"></a>The following fields are defined for cache object records. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446441"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>autogrow</b></font></font>
</p>
<p>
<a name="454337"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value that indicates whether the cache volume can be grown automatically as required. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446472"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>autogrowby</b></font></font>
</p>
<p>
<a name="454364"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A length value that specifies the amount by which the cache volume is grown automatically if its usage reaches the value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>highwatermark </b></font>and the new size would not exceed <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxautogrow</b></font>. The default value is calculated as 10% of the cache size. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446527"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>highwatermark</b></font></font>
</p>
<p>
<a name="454383"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An integer value that specifies the percentage of the cache volume that must be in use before the cache volume can be grown automatically. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446558"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxautogrow</b></font></font>
</p>
<p>
<a name="454402"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A length value that specifies the maximum size of the cache volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446577"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>regionsize</b></font></font>
</p>
<p>
<a name="454425"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A length number that determines the size of the volume regions that are tracked and recorded in the cache. The value must be a power of 2, and be greater than or equal to 16k (16KB). The default <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>regionsize</b></font> is 64k (64KB). </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="426111"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The region size cannot be increased once the cache object has been created. 
</font>
<hr noshade size="2" width="100%" color="#000000">

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="446662"></a> DISK MEDIA RECORD FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446667"></a>The following fields are defined for disk media records. Note that disk media records cannot be created using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446686"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>allocator_nouse</b></font></font>
</p>
<p>
<a name="454460"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean. This is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if a disk is not to be used with the Intelligent Storage Provisioning (ISP) feature. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446717"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>allocator_reserved</b></font></font>
</p>
<p>
<a name="454483"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean. This is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if a disk is only to be used with the Intelligent Storage Provisioning (ISP) feature. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446748"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>atomic_iosize</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>iosize</b></font>)</font>
</p>
<p>
<a name="454514"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The sector size of the device that backs the disk media record.  This field is undefined (prints as an empty string) if the disk media record is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> state. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446791"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>autoconfig</b></font></font>
</p>
<p>
<a name="454557"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean.  This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if the disk access record that underlies the disk media record was auto-configured during system startup. This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font> if the disk media record is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> state, or if the disk access record was created explicitly with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk define</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk init</b></font>. </font>
</p>
<p>
<a name="426138"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk</b></font>(1M) for more information. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446877"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment</b></font></font>
</p>
<p>
<a name="454583"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A comment-type field of up to 40 characters.  This is reserved for use by local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446908"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>component</b></font></font>
</p>
<p>
<a name="454618"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean.  This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if the public and private regions are properly defined. This if <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font> if the disk media record is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> state. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446965"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>da_name</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>device</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>accessname</b></font>)</font>
</p>
<p>
<a name="454653"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the disk access record that can be used to access the disk that backs the disk media record.  This is empty if the disk has the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> flags set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447008"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>da_type</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>type</b></font>)</font>
</p>
<p>
<a name="454688"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The disk type for the disk access record that backs the disk media record.  See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk</b></font>(1M) for a description of disk types.  This field is empty if the disk media record is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> state. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447063"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>device_tag</b></font></font>
</p>
<p>
<a name="454715"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A name identifying the device that the disk access record references. If two or more disk access records identify the same actual device the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>device_tag</b></font> will be the same for both disk access records. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>device_tag</b></font> field is inherited by the disk media record from the disk access record. </font>
</p>
<p>
<a name="426168"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This field is empty if the disk media record is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed </b></font>or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> state. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447161"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>diskid</b></font></font>
</p>
<p>
<a name="454757"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The disk ID for the physical disk that backs the disk media record. This is a 64-byte string that matches the disk ID stored in the disk header of the disk on which this disk media record is defined.  This field is empty if the disk is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> state. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>diskid</b></font> will be set to a new value if the disk media record is reassociated using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg -k adddisk</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447240"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>last_da_name</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>last_device</b></font>)</font>
</p>
<p>
<a name="454784"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the last disk access record used by the disk media record. This is set whenever the disk access record changes.  The disk access record used for a disk media record can change if disks are moved during a reboot, or if a disk is replaced.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>last_da_name </b></font>field is preserved if a disk fails or is removed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447307"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodevice</b></font>)</font>
</p>
<p>
<a name="454811"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean.  This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if the physical disk underlying the disk media record could not be found during system startup, or if it failed completely during system operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447350"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>priv_bpath</b></font></font>
</p>
<p>
<a name="454830"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The path to the block device containing the private region for the disk.  The private region is the region of the disk used to allocate configuration information, disk headers, and other on-disk structures that are used by VxVM. None of the private region can be allocated to volumes or used for uses outside of VxVM. </font>
</p>
<p>
<a name="426199"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This field is empty if the disk media record is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed </b></font>or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> state, or if the disk does not have a private region (for example, on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font>-type disks). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447472"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>priv_cpath</b></font></font>
</p>
<p>
<a name="454876"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The path to the character (raw) device containing the private region for the disk.  This field is empty if the disk media record is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> state, or if the disk does not have a private region (for example, on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font>-type disks). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447527"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>priv_offset</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>priv_len</b></font></font>
</p>
<p>
<a name="454911"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Length number fields. These define the offset and length of the private region of the disk within the device containing the private region. These fields are not defined (print as empty strings) if the disk media record is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec </b></font>state, or if the disk does not have a private region (for example, on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font>-type disks). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447643"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>private</b></font></font>
</p>
<p>
<a name="454950"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean.  This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if the disk underlying the disk media record has a private region (for example, if the disk is not a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font>-type disk).  This if <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font> if the disk media record is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> state. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447698"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pub_bdev</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pub_dev</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bdev</b></font>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dev</b></font>) </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447705"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>priv_bdev</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>priv_dev</b></font>) </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447711"></a>The block device numbers of the device containing the public and private regions of the disk, respectively. These fields are both <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VOLNODEV</b></font> if the disk media record is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> state.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>priv_bdev</b></font> field is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VOLNODEV</b></font> if the disk does not have a private region (for example, on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font>-type disks). </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447802"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pub_bpath</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bpath</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>path</b></font>)</font>
</p>
<p>
<a name="455033"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The path to the block device containing the public region for the disk. The public region is the region of the disk from which subdisks are allocated. This field is empty if the disk media record is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> state. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447884"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pub_cpath</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cpath</b></font>)</font>
</p>
<p>
<a name="455064"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The path to the character (raw) device containing the public region for the disk.  This field is empty if the disk media record is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec</b></font> state. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447927"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pub_offset</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pub_len</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>len</b></font>)</font>
</p>
<p>
<a name="455099"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Length number fields. These define the offset and length of the public region of the disk within the device containing the public region. These fields are not defined (print as empty strings) if the disk media record is in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodarec </b></font>state. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448018"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil2</b></font></font>
</p>
<p>
<a name="455126"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Comment-type fields of up to fourteen characters. These are the permanent utility fields. The first field is reserved for internal VERITAS Volume Manager purposes. The second field is reserved for utilities, such as VERITAS Enterprise Administrator (VEA), that use the usage-type utilities and that need to store their own state into records.  The third field is reserved for local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448121"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>removed</b></font></font>
</p>
<p>
<a name="455157"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean.  This is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if the disk is detached from its backing store using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg -k rmdisk</b></font> operation.  Detaching the disk also clears the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>diskid</b></font> field. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448164"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reserved</b></font></font>
</p>
<p>
<a name="455188"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean.  This can be set or cleared (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>(1M)) to reserve or unreserve the disk.  Reserving a disk prevents <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> from allocating subdisks from the disk, unless the disk is specified explicitly on the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> command line. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448219"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rid</b></font></font>
</p>
<p>
<a name="455207"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID for the disk media record. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448238"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_num</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nsd</b></font>)</font>
</p>
<p>
<a name="455230"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A simple number field.  This is the number of subdisks that are defined on the disk media record. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448269"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil2</b></font></font>
</p>
<p>
<a name="455257"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Comment-type fields of up to fourteen characters. These are the temporary utility fields. The first field is reserved for internal VERITAS Volume Manager purposes.  The second field is reserved for utilities, such as VERITAS Enterprise Administrator (VEA), that use the usage-type utilities and that need to store their own state into records.  The third field is reserved for local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448372"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>update_tid</b></font></font>
</p>
<p>
<a name="455276"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The configuration update sequence number for the last transaction to update this record. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448403"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volatile</b></font></font>
</p>
<p>
<a name="455315"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean.  This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> if the disk access record underlying the disk media record was created with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volatile</b></font> flag set.  See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>voldisk</b></font>(1M) for information on how to create a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font>-type disk with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volatile</b></font> flag set. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="448457"></a> DISK GROUP RECORD FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448462"></a>The following fields are defined for disk group records. Note that disk group records cannot be created using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448481"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment</b></font></font>
</p>
<p>
<a name="455338"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A comment-type field of up to 40 characters.  This is reserved for use by local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448512"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dgid</b></font></font>
</p>
<p>
<a name="455357"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The disk group ID of the disk group.  This is a 64-byte string that is assigned to the disk group when it is created.  The form of the string is chosen to substantially eliminate the chance that any two disk groups ever created will have the same disk group ID. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448567"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>import_id</b></font></font>
</p>
<p>
<a name="455376"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A sequence number associated with the current import of the disk group. Each time a disk group is imported, it is assigned a sequence number from an increasing sequence. This number can be saved and then used to find out whether a disk group has been deported and then re-imported again. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448634"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil2</b></font></font>
</p>
<p>
<a name="455403"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Comment-type fields of up to fourteen characters. These are the permanent utility fields. The first field is reserved for internal VERITAS Volume Manager purposes.  The second field is reserved for utilities, such as VERITAS Enterprise Administrator (VEA), that use the usage-type utilities and that need to store their own state into records. The third field is reserved for local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448737"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>real_name</b></font></font>
</p>
<p>
<a name="455422"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is the name of the disk group as it is defined within the disk group. VxVM supports an aliasing feature, where a disk group is imported using a disk group name that differs from the name as it appears in the disk group configuration. Normally, these are the same. </font>
</p>
<p>
<a name="426350"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>real_name</b></font> will always match the import name of the disk group. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448835"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rid</b></font></font>
</p>
<p>
<a name="455448"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID for the disk group record. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448854"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil2</b></font></font>
</p>
<p>
<a name="455475"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Comment-type fields of up to fourteen characters.  These are the temporary utility fields.  The first field is reserved for internal VERITAS Volume Manager purposes.  The second field is reserved for utilities, such as VERITAS Enterprise Administrator (VEA), that use the usage-type utilities and that need to store their own state into records. The third field is reserved for local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448945"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>update_tid</b></font></font>
</p>
<p>
<a name="455494"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The configuration update sequence number for the last transaction to update this record. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="448975"></a> RVG RECORD FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448980"></a>The following fields are defined for Replicated Volume Group (RVG) records that are used with VERITAS Volume Replicator (VVR). </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449011"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment</b></font></font>
</p>
<p>
<a name="455513"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A comment-type field of up to 40 characters.  This is reserved for use by local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449042"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>datavol</b></font></font>
</p>
<p>
<a name="455532"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a comma-separated list of data volumes that are associated with the RVG. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449073"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>group</b></font></font>
</p>
<p>
<a name="455551"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is either a group name or a decimal group ID.  The value specifies the user that owns the volume block and character devices. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449104"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mode</b></font></font>
</p>
<p>
<a name="455574"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a symbolic or numeric file permission mode.  This can be any string that is acceptable to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>chmod</b></font>(1) for setting the mode of a file. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449147"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>primary</b></font></font>
</p>
<p>
<a name="455601"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean field. If set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>, this is considered to be the primary RVG, and writes to this RVG are replicated to any attached RLINK. If set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font> (default), this is a secondary RVG which receives writes from the primary RVG. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449214"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil2</b></font></font>
</p>
<p>
<a name="455628"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Comment-type fields of up to fourteen characters. These are the permanent utility fields. The first field is reserved for internal VVR purposes.  The second field is reserved for utilities, such as VERITAS Enterprise Administrator (VEA), that use the usage-type utilities and that need to store their own state into records. The third field is reserved for local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449317"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rlink</b></font></font>
</p>
<p>
<a name="455647"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a comma-separated list of RLINKs that are associated with the RVG. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449336"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>srl</b></font></font>
</p>
<p>
<a name="455666"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is the name of the Storage Replicator Log (SRL) volume for the RVG. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449355"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil2</b></font></font>
</p>
<p>
<a name="455693"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Comment-type fields of up to fourteen characters.  These are the temporary utility fields.  The first field is reserved for internal VVR purposes.  The second field is reserved for utilities, such as VERITAS Enterprise Administrator (VEA), that use the usage-type utilities and that need to store their own state into records. The third field is reserved for local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449446"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>user</b></font></font>
</p>
<p>
<a name="455712"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is either a user name or a decimal user ID.  The value specifies the user that owns the volume block and character devices. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="449476"></a> RLINK RECORD FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449481"></a>The following fields are defined for RLINK records that are used with VERITAS Volume Replicator (VVR). </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449500"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bandwidth_limit</b></font></font>
</p>
<p>
<a name="455739"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The maximum network bandwidth that can be used to replicate data over an RLINK. This field is enabled by setting it to a value in units of bits per second, and disabled by setting to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>none</b></font> (the default value). The minimum allowed value is 56kbps (56 kilobits per second). Refer to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>(1M) manual page for more information. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449579"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment</b></font></font>
</p>
<p>
<a name="455758"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A comment-type field of up to 40 characters.  This is reserved for use by local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449610"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>latency_high_mark</b></font></font>
</p>
<p>
<a name="455777"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the maximum number of outstanding requests when latency protection is enabled. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449641"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>latency_low_mark</b></font></font>
</p>
<p>
<a name="455796"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If throttling has been enabled, specifies the level to which the number of outstanding requests must drop before throttling is disabled. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449672"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>latencyprot</b></font></font>
</p>
<p>
<a name="455831"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates whether latency protection is enabled for the RLINK. The attribute may have one of the values: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fail</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>override</b></font>. Refer to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>(1M) manual page for more information. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449727"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>local_host</b></font></font>
</p>
<p>
<a name="455850"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the local host. This only needs to be set if a private network is used. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449758"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>packet_size</b></font></font>
</p>
<p>
<a name="455869"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates the maximum number of bytes in a UDP packet that can be sent from the primary to secondary. It defaults to some reasonable non-zero value, but can be tuned to the local environment for improved performance. This field can only be set when the RLINK is using UDP as its transport protocol. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449837"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>protocol</b></font></font>
</p>
<p>
<a name="455896"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is the transport protocol that the RLINK uses for replication; either <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>UDP</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>TCP</b></font>. If no value is specified, the RLINK uses the default protocol, UDP. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449880"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil2</b></font></font>
</p>
<p>
<a name="455923"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Comment-type fields of up to fourteen characters. These are the permanent utility fields. The first field is reserved for internal VVR purposes.  The second field is reserved for utilities, such as VERITAS Enterprise Administrator (VEA), that use the usage-type utilities and that need to store their own state into records. The third field is reserved for local installations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449983"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>remote_dg</b></font></font>
</p>
<p>
<a name="455942"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the remote disk group. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450002"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>remote_host</b></font></font>
</p>
<p>
<a name="455961"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name or IP address of the remote host. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450021"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>remote_rlink</b></font></font>
</p>
<p>
<a name="455980"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the remote RLINK. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450040"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>srlprot</b></font></font>
</p>
<p>
<a name="456023"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates whether log protection is enabled for the RLINK. Log protection prevents an RLINK from overflowing the SRL, which would cause it to become stale. This field may have one of the values: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>autodcm</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dcm</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fail</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>override</b></font>. Refer to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>(1M) manual page for more information. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450119"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>synchronous</b></font></font>
</p>
<p>
<a name="456058"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates whether replication should operate in synchronous or asynchronous mode. This field may have one of following values: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>override</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fail</b></font>. Refer to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>(1M) manual page for more information. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450186"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>timeout</b></font></font>
</p>
<p>
<a name="456077"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The connection timeout value is the number of milliseconds to wait before connections to remote nodes should time out. It defaults to some reasonable non-zero value, but can be tuned to the local environment for improved performance. The minimum allowed timeout is 1 millisecond. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450265"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil0</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil2</b></font></font>
</p>
<p>
<a name="456104"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Comment-type fields of up to fourteen characters.  These are the temporary utility fields.  The first field is reserved for internal VVR purposes.  The second field is reserved for utilities, such as VERITAS Enterprise Administrator (VEA), that use the usage-type utilities and that need to store their own state into records. The third field is reserved for local installations. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="450355"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450360"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>awk</b></font>(1), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>chmod</b></font>(1), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>group</b></font>(4), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>passwd</b></font>(4), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sh</b></font>(1), <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), <a href="vxassist_vxvm_manpages14_458378.html#441128"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font></font></a>(1M), <a href="vxconfigbackup_vxvm_manpages23_426890.html#426512"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigbackup </b></font></font></a>(1M), <a href="vxconfigrestore_vxvm_manpages26_427919.html#427114"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigrestore </b></font></font></a>(1M), <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="vxdisk_vxvm_manpages34_439794.html#433127"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </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="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="vxsnap_vxvm_manpages72_441468.html#434380"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </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="vxmake_vxvm_manpages91_450355.html" title="vxmake">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="vol_pattern_vxvm_manpages90_440877.html" title="Previous - vol_pattern">Previous</a>&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="man4_titlepage_docCD_vxvm_manpages89_73700.vxhd" title="Devices (4) title page ">Devices (4)</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>
