ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/endnfssvr.htm

195 lines
6.4 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>End NFS Server (ENDNFSSVR)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="ENDNFSSVR.Top_Of_Page"></a>
<h2>End NFS Server (ENDNFSSVR)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#ENDNFSSVR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ENDNFSSVR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ENDNFSSVR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ENDNFSSVR"></a>
<p>The End Network File System Server (ENDNFSSVR) command ends one or all of the NFS server daemons. For more information about these daemon jobs, see Network File System book, SC41-5714.
</p>
<p>SERVER(*ALL) should be specified, which will end the daemons in the following order. (This order is the recommended order for ending the Network File System daemons.)
</p>
<ul>
<li>The network lock manager (NLM) daemon
</li>
<li>The network status monitor (NSM) daemon
</li>
<li>The mount (MNT) daemon
</li>
<li>The server (SVR) daemon(s)
</li>
<li>The block input/output (I/O) (BIO) daemon(s)
</li>
<li>The Remote Procedure Call (RPC) RPCBind daemon
</li>
</ul>
<p>If just one daemon is to be ended, be sure the appropriate order for ending NFS daemons and the possible consequences of ending daemons in an order other than that specified above are understood. For more information about ending NFS daemons, see the Network File System book, SC41-5714.
</p>
<p>If the user attempts to end a daemon or daemons that are not running, they will not cause the command to fail, and it will continue to end other daemons that were requested to end.
</p>
<p>To determine if an NFS daemon is running, use the Work with Active Jobs (WRKACTJOB) command and look in the subsystem QSYSWRK for existence of the following jobs:
</p>
<p>
<pre>
QNFSRPCD The RPCBind daemon
QNFSBIOD The block I/O (BIO) daemon
QNFSNFSD The server (SVR) daemon
QNFSMNTD The mount (MNT) daemon
QNFSNSMD The network status monitor (NSM) daemon
QNFSNLMD The network lock manager (NLM) daemon
</pre>
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>The user must have input/output (I/O) system configuration (*IOSYSCFG) special authority to use this command.
</li>
<li>The user must have job control (*JOBCTL) special authority to end any daemon jobs that were started by someone else.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDNFSSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ENDNFSSVR.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#ENDNFSSVR.SERVER"><b>SERVER</b></a></td>
<td valign="top">Server daemon</td>
<td valign="top">*ALL, *RPC, *BIO, *SVR, *MNT, *NSM, *NLM</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#ENDNFSSVR.ENDJOBTIMO"><b>ENDJOBTIMO</b></a></td>
<td valign="top">Timeout for end of daemon</td>
<td valign="top">1-3600, <b><u>30</u></b>, *NOMAX</td>
<td valign="top">Optional, Positional 2</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ENDNFSSVR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ENDNFSSVR.SERVER"></a>
<h3>Server daemon (SERVER)</h3>
<p>Specifies the Network File System (NFS) daemon jobs to be ended.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All NFS daemons will be ended.
</dd>
<dt><b>*RPC</b></dt>
<dd>The NFS Remote Procedure Call (RPC) RPCBind daemon will be ended.
</dd>
<dt><b>*BIO</b></dt>
<dd>All NFS block input/output (I/O) daemons that are running will be ended.
</dd>
<dt><b>*SVR</b></dt>
<dd>All NFS server daemons that are running will be ended.
</dd>
<dt><b>*MNT</b></dt>
<dd>The NFS mount daemon will be ended.
</dd>
<dt><b>*NSM</b></dt>
<dd>The NFS network status monitor daemon will be ended.
</dd>
<dt><b>*NLM</b></dt>
<dd>The NFS network lock manager daemon will be ended.
</dd>
</dl>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDNFSSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDNFSSVR.ENDJOBTIMO"></a>
<h3>Timeout for end of daemon (ENDJOBTIMO)</h3>
<p>Specifies the number of seconds to wait for each daemon to successfully end. If a daemon has not ended within the timeout value, the command will fail.
</p>
<dl>
<dt><b><u>30</u></b></dt>
<dd>Wait 30 seconds for the daemon job to end.
</dd>
<dt><b>*NOMAX</b></dt>
<dd>Wait forever for daemons to end; do not timeout.
</dd>
<dt><b><i>1-3600</i></b></dt>
<dd>Specify the number of seconds to wait for daemons to end before timing out and failing the command. Timeout values less than 30 seconds are rounded up to 30 seconds.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDNFSSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDNFSSVR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: End All Daemons</b>
</p>
<p>
<pre>
ENDNFSSVR SERVER(*ALL)
</pre>
</p>
<p>This command ends all NFS daemon jobs that are running.
</p>
<p><b>Example 2: End a Single Daemon</b>
</p>
<p>
<pre>
ENDNFSSVR SERVER(*MNT) ENDJOBTIMO(*NOMAX)
</pre>
</p>
<p>This command ends the NFS mount daemon, and waits forever for it to end. The mount daemon was previously running, and other daemons have been ended in the appropriate order.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDNFSSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDNFSSVR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPFA0B1</b></dt>
<dd>Requested operation not allowed. Access problem.
</dd>
<dt><b>CPFA1B8</b></dt>
<dd>*IOSYSCFG authority required to use &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDNFSSVR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>