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

</HEAD>

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

<a name="440877"></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="man4_titlepage_docCD_vxvm_manpages89_73700.vxhd" title="Previous - Devices (4)">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxmake_vxvm_manpages91_450355.html" title="Next - vxmake">Next</a>
&nbsp;&gt;&nbsp;&nbsp;</font>
   </td>
 </tr>

 <tr>
  <td bgcolor="#CCCCCC" colspan="2" height="15" align="right">
  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Product:  
<a href="vxvm_manpages_splashpage_docCD_vxvm_manpages1_103036.vxhd" title="Volume Manager Manual Pages for Storage Foundation title page ">Volume Manager Manual Pages for Storage Foundation</a>
  &nbsp;&nbsp;
  </font>
  </td>
 </tr>
 <tr>
  <td bgcolor="#CCCCCC" colspan="2" height="15" align="right">
  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Manual:  
<a href="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="434282"></a>vol_pattern</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="434305"></a> NAME</font>
</h3>
<p>
<a name="434310"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vol_pattern - VERITAS Volume Manager disk group search specifications </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="434313"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434318"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol_pattern</b></font> search expression language can be used in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>, and with some VERITAS Volume Manager (VxVM) support library functions, to locate VERITAS Volume Manager configuration records with particular characteristics.  Searches are limited to operation on one disk group at a time.  In the current release, search expressions are limited to volume, plex, subdisk, DCO and snap records.  Search expressions cannot be applied to disk group, disk media, or disk access records. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434384"></a>Search patterns provide an expression-based language for specifying record attributes.  In simple cases, patterns can be specified that match records whose fields have specific values.  In more complex cases, records can be matched based on attributes of associated records. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434423"></a>Search patterns are expressions that do not have side effects (that is, variables cannot be set or changed).  Expressions evaluate either to <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>.  If evaluation of an expression within the context of a configuration record yields a value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>, then the expression matches the record; otherwise, the expression does not match the record. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434471"></a>The search pattern language does not have operators that cause changes to be made, and does not have a concept of local variables that can be set and used within or between expressions. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="434492"></a> TYPES OF EXPRESSIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434497"></a>Expressions in the pattern language are similar to expressions in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>awk</b></font>(1).  Expressions can have the following types for constants, variables, and subexpressions: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434519"></a>boolean</font>
</p>
<p>
<a name="441131"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean variable or expression is either <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>. Numbers and strings can be used as truth values if the context requires a boolean value.  For a number, zero implies <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font> and non-zero implies <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>.  For a string, an empty string implies <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font> and a nonempty string implies <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434568"></a>GUID</font>
</p>
<p>
<a name="441174"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A Global Unique ID that is assigned to volumes and plexes. These GUIDs can be compared for equality. They are used to store the associations between VxVM objects across disk group split and join operations. A GUID is specified in an expression using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint</b></font> format {<em>xxxxxxxx</em>-<em>xxxx</em>-<em>xxxx</em>-<em>xxxx</em>-<em>xxxxxxxxxxxx</em>} where each <em>x</em> represents a hexadecimal digit (for example, {736a3c4e-1dd2-11b2-87c3-080020e706ae}). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434654"></a>number</font>
</p>
<p>
<a name="441189"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number is an integer quantity.  The maximum size for a number is the largest size that may be used for values in configuration records.  In the reference porting base for VxVM, these numbers are 32-bit signed numbers. </font>
</p>
<p>
<a name="425046"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Numbers can be specified in decimal, octal, or hexadecimal with a suffix to indicate the unit of the number when it indicates an object length or offset.  Hexadecimal numbers begin with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>0x</b></font>, octal numbers begin with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>0</b></font>; otherwise numbers are in decimal.  When used as a length, numbers with no suffix are taken as sectors. </font>
</p>
<p>
<a name="425052"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Defined suffix characters 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 sectors (typically 512 bytes), <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 characters also can be specified in upper case. </font>
</p>
<p>
<a name="425057"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Length numbers are actually defined in terms of sectors.  As a result, on a system with 512-byte sectors, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>1k</b></font> is the same as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>2</b></font>. Thus, the expression: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="434837"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">nassoc=1k</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425069"></a>tests for a record with 2 associated records, rather than 1024 associated records. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434873"></a>numeration</font>
</p>
<p>
<a name="441271"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An enumeration field is a number that represents one of the values for a field that has symbolic names.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol_pattern</b></font> expression grammar handles enumeration values exactly like numbers.  Enumerations are usually only useful for comparing compatible enumeration field and enumeration constants.  For example, the enumeration field <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_layout</b></font> is a number whose possible values are represented by the symbols <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>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434940"></a>regular expression</font>
</p>
<p>
<a name="441302"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A regular expression is a value, much like a regular expression in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>awk</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ed</b></font>, that can be used to specify a pattern for matching strings.  Regular expressions can only be used in the context of the boolean <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>~ </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!~ </b></font>operators. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435016"></a>sequence numbers and record IDs</font>
</p>
<p>
<a name="441317"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each time a transaction is issued against a disk group configuration, a 64-bit configuration sequence number is increased.  When a configuration records is created or changed in a transaction, the record is stamped with the configuration sequence number associated with that transaction. </font>
</p>
<p>
<a name="425098"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When a record is created, it is given a 64-bit record ID.  These record IDs are never reused within a disk group configuration. </font>
</p>
<p>
<a name="425101"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Configuration sequence numbers and record IDs can be specified as constants of the form <em>number</em>, where both numbers are specified in decimal. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435124"></a>string</font>
</p>
<p>
<a name="441342"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string is a literal string in quotes or a character array field from a configuration record.  Strings can be implicitly promoted to boolean, but are never promoted to other types.  For example, a string-valued field in a record that contains only digits cannot be compared with a number.  String literals are described later. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435172"></a>Two higher-level types are also included, which can represent multiple values of the same base type.  These higher-level types are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435185"></a>list</font>
</p>
<p>
<a name="441361"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A list is a set of expressions and sets within parenthesis that are separated by commas.  List expressions can only be used for the right-hand expression of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> operator. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435216"></a>set</font>
</p>
<p>
<a name="441384"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A set is a multi-valued variable (an array).  Sets are normally used within the right-hand expression for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>any</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in </b></font>operators.  Reference to a set expression yields all of the currently valid members of the set, of which there may be none. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="435255"></a> EXPRESSION GRAMMAR</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435260"></a>A pattern is an expression with the following components and operators, in increasing order of precedence.  Groups of operators described together have the same precedence. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435282"></a><em>expr1</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>?</b></font> <em>expr2</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>:</b></font> <em>expr3</em></font>
</p>
<p>
<a name="441435"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is a conditional expression.  Expression <em>expr1</em> is evaluated as a boolean value.  If it has a truth value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>, then the value for the conditional expression is the value of <em>expr2</em>, otherwise the value for the conditional expression is the value of <em>expr3</em>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435331"></a><em>expr1</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>||</b></font> <em>expr2</em></font>
</p>
<p>
<a name="441494"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The logical <em>or</em> operator.  <em>expr1</em> and <em>expr2</em> are evaluated as boolean expressions.  If either <em>expr1</em> or <em>expr2</em> have a truth value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>, the expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value of the expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435371"></a><em>expr1</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>&amp;&amp;</b></font> <em>expr2</em></font>
</p>
<p>
<a name="441553"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The logical <em>and</em> operator.  <em>expr1</em> and <em>expr2</em> are evaluated as boolean expressions.  If both <em>expr1</em> and <em>expr2 </em>have a truth value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>, the expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value of the expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435411"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>any</b></font> <em>expr</em></font>
</p>
<p>
<a name="441604"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The expression <em>expr</em> is evaluated as a boolean expression for all combinations of elements for all sets within <em>expr</em> that represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>.  If any of these combinations yields a truth value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>any</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>. </font>
</p>
<p>
<a name="425156"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_sd</b></font> is a set defining the names of subdisk records that are associated with a plex.  The expression: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="435499"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">any&nbsp;pl_sd.sd_disk=&quot;disk01&quot;</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425167"></a>searches for plex records that have an associated subdisk on disk <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk01</b></font>.  Each name in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_sd_name</b></font> set is referenced as a subdisk and checked to see if that subdisk is on disk <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk01</b></font>.  The expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font> if it is true for any subdisk. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435562"></a><em>expr</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> <em>list</em></font>
</p>
<p>
<a name="441700"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<a name="425183"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Type promotions are not performed on the expressions in <em>list</em>, or on <em>expr</em>.  Types for all these expressions must match exactly. </font>
</p>
<p>
<a name="425186"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For example, the expression: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="435693"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&quot;disk01&quot;&nbsp;in&nbsp;(pl_sd.sd_disk,pl_log_sd.sd_disk)</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425196"></a>searches for plexes that have either a regular subdisk or a subdisk on disk <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk01</b></font>. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435729"></a><em>expr</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>~/</b></font><em>regexp</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/</b></font></font>
</p>
<p>
<a name="441753"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435733"></a><em>expr</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!~/</b></font><em>regexp</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/</b></font></font>
</p>
<p>
<a name="441782"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435736"></a>The binary <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>~ </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!~ </b></font>operators are used to match string values against a regular expression.  The value of <em>expr</em> must be a string.  For the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>~ </b></font>operator, if the value of <em>expr</em> matches the regular expression <em>regexp</em>, then the value for the match expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  For the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!~ </b></font>operator, if <em>expr</em> matches <em>regexp</em> the result is false; otherwise the result is true. </font>
</p>

<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425218"></a>Regular expressions are in the format described in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>regcmp</b></font>(3G). The slash (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/</b></font>) character in the regular expression must be escaped with a backslash (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>\e</b></font>) if it does not occur within a character range. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435908"></a><em>expr1</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>=</b></font> <em>expr2</em></font>
</p>
<p>
<a name="441863"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435912"></a><em>expr1</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!=</b></font> <em>expr2</em></font>
</p>
<p>
<a name="441888"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435915"></a>These expressions compare string, number, sequence number, record ID, GUID or boolean values.  If either <em>expr1</em> or <em>expr2</em> is a boolean value, then the other is promoted to a boolean as well.  For the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>=</b></font> operator, if the two values are equal then the result is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the result is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  For the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!= </b></font>operator, if the two values are equal, then the result is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>; otherwise, the result is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>. </font>
</p>

<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425238"></a>For consistency with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>awk</b></font>(1) and many other languages, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>== </b></font>is allowed as an alias for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>=</b></font> operator. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435998"></a><em>expr1</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>&lt;</b></font> <em>expr2</em></font>
</p>
<p>
<a name="441957"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436002"></a><em>expr1</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>&gt;</b></font> <em>expr2</em></font>
</p>
<p>
<a name="441982"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436006"></a><em>expr1</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>&lt;=</b></font> <em>expr2</em></font>
</p>
<p>
<a name="442007"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436010"></a><em>expr1</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>&gt;=</b></font> <em>expr2</em></font>
</p>
<p>
<a name="442032"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436013"></a>These expressions compare the magnitudes of numbers or sequence numbers.  They cannot be applied to any other types of expressions. The result is a boolean. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436035"></a><em>expr1</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>+</b></font> <em>expr2</em></font>
</p>
<p>
<a name="442057"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436039"></a><em>expr1</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-</b></font> <em>expr2</em></font>
</p>
<p>
<a name="442082"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436042"></a>These expressions add or subtract two numbers, yielding another number. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436055"></a><em>expr1</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>*</b></font> <em>expr2</em></font>
</p>
<p>
<a name="442107"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436059"></a><em>expr1</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/</b></font> <em>expr2</em></font>
</p>
<p>
<a name="442132"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436063"></a><em>expr1</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%</b></font> <em>expr2</em></font>
</p>
<p>
<a name="442157"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436066"></a>These expressions multiply, divide, or take the modulo of two numbers, yielding another number. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436079"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>+</b></font> <em>expr</em></font>
</p>
<p>
<a name="442178"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436083"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-</b></font> <em>expr</em></font>
</p>
<p>
<a name="442199"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Expression <em>expr</em> is evaluated, and the resulting value is compared to all of the values in <em>list</em>.  If any of the values in <em>list</em> match <em>expr</em>, then the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>; otherwise, the value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The <em>list</em> can either be a list of expressions within parentheses that are separated by commas, or it can be a single expression.  If any of the expressions in <em>list</em> represent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sets</b></font>, then the comparison is made against all combinations of values in that set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436086"></a>The unary <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>+</b></font> operator applied to any expression yields the value of that expression.  The unary <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-</b></font> operator negates the value of a number-valued expression <em>expr</em>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436108"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font> <em>expr</em></font>
</p>
<p>
<a name="442258"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><em>expr</em> is evaluated as a boolean expression.  If its value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>, then the value for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>; otherwise, the value for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font> expression is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436139"></a><em>expr</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>.</b></font> <em>field-name</em></font>
</p>
<p>
<a name="442297"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><em>expr</em> is evaluated as a string expression.  Its value is used as the name of a record in the disk group configuration.  If the record exists, and if that record contains a field named <em>field-name</em>, then the value of this expression is the value in that field within the referenced record.  If the record does not exist, or if the record does not contain a field named <em>field-name</em>, then the behavior is context-dependent. </font>
</p>
<p>
<a name="425295"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If this occurs within the context of an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>any</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in </b></font>operator, then the next combination of values for the right-hand side of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>any</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> operator is evaluated.  If this occurs within the context of an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>&amp;&amp;</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>||</b></font> operator, then the left or right-hand expression of that operator yields <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>, whichever side the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>.</b></font> operator occurs on.  The innermost <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>any</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>&amp;&amp;</b></font>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>||</b></font> operator determines the context.  If no such context exists, then the result of the entire search pattern is that the record being tested does not match the pattern. </font>
</p>
<p>
<a name="425306"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The effect of this short-circuiting behavior is that an expression that does not make sense, either because a record does not exist or because it does not contain a specific field, causes that expression to be <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The effect is similar to implicit asserts, which are described later in this section under <em>field name</em>. </font>
</p>
<p>
<a name="425312"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For compatibility with earlier releases of VxVM, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-&gt;</b></font> can be used instead of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>.</b></font> as the operator. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436380"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>(</b></font> <em>expr</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>)</b></font></font>
</p>
<p>
<a name="442397"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Parentheses can be used to override precedence rules. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436393"></a><em>literal</em></font>
</p>
<p>
<a name="442420"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string, number, sequence number, or record ID literal, as defined in the section <font face="Courier New, Courier, sansserif, sans serif" size="2">Types&nbsp;of&nbsp;Expressions</font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436415"></a><em>assert</em></font>
</p>
<p>
<a name="442483"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An assert is a special type of variable name that is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font> within the context of a specific type of record.  Outside of that context, an assert causes the expression that it is in to be <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  The scope of an assert is the right or left-hand side of the smallest expression within a <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>&amp;&amp;</b></font> operator.  If an assert does not occur within a <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>&amp;&amp;</b></font> operator, then the search pattern does not match the record being evaluated.  The names that specify asserts are <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>dco</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snap</b></font>, which specify volume, plex, subdisk, data change object (DCO) and snap records, respectively. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436518"></a><em>constant</em></font>
</p>
<p>
<a name="442514"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">There is a set of symbolic constants that can be specified in search patterns.  For example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font> are the two truth values.  Also, if a field within a record has a specific set of symbolic values, then these symbolic values are available as numeric constants.  See the section <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Constants</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436567"></a><em>variable</em></font>
</p>
<p>
<a name="442537"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">There is a small set of global variables that can be referenced in search patterns.  Such variables can be used within any context.  See the section <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Global Variables</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436598"></a><em>field name</em></font>
</p>
<p>
<a name="442556"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Referencing the name of a field in a configuration record yields the value of that field within the configuration record being evaluated. </font>
</p>
<p>
<a name="425351"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Not all field names are defined for all record types.  If a field name is referenced that is not valid in the context of the record type, then the smallest expression on either side of a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>&amp;&amp;</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>|| </b></font>operator becomes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>.  This is an implicit assert.  For example, the expression: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="436686"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">v_kstate!=V_ENABLED</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425365"></a>matches only volume records because the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_kstate</b></font> field is only defined for volume records. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425368"></a>Some fields in a record only make sense if another field contains a specific value.  For example, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_st_width</b></font> field in plex records is not defined unless the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_layout</b></font> field is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PL_STRIPE</b></font>.  These cases are treated as implicit asserts. </font>
</blockquote>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="436764"></a> CONSTANTS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436769"></a>The names of constants that are recognized within search patterns are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436773"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>yes</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font></font>
</p>
<p>
<a name="442624"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Constants representing boolean <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436786"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>no</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font></font>
</p>
<p>
<a name="442655"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Constants representing boolean <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436799"></a><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></font>
</p>
<p>
<a name="442702"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The enumeration constants that represent values for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_read_pol</b></font> field in volume records.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_current_read_pol</b></font> field can be set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ROUND</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PREFER</b></font>. These constants can also be specified with a prefix of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>V_</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436859"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DISABLED</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DETACHED</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENABLED</b></font></font>
</p>
<p>
<a name="442741"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The enumeration constants that represent values for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_kstate </b></font>field in volume and plex records.  These constants can also be specified with a prefix of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>V_</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PL_</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436890"></a><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>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436894"></a><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>
</p>
<p>
<a name="442782"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The enumeration constants that represent values for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_kstate </b></font>field in volume and plex records.  These constants can also be specified with a prefix of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>V_</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PL_</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436898"></a><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>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GEN_DET2</b></font></font>
</p>
<p>
<a name="442807"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The enumeration constants that represent values for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_kstate </b></font>field in volume and plex records.  These constants can also be specified with a prefix of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>V_</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PL_</b></font>. </font>
</p>
<p>
<a name="425402"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The enumeration constants that represent values for the </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436917"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_r_all</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_r_some</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_w_all</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_w_some </b></font>fields in volume records.  These constants can also be specified with a prefix of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>V_</b></font>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436975"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>LOGUNDEF</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>LOGNONE</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>LOGBLKNO</b></font></font>
</p>
<p>
<a name="442865"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The enumeration constants that represent values for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_log_type</b></font> field in volume records. These enumeration constants can also be specified with a prefix of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>V_PFLAG_</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437017"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>STRIPE</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>CONCAT</b></font></font>
</p>
<p>
<a name="442896"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The enumeration constants that represent values for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_layout</b></font> field in plex records.  These constants can also be specified with a prefix of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PL_</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437048"></a><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>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RW</b></font></font>
</p>
<p>
<a name="442931"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The enumeration constants that represent values for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_iomode</b></font> field in plex records. These enumeration constants can also be specified with a prefix of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PL_TFLAG_</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437088"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VOLNODEV</b></font></font>
</p>
<p>
<a name="442950"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The value for a device number field indicating that the device number is undefined. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="437109"></a> GLOBAL VARIABLES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437114"></a>The global variables that can be used within search patterns are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437118"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>config_tid</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tid</b></font></font>
</p>
<p>
<a name="442973"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The configuration sequence number of the disk group configuration. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437131"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>util_num</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nutil</b></font></font>
</p>
<p>
<a name="443004"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The number of fields in a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil</b></font> arrays in a volume, plex, or subdisk structure.  This is always 3, but it is treated as a global variable anyway. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="437161"></a> GENERIC FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437166"></a>Some fields can be found in all types of configuration records (with exceptions for DCO and snap records).  These fields can be referenced without a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_</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>dco_</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sp_ </b></font>suffix, and do not generate implicit asserts.  These fields can be used either to name fields in the record being evaluated, or as a field name reference for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>.</b></font> operator. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437223"></a>A generic field name can be specified with a prefix of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_</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>dco_</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sp_ </b></font>to indicate that implicit asserts should be used and that the field requires a context of a volume, plex, subdisk, DCO or snap record, respectively. Currently, use of a prefix for a generic field name is ignored for the right-hand side of a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>. </b></font>operator. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437289"></a>The recognized generic field names are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437293"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c</b></font></font>
</p>
<p>
<a name="443075"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string containing the comment field. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437306"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>len</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>l</b></font></font>
</p>
<p>
<a name="443098"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing the length of the volume, plex or subdisk. (Not applicable for DCO or snap records.) </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437328"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>lock</b></font></font>
</p>
<p>
<a name="443125"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether the record is locked in the current transaction of the caller.  This variable is not useful when used with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>.  It is only useful for C programs. (Not applicable for DCO or snap records.) </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437368"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>name</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>n</b></font></font>
</p>
<p>
<a name="443148"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string containing the record name. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437381"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>open</b></font></font>
</p>
<p>
<a name="443167"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether the volume, plex, or subdisk is open.  A subdisk is considered open of the volume or plex device for the subdisk is open.  A plex is considered open only if the plex device is open.  A volume is considered open if the volume or one of its plex devices is open. (Not applicable for DCO or snap records.) </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437439"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil</b></font></font>
</p>
<p>
<a name="443186"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A set of strings representing all of the permanent utility fields. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437452"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil0</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>p0</b></font></font>
</p>
<p>
<a name="443209"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string containing the first permanent utility field. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437465"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil1</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>p1</b></font></font>
</p>
<p>
<a name="443232"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string containing the second permanent utility field. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437478"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil2</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>p2</b></font></font>
</p>
<p>
<a name="443255"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string containing the third permanent utility field. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437491"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rid</b></font></font>
</p>
<p>
<a name="443274"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the record being evaluated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437504"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil</b></font></font>
</p>
<p>
<a name="443293"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A set of strings representing all of the temporary utility fields. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437517"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil0</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t0</b></font></font>
</p>
<p>
<a name="443316"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string representing the first temporary utility field. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437530"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil1</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t1</b></font></font>
</p>
<p>
<a name="443339"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string representing the second temporary utility field. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437543"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil2</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t2</b></font></font>
</p>
<p>
<a name="443362"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string representing the third temporary utility field. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437556"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>update_tid</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>update</b></font></font>
</p>
<p>
<a name="443385"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The disk group configuration sequence number corresponding to the transaction that created or that last modified the record. </font>
</p>
<p>
<a name="425519"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Other special fields exist that do not obey the prefix convention, but which apply to more than one type of record.  These are: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437603"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>aslist</b></font></font>
</p>
<p>
<a name="443411"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The set of associated record names.  In the context of a volume or plex record, this yields the names of the associated plexes and subdisks, of which there may be none. In case of a DCO record, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>aslist</b></font> yields the names of the associated snap records. This is not appropriate in the context of a subdisk or snap record. This causes an implicit assert when applied to a subdisk or snap record. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437688"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>assoc</b></font></font>
</p>
<p>
<a name="443446"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of a field with which a record is associated. In the context of a plex or subdisk record, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>assoc</b></font> yields the name of the volume or plex with which the record is associated. In the context of a snap record, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>assoc</b></font> yields the name of the DCO with which the snap record is associated. If the record is not associated, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>assoc</b></font> yields an empty string.  Use of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>assoc</b></font> is not appropriate in the context of a volume record. This causes an implicit assert when applied to a volume or DCO. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437774"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>naslist</b></font></font>
</p>
<p>
<a name="443469"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The number of records in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>aslist</b></font> set.  This causes an implicit assert when applied to a subdisk or snap record. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="437795"></a> VOLUME RECORD FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437800"></a>The fields that can be specified for volume records are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437804"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>badlog</b></font></font>
</p>
<p>
<a name="443488"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating that all block-change log copies for the value were detached due to I/O failures. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437826"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>detach_tid</b></font></font>
</p>
<p>
<a name="443507"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The sequence number of the last transaction that detached the volume due to a failure of some kind.  This is also set when all copies of the block-change log for the volume are detached by I/O failures. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437857"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>forceminor</b></font></font>
</p>
<p>
<a name="443534"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether the volume can use one of the reserved minor numbers (minor numbers zero through four).  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>root</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>swap</b></font> usage types set this flag to allow them to grab minor numbers 0 and 1 for the root and swap volumes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437897"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pref_plex_rid</b></font></font>
</p>
<p>
<a name="443553"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the preferred plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437910"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_active</b></font></font>
</p>
<p>
<a name="443576"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether the volume was in use at the time of a system failure.  This is not set if the volume was not written prior to the crash.  This flag indicates that plex synchronization recovery is required for the volume.  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_active </b></font>is normally cleared during system startup when the volume is started. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437959"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_bdev</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_cdev</b></font></font>
</p>
<p>
<a name="443599"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The block and character device numbers for the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437972"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_current_read_pol</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_creadpol</b></font></font>
</p>
<p>
<a name="443638"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An enumeration representing the current read policy that is in effect for the volume.  This is the same as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_read_pol</b></font> unless <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_read_pol</b></font> is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SELECT</b></font>, in which case <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_current_read_pol</b></font> matches the chosen policy. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438012"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_data_lock</b></font></font>
</p>
<p>
<a name="443657"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether the volume is locked against I/O activity within the current transaction of the caller. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438034"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_dco_name</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_dconame</b></font></font>
</p>
<p>
<a name="443680"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the DCO which is associated with the volume. If there is no associated DCO, this is an empty string. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438056"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_dco_parent_name</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_dco_parentname</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_dcoparentname</b></font></font>
</p>
<p>
<a name="443707"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the DCO with which this volume is associated as a DCO volume. If the volume is not a DCO volume, this is an empty string. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438078"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_dco_rid</b></font></font>
</p>
<p>
<a name="443726"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the DCO which is associated with the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438091"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_fastresync</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_fmr</b></font></font>
</p>
<p>
<a name="443749"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether FastResync is enabled for a volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438104"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_fstype</b></font></font>
</p>
<p>
<a name="443768"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string containing the file system type for the volume, as set by the administrator. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438126"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_gid</b></font></font>
</p>
<p>
<a name="443787"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing the group ID for the volume.  There is currently no way to represent a group name in a search pattern. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438148"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_guid</b></font></font>
</p>
<p>
<a name="443806"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The Global Unique ID (GUID) of the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438161"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_hasdcolog</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_hasdcomap</b></font></font>
</p>
<p>
<a name="443833"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether the volume has a DCO volume. The setting of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_instant</b></font> can be used to determine whether the DCO supports instant snapshot operations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438192"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_instant</b></font></font>
</p>
<p>
<a name="443852"></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. (Only the new-style DCO layout supports instant snapshot operations. The old-style DCO layout does not.) </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438232"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_iosize</b></font></font>
</p>
<p>
<a name="443871"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number indicating the largest sector size, in bytes, of any disk associated with the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438254"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_isdcolog</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_isdcomap</b></font></font>
</p>
<p>
<a name="443894"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether the volume is a DCO volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438276"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_krwback</b></font></font>
</p>
<p>
<a name="443917"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether the read-writeback recovery mode is still enabled in the kernel.  This flag is turned on when <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_rwback</b></font> is turned on, but is cleared by the kernel when recovery for the volume is complete. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438316"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_kstate</b></font></font>
</p>
<p>
<a name="443948"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An enumeration field for the kernel-enabled state for the volume.  This can have one of the values <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DETACHED</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DISABLED</b></font>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENABLED</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438374"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_lasterr</b></font></font>
</p>
<p>
<a name="443967"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing a sequence number for the last error that occurred on the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438396"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_log_len</b></font></font>
</p>
<p>
<a name="443986"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing the length of logs associated with the volume, if any. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438418"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_log_serial_hi</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_log_serial_lo</b></font></font>
</p>
<p>
<a name="444009"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Two numbers that together represent the most significant and least significant long values for the current log serial number for a volume.  The log serial number, represented as a combined binary integer, is incremented every time a new log is written for a volume that has logging enabled. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438467"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_log_type</b></font></font>
</p>
<p>
<a name="444040"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An enumeration representing the logging type for the volume. This can take one of the values <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>LOGUNDEF</b></font> (no specific type specified), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>LOGNONE</b></font> (no logging), or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>LOGBLKNO</b></font> (block-change logging). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438525"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_logging</b></font></font>
</p>
<p>
<a name="444059"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value that is true if logging is enabled for the volume. Logging is enabled if the volume is enabled, and it has at least one associated, enabled plex with an enabled, associated log subdisk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438556"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_minor</b></font></font>
</p>
<p>
<a name="444090"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing the minor number of the volume block and character devices.  This is the persistent device number for the volume.  If two volumes on the system have the same value for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_minor</b></font>, then one of the volumes is given a different device number, which is reflected in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_bdev</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_cdev</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438605"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_mode</b></font></font>
</p>
<p>
<a name="444109"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing the file permission modes for the volume.  There is currently no way to represent a symbolic mode in a search pattern. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438627"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_pl_name</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_plex</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_plexes</b></font></font>
</p>
<p>
<a name="444136"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The set of plex names that are associated with the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438640"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_pl_num</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_nplex</b></font></font>
</p>
<p>
<a name="444159"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing the number of plexes associated with the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438653"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_pref_name</b></font></font>
</p>
<p>
<a name="444186"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string containing the preferred plex for the volume.  This is only defined if the value for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_current_read_pol</b></font> is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PREFER</b></font>. Otherwise, use of this variable causes an implicit assert. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438684"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_r_all</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_r_some</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_w_all</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_w_some</b></font></font>
</p>
<p>
<a name="444217"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">These are numbers that represent the exception policies for the volume.  Each of these fields can have one of the exception policy values: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="438720"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DET_PL</b></font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="438728"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DET_VOL</b></font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="438733"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>FAIL_DET_PL</b></font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="438738"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>FAIL_DET_VOL</b></font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="438743"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>FAIL_OP</b></font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="438748"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GEN_DET</b></font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="438753"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GEN_DET_SPARSE</b></font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="438758"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GEN_DET2</b></font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="438763"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GEN_FAIL</b></font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="438768"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NO_OP</b></font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438774"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_read_pol</b></font></font>
</p>
<p>
<a name="444292"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An enumeration representing the read policy for the volume.  This can be one of the values <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>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SELECT</b></font>.  The value <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SELECT</b></font> indicates that read policy is adjusted to match the configuration of the volume: if there is one associated striped plex, this read policy is preferred; otherwise the preferred policy is round-robin. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438823"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_rec_lock</b></font></font>
</p>
<p>
<a name="444311"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether the record is locked within the current transaction of the caller. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438845"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_rwback</b></font></font>
</p>
<p>
<a name="444334"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating that read-writeback plex synchronization recovery has been started for the volume.  This is normally set when a mirrored volume is started when the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_active</b></font> flag was set. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438876"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_rwback_offset</b></font></font>
</p>
<p>
<a name="444357"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number indicating the offset within the volume to where recovery has completed.  A read operation on a volume performs a plex synchronization recovery if the read is after this point in the volume.  A read that occurs at the current read-writeback offset advances the offset to the end of the read.  When the offset reaches the end of the volume, recovery is complete and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_krwback</b></font> is turned off. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438943"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_specify_writecopy</b></font></font>
</p>
<p>
<a name="444388"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the boolean value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_specify_writecopy</b></font> is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true</b></font>, this overrides the value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_writecopy</b></font> derived from the configuration of the volume, and writecopy stabilization is enforced unconditionally. </font>
</p>
<p>
<a name="425747"></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>v_specify_writecopy</b></font> is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>false</b></font>, VxVM automatically turns on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_writecopy</b></font> if block-change logging is in operation on the volume, and turns it off otherwise. </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="425751"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The behavior of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>specify_writecopy</b></font> is likely to change in a future release. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>(1M) manual page for more information. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439042"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_start_opts</b></font></font>
</p>
<p>
<a name="444474"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string value that is used by usage types to represent options to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volume start</b></font> utility.  See the usage-type-specific options in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmend</b></font>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint</b></font>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout</b></font>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd</b></font>(1M), and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol</b></font>(1M) manual pages for more information. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439164"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_state</b></font></font>
</p>
<p>
<a name="444493"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string representing the usage-type-dependent state for the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439177"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_uid</b></font></font>
</p>
<p>
<a name="444512"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing the user ID for the volume.  There is currently no way to represent a user name in a search pattern. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439199"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_use_type</b></font></font>
</p>
<p>
<a name="444531"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string containing the usage type of the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439212"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_writeback</b></font></font>
</p>
<p>
<a name="444558"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether the writeback-on-read-error policy is turned on for the volume.  This policy is set by default and can be turned off or back on using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>.  See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>(1M) for more information. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439252"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_writecopy</b></font></font>
</p>
<p>
<a name="444581"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether volume writes are copied to a private buffer in the kernel before being written to disk.  See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>(1M) for more information. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="439282"></a> PLEX RECORD FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439287"></a>The fields that can be specified for plex records are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439291"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>detach_tid</b></font></font>
</p>
<p>
<a name="444600"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The configuration sequence number of the disk group that was in effect when the plex was last detached or disabled due to an I/O failure or a disk failure. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439322"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>log_sd</b></font></font>
</p>
<p>
<a name="444619"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string representing the name of a subdisk associated with the plex as a log subdisk.  This string is empty if no log subdisk is associated with the plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439353"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_compact</b></font></font>
</p>
<p>
<a name="444638"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value that is true if the plex is compact.  A plex is compact if its entire length is mapped by subdisks, leaving no holes. Note that the length of a plex is computed as the length to the end of the last block in the plex address space that is mapped by a subdisk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439393"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_contig_len</b></font></font>
</p>
<p>
<a name="444657"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The offset to the first unmapped block in the plex.  If the plex is compact, this matches the plex length.  If the plex is not mapped, this is the offset of the first hole in the plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439424"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_dev</b></font></font>
</p>
<p>
<a name="444680"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing the device number of the plex device (a character device).  This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VOLNODEV</b></font> if the plex is dissociated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439455"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_guid</b></font></font>
</p>
<p>
<a name="444699"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The Global Unique ID (GUID) of the plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439468"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_iomode</b></font></font>
</p>
<p>
<a name="444730"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An enumeration representing the I/O mode of the plex.  This can have one of the values <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RO</b></font> (read-only), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RW</b></font> (read-write) or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>WO</b></font> (write-only). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439490"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_kdetach</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_iofail</b></font></font>
</p>
<p>
<a name="444761"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean indicating that the plex was detached by the kernel due to an I/O failure.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stale</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>kdetach</b></font> flags are normally both cleared during a system reboot as part of starting the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439521"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_kstate</b></font></font>
</p>
<p>
<a name="444792"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An enumeration for the kernel enabled state for the plex. This can be <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DETACHED</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DISABLED</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENABLED</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439543"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_lasterr</b></font></font>
</p>
<p>
<a name="444811"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing a sequence number for the last error that occurred on the plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439565"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_layout</b></font></font>
</p>
<p>
<a name="444838"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An enumeration representing the subdisk layout policy for the plex.  This can be one of the values <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>CONCAT</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>STRIPE</b></font> to represent concatenation or striping, respectively. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439596"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_log</b></font></font>
</p>
<p>
<a name="444857"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value that is true if block-change logging is enabled for the plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439618"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_log_sd_rid</b></font></font>
</p>
<p>
<a name="444880"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the log subdisk for the plex.  This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>0.0 </b></font>if the plex has no log subdisk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439640"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_minor</b></font></font>
</p>
<p>
<a name="444899"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing the minor number of the plex device. This is -1 if the plex is dissociated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439662"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_nodarec</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_failed</b></font></font>
</p>
<p>
<a name="444922"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean indicating whether any subdisk in the plex is defined on a failed disk.  A failed disk is one where the underlying physical disk could not be found, or was detached by an I/O failure. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439693"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_noerror</b></font></font>
</p>
<p>
<a name="444941"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value that is true if the plex is accounted for in volume error handling.  If this is set, then I/O errors on the plex are ignored if they result from normal volume I/O. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439724"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_removed</b></font></font>
</p>
<p>
<a name="444964"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean indicating whether any subdisk in the plex is defined on a removed disk.  See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M) for information on removed disks. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439746"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_sd_name</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_sd</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_subdisk</b></font>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_subdisks</b></font></font>
</p>
<p>
<a name="444995"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A set containing the names of subdisks that are associated with the plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439759"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_sd_num</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_nsd</b></font></font>
</p>
<p>
<a name="445018"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing the count of subdisks that are associated with the plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439772"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_st_width</b></font></font>
</p>
<p>
<a name="445045"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing the stripe width for the plex.  This is only defined if the value for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_layout</b></font> field in the plex is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>STRIPE</b></font>.  Otherwise, use of this variable causes an implicit assert. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439812"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_stale</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_recover</b></font></font>
</p>
<p>
<a name="445068"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean indicating whether a disk replacement or a temporary failure caused the plex to become disabled and out-of-date with respect to the volume contents.  Such plexes require recovery either from other plexes in the volume or from a backup of the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439852"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_state</b></font></font>
</p>
<p>
<a name="445087"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string representing the usage-type-dependent state for the plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439865"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_v_name</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_volume</b></font></font>
</p>
<p>
<a name="445110"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the associated volume.  If the plex is not associated, this is an empty string. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439887"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_vol_rid</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_v_rid</b></font></font>
</p>
<p>
<a name="445137"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the volume with which the plex is associated.  This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>0.0</b></font> if the plex is not associated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439909"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_volatile</b></font></font>
</p>
<p>
<a name="445164"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value that is true if if one of the subdisks in the plex is defined on a volatile disk.  Volatile disks are disks whose contents are not guaranteed to be preserved across a system reboot.  Volatile disks can be created using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font> disk type (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk</b></font>(1M)). </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="439957"></a> SUBDISK RECORD FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439962"></a>The fields that can be specified for subdisk records are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439966"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_da_name</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_device</b></font></font>
</p>
<p>
<a name="445187"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The disk access record underlying the disk media record of the subdisk.  This is empty if the disk is currently failed or removed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439988"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_dev</b></font></font>
</p>
<p>
<a name="445210"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The device number of the device that the subdisk resides on.  This number is a combination of the major and minor number for the device. This is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VOLNODEV</b></font> if the underlying disk is removed or failed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440019"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_dev_offset</b></font></font>
</p>
<p>
<a name="445233"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing the offset of the subdisk from the beginning of the physical device (that is, physical block zero). This is different from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_dm_offset</b></font>, which is relative to the beginning of the public region. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440061"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_dm_name</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_disk</b></font></font>
</p>
<p>
<a name="445256"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the disk media record on which the subdisk is defined. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440074"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_dm_offset</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_offset</b></font></font>
</p>
<p>
<a name="445279"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing the offset of the subdisk within the public region of the disk that the subdisk resides on. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440096"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_dm_rid</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_disk_rid</b></font></font>
</p>
<p>
<a name="445302"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the disk media record on which the subdisk is defined. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440109"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_is_log</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_log</b></font></font>
</p>
<p>
<a name="445325"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating that this is a log subdisk for a plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440122"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_path</b></font></font>
</p>
<p>
<a name="445344"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A string containing the path to the device that the subdisk resides on. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440135"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_pl_name</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_plex</b></font></font>
</p>
<p>
<a name="445367"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the associated plex.  If the subdisk is not associated, this is an empty string. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440157"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_pl_offset</b></font></font>
</p>
<p>
<a name="445386"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing the offset of the subdisk within the address space of the plex with which it is associated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440179"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_plex_rid</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_pl_rid</b></font></font>
</p>
<p>
<a name="445409"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the plex with which the subdisk is associated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440192"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sd_volatile</b></font></font>
</p>
<p>
<a name="445436"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value that is true if the subdisk is defined on a volatile disk.  The contents of a volatile disk are not guaranteed to be preserved across a reboot.  Volatile disks can be created using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nopriv</b></font> disk type (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk</b></font>(1M)). </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="440231"></a> DCO RECORD FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440236"></a>The fields that can be specified for date change object (DCO) records are: </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>dco_badlog</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dco_badmap</b></font></font>
</p>
<p>
<a name="445459"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A boolean value indicating whether the DCO volume was detached due to write error. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440263"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dco_log_name</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dco_map_name</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dco_mapname</b></font></font>
</p>
<p>
<a name="445486"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the volume which is associated with the DCO as a DCO volume. If there is no associated DCO volume, this is an empty string. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440294"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dco_log_vol</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dco_map_vol</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dco_map_vol_rid</b></font></font>
</p>
<p>
<a name="445513"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the DCO volume which is associated with the DCO. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440307"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dco_parent_name</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dco_parentname</b></font></font>
</p>
<p>
<a name="445536"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the volume with which the DCO is associated. If the DCO is not associated, this is an empty string. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440329"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dco_parent_vol</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dco_parent_rid</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dco_parent_vol_rid</b></font></font>
</p>
<p>
<a name="445563"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the volume with which the DCO is associated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440342"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dco_sp_num</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dco_spnum</b></font></font>
</p>
<p>
<a name="445586"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A number representing the count of snap records that are associated with the DCO. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="440363"></a> SNAP RECORD FIELDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440368"></a>The fields that can be specified for snap records are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440372"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sp_dco_name</b></font></font>
</p>
<p>
<a name="445605"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the DCO with which the snap record is associated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440385"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sp_dco_rid</b></font></font>
</p>
<p>
<a name="445624"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The record ID of the DCO with which the snap record is associated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440398"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sp_snap_volguid</b></font></font>
</p>
<p>
<a name="445643"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The Global Unique ID (GUID) of the snapshot volume. The GUID is used to keep the association between the original and snapshot volumes. The snap record of the original volume contains the GUID of the snapshot volume, and the snap record of the snapshot volume contains the GUID of the original volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440457"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sp_vol_name</b></font></font>
</p>
<p>
<a name="445662"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The name of the volume with which the snap record is associated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440470"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sp_vol_guid</b></font></font>
</p>
<p>
<a name="445681"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The GUID of the volume with which the snap record is associated. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="440482"></a> EXAMPLES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440487"></a>The following example matches any plex or volume that does not have any associated subdisks or plexes.  Because <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pl_nsd</b></font> only applies to plexes, while <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_nplex</b></font> only applies to volumes, there is no ambiguity concerning which types of records can be matched by the expression. </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440541"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">pl_nsd&nbsp;=&nbsp;0&nbsp;||&nbsp;v_nplex&nbsp;=&nbsp;0</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440551"></a>The following example matches all plexes and subdisks that have a comment field beginning with the string <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Henry</b></font>.  For example, this could be a convention describing ownership. </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440587"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">(plex&nbsp;||&nbsp;sd)&nbsp;&amp;&amp;&nbsp;comment&nbsp;~&nbsp;/&#94;Henry/</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440597"></a>The following example matches all volumes for which the preferred plex is striped: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440624"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">v_pref_name.pl_layout&nbsp;=&nbsp;STRIPE</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440634"></a>Because <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_pref_name</b></font> is only defined for volumes that have <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v_read_pol</b></font> set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PREFER</b></font>, the preceding expression is equivalent to: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440670"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vol&nbsp;&amp;&amp;&nbsp;v_read_pol&nbsp;=&nbsp;PREFER&nbsp;&amp;&amp;&nbsp;v_pref_name.pl_layout&nbsp;=&nbsp;STRIPE</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440680"></a>The following expression matches any volume that contains a plex with a subdisk longer than 100 megabytes: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440707"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">any&nbsp;v_plex.pl_subdisk.sd_len&nbsp;&gt;&nbsp;100M</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440717"></a>If an expression contains a set but does not use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>any</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>in</b></font> operator, then an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>any</b></font> operator is assumed to surround the expression.  Thus, the preceding example can also be specified as: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440753"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">v_plex.pl_subdisk.sd_len&nbsp;&gt;&nbsp;100M</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440763"></a>The following example matches any record that was changed in the most recent set of changes to the disk group: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440790"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">update_tid&nbsp;=&nbsp;config_tid</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440800"></a>Alternatively, to get all records that have been changed since a past disk group configuration (with an configuration transaction ID of 0.23482), use: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440836"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">update_tid&nbsp;&gt;&nbsp;0.23482</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440846"></a>The following example matches all snapshots of volume <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol1</b></font>: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440864"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">any&nbsp;v_dco_name.dco_snap.sp_snap_volguid='vxprint&nbsp;-F%guid&nbsp;vol1'</font>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="440877"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440882"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>awk</b></font>(1), <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="vxmake_vxvm_manpages50_437196.html#431699"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake </b></font></font></a>(1M), <a href="vxmend_vxvm_manpages52_430893.html#428626"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmend </b></font></font></a>(1M), <a href="vxplex_vxvm_manpages56_438209.html#431636"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex </b></font></font></a>(1M), <a href="vxprint_vxvm_manpages58_439087.html#433463"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint </b></font></font></a>(1M), <a href="vxrelayout_vxvm_manpages62_430115.html#428262"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout </b></font></font></a>(1M), <a href="vxsd_vxvm_manpages69_433542.html#429949"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd </b></font></font></a>(1M), <a href="vxvol_vxvm_manpages85_441003.html#433596"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol </b></font></font></a>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>regcmp(3G) </b></font></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="vol_pattern_vxvm_manpages90_440877.html" title="vol_pattern">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="man4_titlepage_docCD_vxvm_manpages89_73700.vxhd" title="Previous - Devices (4)">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxmake_vxvm_manpages91_450355.html" title="Next - vxmake">Next</a>
&nbsp;&gt;&nbsp;&nbsp;</font>
  </td>
 <tr>
   <td height="9" border="0" cellspacing="0" cellpadding="0" colspan="2" bgcolor="#FFFFFF">
   </td>
 </tr>

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

<tr>
<td bgcolor="#FFFFFF" colspan="2" height="15" align="right">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Manual:  
<a href="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>
