<!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="vx_vxhelp_2005c">
<meta name="LASTUPDATED" content="06/17/05 10:11:26">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="07_set_params.fm">
     
<title>MonitorInterval</title>

</HEAD>

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

<a name="999062"></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="07_set_params_vcs162_1000260.html" title="Previous - LogDbg">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="07_set_params_vcs164_999147.html" title="Next - Scheduling Class and Priority Configuration Support">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="vcs_splashpage_docCD_vcs1_103036.vxhd" title="Cluster Server Guides title page ">Cluster Server Guides</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="adg_hpux41_titlepage_docCD_vcs95_73700.vxhd" title="Cluster Server 4.1 Agent Developer's Guide title page ">Cluster Server 4.1 Agent Developer's Guide</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="999062"></a> MonitorInterval</font>
</h2>

        
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="999064"></a>Duration (in seconds) between two consecutive monitor calls for an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">ONLINE</font> or transitioning resource. Default is 60 seconds. The <font face="Courier New, Courier, sansserif, sans serif" size="2">MonitorInterval</font> attribute value can be overridden.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="1002476"></a>MonitorStatsParam</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1002485"></a>Refer to the <em>VERITAS Cluster Server User's Guide</em> for details about the <font face="Courier New, Courier, sansserif, sans serif" size="2">MonitorStatsParam</font> attribute, and the <font face="Courier New, Courier, sansserif, sans serif" size="2">MonitorTimeStats</font> attribute that is updated by VCS. See also <a href="07_set_params_vcs160_1006790.html#1011450">ComputeStats</a>.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1010224"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">MonitorStatsParam</font> is a resource type-level attribute, which stores the required parameter values for calculating monitor time statistics. </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1012502"></a>static&nbsp;str&nbsp;MonitorStatsParam&nbsp;=&nbsp;{&nbsp;Frequency&nbsp;=&nbsp;10,&nbsp;ExpectedValue&nbsp;=
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1012648"></a>&nbsp;&nbsp;3000,&nbsp;ValueThreshold&nbsp;=&nbsp;100,&nbsp;AvgThreshold&nbsp;=&nbsp;40&nbsp;}&nbsp;&nbsp;&nbsp;
</font>
<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1012507"></a><em>Frequency</em>: Defines the number of monitor cycles after which the average monitor cycle time should be computed and sent to the engine. The value for this attribute is must be between 1 and 30 and is set to 0 by default.   </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1012549"></a><em>ExpectedValue</em>: The expected monitor time in milliseconds for all resources of this type. Default=3000.   </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1012574"></a><em>ValueThreshold</em>: The acceptable percentage difference between the expected monitor cycle time (<em>ExpectedValue</em>) and the actual monitor cycle time. Default=100.   </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1012599"></a><em>AvgThreshold</em>: The acceptable percentage difference between the benchmark average and the moving average of monitor cycle times. Default=40.</font>
</li>
</ul>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1005047"></a>The <font face="Courier New, Courier, sansserif, sans serif" size="2">MonitorStatsParam</font> attribute values can be overridden.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="1071793"></a>MonitorTimeout</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1071795"></a>Maximum time (in seconds) within which the <font face="Courier New, Courier, sansserif, sans serif" size="2">monitor</font> entry point must complete or else be terminated. Default is 60 seconds. The <font face="Courier New, Courier, sansserif, sans serif" size="2">MonitorTimeout</font> attribute value can be overridden.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1071796"></a>The determination of the value of the <font face="Courier New, Courier, sansserif, sans serif" size="2">MonitorTimeout</font> attribute can be assisted by the use of the <font face="Courier New, Courier, sansserif, sans serif" size="2">MonitorStatsParam</font> attribute.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="1022005"></a>NumThreads</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="999070"></a>Number of threads used within the agent process for managing resources. This number does not include the three threads used for other internal purposes. Default is 10 threads. The <font face="Courier New, Courier, sansserif, sans serif" size="2">NumThreads</font> attribute value cannot be overridden.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="999071"></a>OfflineMonitorInterval</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="999073"></a>Duration (in seconds) between two consecutive monitor calls for an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">OFFLINE</font> resource. If set to 0, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">OFFLINE</font> resources are not monitored. Default is 300 seconds. The <font face="Courier New, Courier, sansserif, sans serif" size="2">OfflineMonitorInterval</font> attribute value can be overridden.</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="999074"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000">In previous releases, agents monitored offline resources once every minute by default. To reduce monitoring overhead, this frequency was changed to once every five minutes. This interval may be adjusted to meet specific configuration requirements.
</font>
<hr noshade size="2" width="100%" color="#000000">



<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="1071802"></a>OfflineTimeout</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1071804"></a>Maximum time (in seconds) within which the <font face="Courier New, Courier, sansserif, sans serif" size="2">offline</font> entry point must complete or else be terminated. Default is 300 seconds. The <font face="Courier New, Courier, sansserif, sans serif" size="2">OfflineTimeout</font> attribute value can be overridden.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="999080"></a>OnlineRetryLimit</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="999082"></a>Number of times to retry <font face="Courier New, Courier, sansserif, sans serif" size="2">online</font>, if the attempt to online a resource is unsuccessful. This attribute is meaningful only if <font face="Courier New, Courier, sansserif, sans serif" size="2">clean</font> is implemented. Default is 0. The <font face="Courier New, Courier, sansserif, sans serif" size="2">OnlineRetryLimit</font> attribute value can be overridden.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="1071810"></a>OnlineTimeout</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1071812"></a>Maximum time (in seconds) within which the <font face="Courier New, Courier, sansserif, sans serif" size="2">online</font> entry point must complete or else be terminated. Default is 300 seconds. The <font face="Courier New, Courier, sansserif, sans serif" size="2">OnlineTimeout</font> attribute value can be overridden.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="999088"></a>OnlineWaitLimit</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="999090"></a>Number of monitor intervals to wait after completing the online procedure, and before the resource becomes online. If the resource is not brought online after the designated monitor intervals, the online attempt is considered ineffective. This attribute is meaningful only if the <font face="Courier New, Courier, sansserif, sans serif" size="2">clean</font> entry point is implemented. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="999091"></a>If clean is not implemented, the agent continues to periodically run <font face="Courier New, Courier, sansserif, sans serif" size="2">monitor</font> until the resource comes online.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="999092"></a>If <font face="Courier New, Courier, sansserif, sans serif" size="2">clean</font> is implemented, when the agent reaches the maximum number of monitor intervals it assumes that the online procedure was ineffective and runs <font face="Courier New, Courier, sansserif, sans serif" size="2">clean</font>. The agent then notifies the engine that the online failed, or retries the procedure, depending on whether or not the OnlineRetryLimit is reached. Default is 2. The <font face="Courier New, Courier, sansserif, sans serif" size="2">OnlineWaitLimit</font> attribute value can be overridden.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="1071817"></a>OpenTimeout</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1071819"></a>Maximum time (in seconds) within which the <font face="Courier New, Courier, sansserif, sans serif" size="2">open</font> entry point must complete or else be terminated. Default is 60 seconds. The <font face="Courier New, Courier, sansserif, sans serif" size="2">OpenTimeout</font> attribute value can be overridden.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="1037940"></a>Operations</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1018151"></a>Indicates the valid operations of resources of the resource type. The values are OnOff (can be onlined and offlined), OnOnly (can be onlined only), and None (cannot be onlined or offlined). Default is OnOff. The <font face="Courier New, Courier, sansserif, sans serif" size="2">Operations</font> attribute value cannot be overridden.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="999100"></a>ResourceInfo</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="999101"></a>The <font face="Courier New, Courier, sansserif, sans serif" size="2">ResourceInfo</font> (association-string) is a temporary attribute, the scope of which is set by the engine to be global for failover groups or local for parallel groups. Because <font face="Courier New, Courier, sansserif, sans serif" size="2">ResourceInfo</font> is a temporary attribute, its values are never dumped to the <font face="Courier New, Courier, sansserif, sans serif" size="2">main.cf</font> file.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="999102"></a>The values of the <font face="Courier New, Courier, sansserif, sans serif" size="2">ResourceInfo</font> attribute are expressed in three mandatory keys: <font face="Courier New, Courier, sansserif, sans serif" size="2">State,</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">Msg,</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">and</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">TS.</font>For <font face="Courier New, Courier, sansserif, sans serif" size="2">State</font>, the possible values are &quot;Valid,&quot; (the default), &quot;Invalid,&quot; and &quot;Stale&quot;). <font face="Courier New, Courier, sansserif, sans serif" size="2">Msg</font> (default is &quot;&quot;, a null string) contains the output from the entry point. <font face="Courier New, Courier, sansserif, sans serif" size="2">TS</font> contains the time at which the attribute is has been updated or modified. These mandatory keys are updated only by the agent framework, not the entry point. The entry point can define and add other keys (name-value pairs) and update them.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="999103"></a>The value of the <font face="Courier New, Courier, sansserif, sans serif" size="2">ResourceInfo</font> attribute can be displayed using the <font face="Courier New, Courier, sansserif, sans serif" size="2">hares</font> command. The output of <font face="Courier New, Courier, sansserif, sans serif" size="2">hares</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-display</font> shows the first 20 characters of the current value; the output of <font face="Courier New, Courier, sansserif, sans serif" size="2">hares</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-value</font> <em>resource</em> <font face="Courier New, Courier, sansserif, sans serif" size="2">ResourceInfo</font> shows all name-value pairs in the keylist.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="999104"></a>The resource for which the <font face="Courier New, Courier, sansserif, sans serif" size="2">info</font> entry point is invoked must be online. When a resource goes offline or faults, the <font face="Courier New, Courier, sansserif, sans serif" size="2">State</font> key is marked &quot;Stale&quot; because the information is not current. If the <font face="Courier New, Courier, sansserif, sans serif" size="2">info</font> entry point exits abnormally, the <font face="Courier New, Courier, sansserif, sans serif" size="2">State</font> key is marked &quot;Invalid&quot; because not all of the information is known to be valid. The other key data, including <font face="Courier New, Courier, sansserif, sans serif" size="2">Msg</font> and <font face="Courier New, Courier, sansserif, sans serif" size="2">TS</font> keys, are not touched. The values of the <font face="Courier New, Courier, sansserif, sans serif" size="2">ResourceInfo</font> attribute can be manually cleared using the <font face="Courier New, Courier, sansserif, sans serif" size="2">hares</font> <font face="Courier New, Courier, sansserif, sans serif" size="2">-flushinfo</font> command. This command deletes any optional keys for the <font face="Courier New, Courier, sansserif, sans serif" size="2">ResourceInfo</font> attribute and sets the three mandatory keys to their default values. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="999105"></a>See the <font face="Courier New, Courier, sansserif, sans serif" size="2">hares</font> manual page.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="999107"></a>RestartLimit</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="999111"></a>Affects how the agent responds to a resource fault (see <a href="07_set_params_vcs161_1071741.html#1071741">FaultOnMonitorTimeouts</a> and <a href="07_set_params_vcs163_999062.html#1001826">ToleranceLimit</a>). A non-zero <font face="Courier New, Courier, sansserif, sans serif" size="2">RestartLimit</font> causes VCS to invoke the <font face="Courier New, Courier, sansserif, sans serif" size="2">online</font> entry point instead of failing over the service group to another system. VCS attempts to restart the resource according to the number set in RestartLimit before it gives up and fails over. However, if the resource remains online for the interval designated in ConfInterval, earlier attempts to restart are not counted against RestartLimit. Default is 0. The <font face="Courier New, Courier, sansserif, sans serif" size="2">RestartLimit</font> attribute value can be overridden.</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="999116"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000">The agent will not restart a faulted resource if the <font face="Courier New, Courier, sansserif, sans serif" size="2">clean</font> entry point is not implemented. Therefore, the value of the <font face="Courier New, Courier, sansserif, sans serif" size="2">RestartLimit</font> attribute applies only if <font face="Courier New, Courier, sansserif, sans serif" size="2">clean</font> is implemented.
</font>
<hr noshade size="2" width="100%" color="#000000">



<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="999118"></a>RegList</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1049875"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">RegList</font> is a type-level attribute of the type keylist that can be used to store, or register, a list of certain resource level attributes. The agent calls the <font face="Courier New, Courier, sansserif, sans serif" size="2">attr_changed</font> entry point for a resource when the value of an attribute listed in <font face="Courier New, Courier, sansserif, sans serif" size="2">RegList</font> is modified. The <font face="Courier New, Courier, sansserif, sans serif" size="2">RegList</font> attribute is useful where a change in the values of important attributes require specific actions that can be executed from the <font face="Courier New, Courier, sansserif, sans serif" size="2">attr_changed</font> entry point.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1049250"></a>By default, the attribute <font face="Courier New, Courier, sansserif, sans serif" size="2">RegList</font> is not included in a resource's type definition, but it can be added using either of the two methods shown below.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1050047"></a>Assume the <font face="Courier New, Courier, sansserif, sans serif" size="2">RegList</font> attribute is added to the FileOnOff resource type definition and its value is defined as <font face="Courier New, Courier, sansserif, sans serif" size="2">PathName</font>. Thereafter, when the value of the <font face="Courier New, Courier, sansserif, sans serif" size="2">PathName</font> attribute for a FileOnOff resource is modified, the <font face="Courier New, Courier, sansserif, sans serif" size="2">attr_changed</font> entry point is called.</font>
</p>

<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1049330"></a>Method one is to modify the types definition file (<font face="Courier New, Courier, sansserif, sans serif" size="2">types.cf</font>, for example) to include the <font face="Courier New, Courier, sansserif, sans serif" size="2">RegList</font> attribute. Add a line in the definition of a resource type that resembles:</font>
</li>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1049353"></a>&nbsp;&nbsp;static&nbsp;keylist&nbsp;RegList&nbsp;=&nbsp;{&nbsp;<em>attribute1_name,&nbsp;attribute2_name,&nbsp;...</em>}
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1049909"></a>For example, if the type definition is for the FileOnOff resource and the name of the attribute to register is <font face="Courier New, Courier, sansserif, sans serif" size="2">PathName</font>, the modified type definition would resemble:</font>
</blockquote>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1049934"></a>&nbsp;&nbsp;.
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1049944"></a>&nbsp;&nbsp;.
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1049939"></a>&nbsp;&nbsp;.
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1049925"></a>&nbsp;&nbsp;type&nbsp;FileOnOff&nbsp;(
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1049953"></a>&nbsp;&nbsp;&nbsp;&nbsp;str&nbsp;PathName
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1049973"></a><font face="Courier New, Courier, sansserif, sans serif" size="2"><b>&nbsp;&nbsp;&nbsp;&nbsp;static&nbsp;keylist&nbsp;RegList&nbsp;=&nbsp;{&nbsp;PathName&nbsp;}</b></font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1049963"></a>&nbsp;&nbsp;&nbsp;&nbsp;static&nbsp;str&nbsp;ArgList[]&nbsp;=&nbsp;{&nbsp;PathName&nbsp;}
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1049968"></a>&nbsp;&nbsp;)
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1049984"></a>&nbsp;&nbsp;.
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1049985"></a>&nbsp;&nbsp;.
</font>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1049411"></a>Method two is to use the <font face="Courier New, Courier, sansserif, sans serif" size="2">haattr</font> command to add the <font face="Courier New, Courier, sansserif, sans serif" size="2">RegList</font> attribute to a resource type definition and then modify the value of the type's <font face="Courier New, Courier, sansserif, sans serif" size="2">RegList</font> attribute using the <font face="Courier New, Courier, sansserif, sans serif" size="2">hatype</font> command; the commands are:</font>
</li>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1049466"></a>&nbsp;&nbsp;haattr&nbsp;-add&nbsp;-static&nbsp;<em>resource_type</em>&nbsp;RegList&nbsp;-keylist
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1049467"></a>&nbsp;&nbsp;hatype&nbsp;-modify&nbsp;<em>resource_type</em>&nbsp;RegList&nbsp;<em>attribute_name</em>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1049483"></a>For example:</font>
</blockquote>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1049494"></a>&nbsp;&nbsp;#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>haattr&nbsp;-add&nbsp;-static&nbsp;FileOnOff&nbsp;RegList&nbsp;-keylist</b></font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1049505"></a>&nbsp;&nbsp;#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>hatype&nbsp;-modify&nbsp;FileOnOff&nbsp;RegList&nbsp;PathName</b></font>
</font>
</ul>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1049154"></a>The RegList attribute cannot be overridden.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="1002312"></a>SupportedActions</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1002313"></a>The SupportedActions (string-keylist) attribute lists all possible actions defined for an agent, including those defined by the agent developer. The engine validates the <em>action_token</em> value specified in the <font face="Courier New, Courier, sansserif, sans serif" size="2">hares -action </font><em>resource action_token</em><font face="Courier New, Courier, sansserif, sans serif" size="2"> </font>command against the SupportedActions attribute. It is the responsibility of the agent developer to initialize the SupportedActions attribute in the resource type definition and update the definition for each new action added to the <font face="Courier New, Courier, sansserif, sans serif" size="2">action</font> entry point code or script. See <a href="02_ep_oview_vcs117_999153.html#999153">action</a>. This attribute serves as a reference for users of the command line or the graphical user interface.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1002314"></a>An example definition of a resource type may resemble:</font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1002315"></a>Type&nbsp;DBResource&nbsp;(
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1002316"></a>&nbsp;&nbsp;static&nbsp;str&nbsp;ArgList[]&nbsp;=&nbsp;{&nbsp;Sid,&nbsp;Owner,&nbsp;Home,&nbsp;User,&nbsp;Pwork,&nbsp;StartOpt,&nbsp;
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1002317"></a>&nbsp;&nbsp;&nbsp;ShutOpt&nbsp;}
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1002319"></a>&nbsp;&nbsp;static&nbsp;keylist&nbsp;SupportedActions&nbsp;=&nbsp;{&nbsp;VRTS_GetRunningServices,
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1002320"></a>&nbsp;&nbsp;&nbsp;&nbsp;DBRestrict,&nbsp;DBUndoRestrict,&nbsp;DBSuspend,&nbsp;DBResume&nbsp;}
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1002321"></a>&nbsp;&nbsp;str&nbsp;Sid
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1002322"></a>&nbsp;&nbsp;str&nbsp;Owner
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1002323"></a>&nbsp;&nbsp;str&nbsp;Home
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1002324"></a>&nbsp;&nbsp;str&nbsp;User
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1002325"></a>&nbsp;&nbsp;str&nbsp;Pword
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1002326"></a>&nbsp;&nbsp;str&nbsp;StartOpt
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="1002327"></a>&nbsp;&nbsp;str&nbsp;ShutOpt
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="1002468"></a>In the <font face="Courier New, Courier, sansserif, sans serif" size="2">SupportedActions</font> attribute definition above, <font face="Courier New, Courier, sansserif, sans serif" size="2">VRTS_GetRunningServices</font> is a VERITAS predefined action, and the actions following it are defined by the developer. The <font face="Courier New, Courier, sansserif, sans serif" size="2">SupportedActions</font> attribute value cannot be overridden.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="1001826"></a>ToleranceLimit</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="999145"></a>A non-zero ToleranceLimit allows the <font face="Courier New, Courier, sansserif, sans serif" size="2">monitor</font> entry point to return <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">OFFLINE</font> several times before the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">ONLINE</font> resource is declared <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">FAULTED</font>. If the <font face="Courier New, Courier, sansserif, sans serif" size="2">monitor</font> entry point reports <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">OFFLINE</font> more times than the number set in ToleranceLimit, the resource is declared <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">FAULTED</font>. However, if the resource remains online for the interval designated in ConfInterval, any earlier reports of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">OFFLINE</font> are not counted against ToleranceLimit. Default is 0. The <font face="Courier New, Courier, sansserif, sans serif" size="2">ToleranceLimit</font> attribute value can be overridden.</font>
</p>


<!-- 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="07_set_params_vcs163_999062.html" title="MonitorInterval">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="07_set_params_vcs162_1000260.html" title="Previous - LogDbg">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="07_set_params_vcs164_999147.html" title="Next - Scheduling Class and Priority Configuration Support">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="vcs_splashpage_docCD_vcs1_103036.vxhd" title="Cluster Server Guides title page ">Cluster Server Guides</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="adg_hpux41_titlepage_docCD_vcs95_73700.vxhd" title="Cluster Server 4.1 Agent Developer's Guide title page ">Cluster Server 4.1 Agent Developer's Guide</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>
