[OpenSPARC-T2-DV] / tools / perl-5.8.0 / doc / MHonArc / resources / force.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<html>
<head>
<title>MHonArc Resources: FORCE</title>
</head>
<body>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev:&nbsp;<a href="foluplitxt.html">FOLUPLITXT</a>]</td><td><nobr>[<a href="../resources.html#force">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next:&nbsp;<a href="fromfields.html">FROMFIELDS</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<h1>FORCE</h1>

<!-- *************************************************************** -->
<hr>
<h2>Syntax</h2>

<dl>

<dt><strong>Envariable</strong></dt>
<dd><p>N/A
</p>
</dd>

<dt><strong>Element</strong></dt>
<dd><p>N/A
</p>
</dd>

<dt><strong>Command-line Option</strong></dt>
<dd><p>
<code>-force</code>
</p>
</dd>

</dl>

<!-- *************************************************************** -->
<hr>
<h2>Description</h2>

<p>FORCE causes MHonArc to override the lock on
the archive and perform the operations requested.
</p>

<p>When MHonArc processes an archive, it locks the
archive so other MHonArc processes do not try
to modify the archive at the same time.  However, if
MHonArc abnormally terminates, the lock may not
be released, causing all future MHonArc processes
to fail in performing any archive operations.  If
you get a message from MHonArc that it cannot
lock an archive, and you know the archive is not in use
by another MHonArc process, use the FORCE resource.
</p>

<table border=0 cellpadding=4>
<tr valign=top>
<td><strong>NOTE</strong></td>
<td><p>The alternative approach is to manually remove the
lockfile (see <a href="lockfile.html">LOCKFILE</a>).
</p>
</td>
</tr>
</table>

<p>The FORCE option should be used with care to avoid
archive corruption.  FORCE is active only for the current
MHonArc process.
</p>

<table border=0 cellpadding=4>
<tr valign=top>
<td><strong><font color="red">WARNING</font></strong></td>
<td><p>Having two, or more, MHonArc processes
processing the same archive with FORCE enabled can lead to
archive corruption.
</p>
</td>
</tr>
</table>

<p>MHonArc will still try to perform a normal lock before forcing the issue.
</p>

<!-- *************************************************************** -->
<hr>
<h2>Default Setting</h2>

<p>N/A
</p>

<!-- *************************************************************** -->
<hr>
<h2>Resource Variables</h2>

<p>N/A
</p>

<!-- *************************************************************** -->
<hr>
<h2>Examples</h2>

<p>None.
</p>

<!-- *************************************************************** -->
<hr>
<h2>Version</h2>

<p>1.2.2
</p>

<!-- *************************************************************** -->
<hr>
<h2>See Also</h2>

<p>
<a href="lockdelay.html">LOCKDELAY</a>,
<a href="lockfile.html">LOCKFILE</a>,
<a href="locktries.html">LOCKTRIES</a>
</p>

<!-- *************************************************************** -->
<hr>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev:&nbsp;<a href="foluplitxt.html">FOLUPLITXT</a>]</td><td><nobr>[<a href="../resources.html#force">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next:&nbsp;<a href="fromfields.html">FROMFIELDS</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<address>
$Date: 2002/07/27 05:13:10 $ <br>
<img align="top" src="../monicon.png" alt="">
<a href="http://www.mhonarc.org/"
><strong>MHonArc</strong></a><br>
Copyright &#169; 1997-1998, <a href="http://www.earlhood.com/"
>Earl Hood</a>, <a href="mailto:mhonarc@mhonarc.org"
>mhonarc@mhonarc.org</a><br>
</address>

</body>
</html>
Commit	Line	Data
86530b38 AT	1	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
	2	<html>
	3	<head>
	4	<title>MHonArc Resources: FORCE</title>
	5	</head>
	6	<body>
	7	<!--x-rc-nav-->
	8	<table border=0><tr valign="top">
	9	<td align="left" width="50%">[Prev: <a href="foluplitxt.html">FOLUPLITXT</a>]</td><td><nobr>[<a href="../resources.html#force">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="fromfields.html">FROMFIELDS</a>]</td></tr></table>
	10	<!--/x-rc-nav-->
	11	<hr>
	12	<h1>FORCE</h1>
	13
	14	<!-- *************************************************************** -->
	15	<hr>
	16	<h2>Syntax</h2>
	17
	18	<dl>
	19
	20	<dt><strong>Envariable</strong></dt>
	21	<dd><p>N/A
	22	</p>
	23	</dd>
	24
	25	<dt><strong>Element</strong></dt>
	26	<dd><p>N/A
	27	</p>
	28	</dd>
	29
	30	<dt><strong>Command-line Option</strong></dt>
	31	<dd><p>
	32	<code>-force</code>
	33	</p>
	34	</dd>
	35
	36	</dl>
	37
	38	<!-- *************************************************************** -->
	39	<hr>
	40	<h2>Description</h2>
	41
	42	<p>FORCE causes MHonArc to override the lock on
	43	the archive and perform the operations requested.
	44	</p>
	45
	46	<p>When MHonArc processes an archive, it locks the
	47	archive so other MHonArc processes do not try
	48	to modify the archive at the same time. However, if
	49	MHonArc abnormally terminates, the lock may not
	50	be released, causing all future MHonArc processes
	51	to fail in performing any archive operations. If
	52	you get a message from MHonArc that it cannot
	53	lock an archive, and you know the archive is not in use
	54	by another MHonArc process, use the FORCE resource.
	55	</p>
	56
	57	<table border=0 cellpadding=4>
	58	<tr valign=top>
	59	<td><strong>NOTE</strong></td>
	60	<td><p>The alternative approach is to manually remove the
	61	lockfile (see <a href="lockfile.html">LOCKFILE</a>).
	62	</p>
	63	</td>
	64	</tr>
65	</table>
66
67	<p>The FORCE option should be used with care to avoid
68	archive corruption. FORCE is active only for the current
69	MHonArc process.
70	</p>
71
72	<table border=0 cellpadding=4>
73	<tr valign=top>
74	<td><strong><font color="red">WARNING</font></strong></td>
75	<td><p>Having two, or more, MHonArc processes
76	processing the same archive with FORCE enabled can lead to
77	archive corruption.
78	</p>
79	</td>
80	</tr>
81	</table>
82
83	<p>MHonArc will still try to perform a normal lock before forcing the issue.
84	</p>
85
86	<!-- *************************************************************** -->
87	<hr>
88	<h2>Default Setting</h2>
89
90	<p>N/A
91	</p>
92
93	<!-- *************************************************************** -->
94	<hr>
95	<h2>Resource Variables</h2>
96
97	<p>N/A
98	</p>
99
100	<!-- *************************************************************** -->
101	<hr>
102	<h2>Examples</h2>
103
104	<p>None.
105	</p>
106
107	<!-- *************************************************************** -->
108	<hr>
109	<h2>Version</h2>
110
111	<p>1.2.2
112	</p>
113
114	<!-- *************************************************************** -->
115	<hr>
116	<h2>See Also</h2>
117
118	<p>
119	<a href="lockdelay.html">LOCKDELAY</a>,
120	<a href="lockfile.html">LOCKFILE</a>,
121	<a href="locktries.html">LOCKTRIES</a>
122	</p>
123
124	<!-- *************************************************************** -->
125	<hr>
126	<!--x-rc-nav-->
127	<table border=0><tr valign="top">
128	<td align="left" width="50%">[Prev: <a href="foluplitxt.html">FOLUPLITXT</a>]</td><td><nobr>[<a href="../resources.html#force">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="fromfields.html">FROMFIELDS</a>]</td></tr></table>
129	<!--/x-rc-nav-->
130	<hr>
131	<address>
132	$Date: 2002/07/27 05:13:10 $ <br>
133	<img align="top" src="../monicon.png" alt="">
134	<a href="http://www.mhonarc.org/"
135	><strong>MHonArc</strong></a><br>
136	Copyright © 1997-1998, <a href="http://www.earlhood.com/"
137	>Earl Hood</a>, <a href="mailto:mhonarc@mhonarc.org"
138	>mhonarc@mhonarc.org</a><br>
139	</address>
140
141	</body>
142	</html>