<html>
<head>
<title>MHonArc Resources: EXPIREAGE</title>
<link rel="stylesheet" type="text/css" href="../docstyles.css">
</head>
<body>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev: <a href="excs.html">EXCS</a>]</td><td><nobr>[<a href="../resources.html#expireage">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="expiredate.html">EXPIREDATE</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<h1>EXPIREAGE</h1>
<!--X-TOC-Start-->
<ul>
<li><a href="#syntax">Syntax</a>
<li><a href="#description">Description</a>
<li><a href="#default">Default Setting</a>
<li><a href="#rcvars">Resource Variables</a>
<li><a href="#examples">Examples</a>
<li><a href="#version">Version</a>
<li><a href="#seealso">See Also</a>
</ul>
<!--X-TOC-End-->
<!-- *************************************************************** -->
<hr>
<h2><a name="syntax">Syntax</a></h2>
<dl>
<dt><strong>Envariable</strong></dt>
<dd><p>
<code>M2H_EXPIREAGE=</code><var>seconds</var>
</p>
</dd>
<dt><strong>Element</strong></dt>
<dd><p>
<code><EXPIREAGE><br></code>
<var>seconds</var><br>
<code></EXPIREAGE><br></code>
</p>
</dd>
<dt><strong>Command-line Option</strong></dt>
<dd><p>
<code>-expireage </code><var>seconds</var>
</p>
</dd>
</dl>
<!-- *************************************************************** -->
<hr>
<h2><a name="description">Description</a></h2>
<p>EXPIREAGE specifies the time in seconds from the current
time to determine if a message has expired. I.e. If the difference
between the current time and the message time is greater
than EXPIREAGE, the message is expired. Expired messages
do not get added into an archive, and any archived
expired messages will get automatically removed during
an archive update.
</p>
<p>EXPIREAGE is specified in seconds. The following table
shows common time periods in seconds:
</p>
<table cellspacing=1 border=1 cellpadding=4>
<tr>
<th>Time period</th><th>Equivalence in seconds</th>
</tr>
<tr valign=top align=center>
<td>day</td><td>86400</td>
</tr>
<tr valign=top align=center>
<td>week (7 days)</td><td>604800</td>
</tr>
<tr valign=top align=center>
<td>month (30.5 days)</td><td>2635200</td>
</tr>
<tr valign=top align=center>
<td>year (365 days)</td><td>31536000</td>
</tr>
</table>
<dl>
<dt><strong>NOTE</strong></dt>
<dd><p>Setting EXPIREAGE to zero turns off the
EXPIREAGE check.
</p>
</dd>
</dl>
<p>If you want to control expiration of messages based
on a specific date, then see
<a href="expiredate.html">EXPIREDATE</a>.
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="default">Default Setting</a></h2>
<p>0
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="rcvars">Resource Variables</a></h2>
<p>N/A
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="examples">Examples</a></h2>
<p>EXPIREAGE is useful for "message from the last ..." archives.
For example, if you are archiving a mailing list with much traffic,
you may want to have an archive that shows only messages from the
last 7 days (week). Set set EXPIREAGE as follows: </p>
<pre class="code">
<b><ExpireAge></b>
604800
<b></ExpireAge></b>
</pre>
<!-- *************************************************************** -->
<hr>
<h2><a name="version">Version</a></h2>
<p>2.0
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="seealso">See Also</a></h2>
<p>
<a href="expiredate.html">EXPIREDATE</a>
</p>
<!-- *************************************************************** -->
<hr>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev: <a href="excs.html">EXCS</a>]</td><td><nobr>[<a href="../resources.html#expireage">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="expiredate.html">EXPIREDATE</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<address>
$Date: 2003/10/06 22:04:16 $ <br>
<img align="top" src="../monicon.png" alt="">
<a href="http://www.mhonarc.org/"
><strong>MHonArc</strong></a><br>
Copyright © 1997-1998, <a href="http://www.earlhood.com/"
>Earl Hood</a>, <a href="mailto:mhonarc%40mhonarc.org"
>mhonarc<!--
-->@<!--
-->mhonarc.org</a><br>
</address>
</body>
</html>