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

</HEAD>

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

<a name="430825"></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="vxstat_vxvm_manpages75_430625.html" title="Previous - vxstat">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxtemplate_vxvm_manpages77_430919.html" title="Next - vxtemplate">Next</a>
&nbsp;&gt;&nbsp;&nbsp;</font>
   </td>
 </tr>

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


</table>
</div>

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

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

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428733"></a> NAME</font>
</h3>
<p>
<a name="428738"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxtask - list and administer VERITAS Volume Manager tasks </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428741"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428746"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtask abort</b></font> <em>taskid </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428749"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtask  </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-ahlpqr </b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>dg_name </em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>dg_name...</em>]] [[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-G </b></font><em>dg_name</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-v </b></font><em>volume </em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-v </b></font><em>volume</em>...\]] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-i </b></font><em>taskid</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>list </b></font>[<em>taskid</em>...\] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428826"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtask pause</b></font> <em>taskid </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428829"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtask resume</b></font> <em>taskid </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428832"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtask  </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-i </b></font><em>taskid</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>set </b></font><em>name=value taskid </em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c </b></font><em>count</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t </b></font><em>time</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-w </b></font><em>wait_interval</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-ln </b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>monitor </b></font>[<em>taskid</em>[<em>taskid</em>...\]] 
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428900"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428905"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtask</b></font> utility performs basic administrative operations on VERITAS Volume Manager (VxVM) <em>tasks</em> that are running on the system. Operations include listing tasks (subject to filtering), modifying the state of a task (aborting, pausing, resuming), and modifying the rate of progress of a task. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428944"></a>VERITAS Volume Manager tasks represent long-term operations in progress on the system. Every task provides the time the operation started, the size and progress of the operation, and the operation's state and rate of progress (throttle). You can change the state of a task, giving coarse-grained control over an operation's progress. For those operations that support throttling, you can change the rate of progress of a task, giving more fine-grained control over the task. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429010"></a>The majority of tasks represent I/O being performed to objects. Operations such as read-writeback recovery for mirrored volumes, parity recalculation for RAID-5 volumes, volume relayouts, and so forth, all involve moderate to large amounts of I/O. Tasks that represent operations that perform I/O directly are referred to as <em>basic</em> tasks. The task progress information for basic tasks consists of the starting and ending block of the I/O to be performed and the offset to which the I/O has currently completed. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429076"></a>Some operations, such as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover</b></font> and starting RAID-5 volumes, may require multiple tasks to complete the operation. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover</b></font> may determine that many recoveries are required, some that must be performed serially. Starting a RAID-5 volume requires that its log (if any) be replayed and cleared, its parity be recalculated (if necessary), any stale subdisks be resynchronized (if needed), and that these tasks be performed serially. In these and similar cases, an overall task is created to keep track of the underlying basic tasks being performed, and these are known as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>parent</b></font> tasks. The progress information for parent tasks are the total number of subtasks required to complete the overall operation; the number of subtasks completed; and the number of subtasks currently running. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429187"></a>Every task is given a unique <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>task identifier</b></font>. This is a numeric identifier for the task that can be specified to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtask </b></font>utility to specifically identify a single task. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429209"></a>Tasks also contain the following information: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429213"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>task tag</b></font></font>
</p>
<p>
<a name="431114"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A task's tag is a string that you can specify to make administration easier. It is usually set by the command that initiates the task. For most utilities, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t </b></font><em>tasktag</em> option allows a tag to be specified as a sequence of up to 16 alphanumeric characters. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429262"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>task type</b></font></font>
</p>
<p>
<a name="431137"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The task's type describes the specific operation that is being performed. For example, attaching a plex to a volume results in an atomic copy loop, which is represented by an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATOMIC_COPY</b></font> task. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429293"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>description</b></font></font>
</p>
<p>
<a name="431160"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Describes the utility operation on whose behalf the I/O is being performed. For example, both a volume start and a plex attach can result in an atomic copy loop and thus an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATOMIC_COPY</b></font> task. The description of the operation attempts to disambiguate between tasks that are performing the same basic work. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429342"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>object</b></font></font>
</p>
<p>
<a name="431179"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Most tasks are related to a specific object, usually the volume within which the operation is taking place. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429364"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>parent</b></font></font>
</p>
<p>
<a name="431202"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Some utilities require multiple operations to fulfill a request. For example, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover</b></font> utility may need to start many different volumes. In these cases, the subtasks list their parent. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429395"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>progress\ information</b></font></font>
</p>
<p>
<a name="431221"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each task has an indication of its starting point and ending point, and an indication as to what point it has progressed so far. Combined with the work time, this allows the amount of time remaining until completion to be estimated for some tasks. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429435"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>state</b></font></font>
</p>
<p>
<a name="431252"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each task has one of three states: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RUNNING</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PAUSED</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ABORTING</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429457"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>time</b></font></font>
</p>
<p>
<a name="431271"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each task notes its starting time and the total amount of time spent doing work. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429478"></a> KEYWORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429484"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>abort</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pause</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>resume</b></font></font>
</p>
<p>
<a name="431310"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">These three operations request that the specified task change its state. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pause</b></font> puts a running task in the paused state, suspending its operation. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>resume</b></font> continues the operation of a paused task. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>abort</b></font> stops the operation of the specified. In most cases, the operations &quot;back out&quot; in a manner similar to when an I/O error occurs, reversing as much as possible what's been done so far. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429569"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>list</b></font></font>
</p>
<p>
<a name="431329"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">List tasks running on the system in one-line summaries. The value displayed for percentage task progress takes into account all intermediate steps that are required to accomplish a specific task. </font>
</p>
<p>
<a name="425121"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">By default, all tasks running on the system are printed. If a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>taskid</b></font> argument is supplied, the output is limited to those tasks whose taskid or task tag match <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>taskid</b></font>. The remaining options filter and limit the listed tasks as follows: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429643"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-a</b></font></font>
</p>
<p>
<a name="431363"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Limits the output to tasks in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>aborting</b></font> state. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429656"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>dg_name</em></font>
</p>
<p>
<a name="431390"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Limits the listed tasks to those tasks running on objects in the diskgroup <em>dg_name</em>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429678"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-G</b></font></font>
</p>
<p>
<a name="431413"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Distinguishes between volumes with the same name in different diskgroups; see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429700"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-h</b></font></font>
</p>
<p>
<a name="431432"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Prints tasks hierarchically with a task's child tasks following the parent task. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429722"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-l</b></font></font>
</p>
<p>
<a name="431451"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Prints tasks in long format. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429735"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-p</b></font></font>
</p>
<p>
<a name="431474"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Limits the output to tasks in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>paused</b></font> state. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429748"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-q</b></font></font>
</p>
<p>
<a name="431493"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Suppresses printing of column headings. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429761"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r</b></font></font>
</p>
<p>
<a name="431516"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Limits the output to tasks in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>running</b></font> state. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429774"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-v </b></font><em>volume</em></font>
</p>
<p>
<a name="431543"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Limits the output to tasks whose object is <em>volume</em>. </font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425158"></a>Any task meeting any of the criteria specified are printed. That is, if <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-v </b></font><em>foovol</em> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-p</b></font> are specified, then any task operating on <em>foovol</em> or that is paused are printed. If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-h</b></font> were also specified, then those tasks and all their children would be listed. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429840"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>monitor</b></font></font>
</p>
<p>
<a name="431586"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The monitor operation continuously prints information about a task or group of tasks as the task information changes. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-l</b></font> option specifies printing a long listing. The default is to print  one-line listings. </font>
</p>
<p>
<a name="425170"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>monitor</b></font> command accepts the following options: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429906"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c </b></font><em>count</em></font>
</p>
<p>
<a name="431620"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Prints <em>count</em> sets of task information, then exits. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429919"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-n</b></font></font>
</p>
<p>
<a name="431639"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Monitors not only the tasks specified on the command line, but also any tasks newly registered while the program is running. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429950"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t </b></font><em>time</em></font>
</p>
<p>
<a name="431666"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Exits after <em>time</em> seconds. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429963"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-w </b></font><em>interval</em></font>
</p>
<p>
<a name="431693"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Prints the string &quot;waiting...&quot; when <em>interval </em>seconds pass with no output activity. </font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425190"></a>In addition to printing task information when a task state changes, output is also generated when the task completes. When this occurs, the task state is printed as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EXITED</b></font> (see the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>OUTPUT</b></font> section). </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430019"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>set</b></font></font>
</p>
<p>
<a name="431748"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>set</b></font> operation changes modifiable parameters of a task. There is only one modifiable parameter for tasks: the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>slow</b></font> attribute, which represents a throttle on the task progress. The larger the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>slow</b></font> value, the slower the progress of the task and the fewer system resources it consumes in a given time. (The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>slow</b></font> attribute is the same attribute that many commands, such as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover</b></font>, accept.) </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430112"></a> OUTPUT</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430117"></a>There are two output formats printed by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtask</b></font>: a short, one-line summary format per task, and a long task listing. The short listing attempts to provide the most used task information for quick perusal, displaying the following fields from left to right: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430148"></a>1.</font>
</p>
<p>
<a name="431767"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The task ID for the task. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430161"></a>2.</font>
</p>
<p>
<a name="431782"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The task ID of the task's parent, if any. If the task has no parent, this field is left blank. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430183"></a>3.</font>
</p>
<p>
<a name="431821"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The task type and state, separated by a slash (/). The type field is a description of the work being performed, such as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATOMIC COPY </b></font>for atomic copy I/O and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RELAYOUT</b></font> for an online relayout operation. The state is a single letter representing the task state: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>R</b></font> for running, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>P</b></font> for paused, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>K</b></font> for aborting. In the special case of the completion of a task that is being monitored, the state is printed as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EXITING</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430250"></a>4.</font>
</p>
<p>
<a name="431836"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The percentage of the operation that has been completed to this point. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430263"></a>5.</font>
</p>
<p>
<a name="431851"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The task's progress information. For basic tasks, this is the starting offset, ending offset and current offset for the operation, separated by slashes (/). For parent tasks, this is the starting number of child tasks, total number of child tasks required for the operation to complete, and the number of child tasks already completed to this point, separated by slashes, followed by the number of children currently running in parentheses. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430330"></a>6.</font>
</p>
<p>
<a name="431878"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A description of the command for which the task is performing work. This is normally a single word, such as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>START</b></font> for a volume start operation or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RELAYOUT</b></font> for an online relayout, followed by object names, indicating what the arguments were for the command. See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EXAMPLES</b></font> below. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430378"></a>The long output format prints all available information for a task, spanning multiple lines. If more than one task is printed, the output for different tasks is separated by a single blank line. Each line in the long output format contains a title for the line, followed by a colon (:), followed by the information. The possible information printed for a task includes: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430427"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Operation:</b></font></font>
</p>
<p>
<a name="431897"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A description of the operation on whose behalf the work is being performed. This is essentially a description of the command executed along with the VERITAS Volume Manager objects specified as arguments. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430458"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Progress:</b></font></font>
</p>
<p>
<a name="431916"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A description of the progress of the task. The progress is stated as a percentage of completion, along with the actual progress values for the task. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430489"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Started:</b></font></font>
</p>
<p>
<a name="431935"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The time that the task was started. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430502"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Task:</b></font></font>
</p>
<p>
<a name="431966"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">General information for the task. The task's ID, followed by its parent's ID (if any) in parentheses, followed by the task's state, either <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RUNNING</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PAUSED</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ABORTING</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430533"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Throttle</b></font></font>
</p>
<p>
<a name="431985"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The throttle value for the task, if applicable. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430546"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Type:</b></font></font>
</p>
<p>
<a name="432004"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The task type, describing the work being performed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430559"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Work time:</b></font></font>
</p>
<p>
<a name="432023"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">States how much time has been spent performing the work, and a rough estimate of the time remaining for the task to complete. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430580"></a>As a special case, when a task being monitored completes only the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Task:</b></font> line is printed for the task, with the task state represented by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EXITED</b></font>. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430601"></a> EXAMPLES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430606"></a>To list all tasks currently running on the system: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430624"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxtask&nbsp;list</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430634"></a>To trace all tasks in the diskgroup <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>foodg</b></font> that are currently paused, as well as any tasks with the tag <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sysstart</b></font>: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430661"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxtask&nbsp;-g&nbsp;foodg&nbsp;-p&nbsp;-i&nbsp;sysstart&nbsp;list</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430671"></a>To list all tasks on the system that are currently paused: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430692"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxtask&nbsp;-p&nbsp;list</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430708"></a>To monitor all tasks with the tag <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>myoperation</b></font>: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430729"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxtask&nbsp;monitor&nbsp;myoperation</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430745"></a>To cause all tasks tagged with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>recovall</b></font> to exit: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430766"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxtask&nbsp;abort&nbsp;recovall</font>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430782"></a> FILES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430788"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/vx/info</b></font></font>
</p>
<p>
<a name="432096"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Used to get task information from the kernel. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430807"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/vx/taskmon</b></font></font>
</p>
<p>
<a name="432115"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Task monitoring device. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430825"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430830"></a><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="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="vxrecover_vxvm_manpages61_429816.html#428010"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover </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>
</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="vxtask_vxvm_manpages76_430825.html" title="vxtask">Return to Top</a></font>

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

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

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


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

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

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

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

    Apache Jakarta Lucene:
    Apache Software License
    Version 1.1

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

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

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

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

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

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

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

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

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