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

258 lines
9.9 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>Start NFS Server (STRNFSSVR)</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="STRNFSSVR.Top_Of_Page"></a>
<h2>Start NFS Server (STRNFSSVR)</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="#STRNFSSVR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#STRNFSSVR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#STRNFSSVR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="STRNFSSVR"></a>
<p>The Start Network File System Server (STRNFSSVR) command starts one or all of the following Network File System (NFS) server daemons. For more information about these daemon jobs, see Network File System book, SC41-5714
</p>
<p>SERVER(*ALL) should be used, which will start the daemons in the following order. (This order is the recommended order for starting the Network File System daemons.)
</p>
<ul>
<li>The Remote Procedure Call (RPC) RPCBind daemon
</li>
<li>The block input/output (I/O) (BIO) daemon
</li>
<li>The server (SVR) daemon
</li>
<li>The mount (MNT) daemon
</li>
<li>The network status monitor (NSM) daemon
</li>
<li>The network lock manager (NLM) daemon
</li>
</ul>
<p>If just one daemon is to be started, be sure the appropriate order for starting NFS daemons and the possible consequences of starting daemons in an order other than that specified above are understood. For more information about starting NFS daemons, see Network File System book, SC41-5714
</p>
<p>If the user attempts to start a daemon or daemons that are already running, they will not cause the command to fail, and it will continue to start other daemons that were requested to start. The command will issue diagnostic message CPDA1BA or CPDA1BD if the daemon is already running. However, for best results, end NFS daemons before attempting the STRNFSSVR command.
</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 NFS 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 be enrolled in the system distribution directory. Use the Add Directory Entry (ADDDIRE) command to enroll the user.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRNFSSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRNFSSVR.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="#STRNFSSVR.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="#STRNFSSVR.NBRSVR"><b>NBRSVR</b></a></td>
<td valign="top">Number of server daemons</td>
<td valign="top">1-20, <b><u>1</u></b></td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#STRNFSSVR.NBRBIO"><b>NBRBIO</b></a></td>
<td valign="top">Number of block I/O daemons</td>
<td valign="top">1-20, <b><u>1</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRNFSSVR.RTVRPCREG"><b>RTVRPCREG</b></a></td>
<td valign="top">Retrieve RPC registration</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRNFSSVR.STRJOBTIMO"><b>STRJOBTIMO</b></a></td>
<td valign="top">Timeout for start of daemon</td>
<td valign="top">1-3600, <b><u>30</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#STRNFSSVR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="STRNFSSVR.SERVER"></a>
<h3>Server daemon (SERVER)</h3>
<p>Specifies the Network File System (NFS) daemon jobs to be started by this command. The specified daemon should not already be running.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All NFS daemons will be started.
</dd>
<dt><b>*RPC</b></dt>
<dd>The NFS RPCBind daemon will be started.
</dd>
<dt><b>*BIO</b></dt>
<dd>Starts NFS block input/output (I/O) daemons. Additional daemons will be started if the number specified on the <b>Number of block I/O daemons (NBRBIO)</b> parameter is greater than the number of block I/O daemons already running on the system.
</dd>
<dt><b>*SVR</b></dt>
<dd>Starts NFS server daemons. Additional daemons will be started if the number specified on the <b>Number of server daemons (NBRSVR)</b> parameter is greater than the number of server daemons already running on the system.
</dd>
<dt><b>*MNT</b></dt>
<dd>The NFS mount daemon will be started.
</dd>
<dt><b>*NSM</b></dt>
<dd>The NFS network status monitor daemon will be started.
</dd>
<dt><b>*NLM</b></dt>
<dd>The NFS network lock manager daemon will be started.
</dd>
</dl>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRNFSSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRNFSSVR.NBRSVR"></a>
<h3>Number of server daemons (NBRSVR)</h3>
<p>Specifies the number of NFS server (*SVR) daemon jobs the user wants to have running. Additional daemons will be started if the number specified on this parameter is greater than the number of server daemons already running on the system. This parameter can only be used if SERVER(*SVR) or SERVER(*ALL) is specified.
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>One NFS server daemon job should be started if there are not already any NFS server daemons running.
</dd>
<dt><b><i>1-20</i></b></dt>
<dd>Specify the number of NFS server daemon jobs the user wants to have running.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRNFSSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRNFSSVR.NBRBIO"></a>
<h3>Number of block I/O daemons (NBRBIO)</h3>
<p>Specifies the number of NFS block input/output (I/O) (*BIO) daemon jobs the user wants to have running. Additional daemons will be started if the number specified on this parameter is greater than the number of block I/O daemons already running on the system. This parameter can only be used if SERVER(*BIO) or SERVER(*ALL) is specified.
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>One NFS block I/O daemon job should be started if there are not already any NFS block I/O daemons running.
</dd>
<dt><b><i>1-20</i></b></dt>
<dd>Specify the number of NFS block I/O daemon jobs the user wants to have running.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRNFSSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRNFSSVR.RTVRPCREG"></a>
<h3>Retrieve RPC registration (RTVRPCREG)</h3>
<p>Specifies whether to retrieve previously recorded registration information when the RPCBind daemon is started. If registration information is retrieved, any services already registered with the RPCBind daemon do not have to re-register with the RPCBind daemon. This parameter can only be used if SERVER(*RPC) or (SERVER(*ALL) is specified.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Do not retrieve registration information.
</dd>
<dt><b>*YES</b></dt>
<dd>Retrieve registration information.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRNFSSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRNFSSVR.STRJOBTIMO"></a>
<h3>Timeout for start of daemon (STRJOBTIMO)</h3>
<p>Specifies the number of seconds to wait for each daemon to successfully start. If a daemon has not started within the timeout value, the command will fail.
</p>
<dl>
<dt><b><u>30</u></b></dt>
<dd>Default seconds before timeout.
</dd>
<dt><b>*NOMAX</b></dt>
<dd>Wait forever for daemons to start; do not timeout.
</dd>
<dt><b><i>1-3600</i></b></dt>
<dd>Specify a number of seconds to wait for daemons to start 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="#STRNFSSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRNFSSVR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Start All NFS Daemons</b>
</p>
<p>
<pre>
STRNFSSVR SERVER(*ALL) STRJOBTIMO(*NOMAX)
</pre>
</p>
<p>This command starts all NFS daemons, and waits forever for them to start. No daemons should be previously running.
</p>
<p><b>Example 2: Start Only One Daemon</b>
</p>
<p>
<pre>
STRNFSSVR SERVER(*MNT)
</pre>
</p>
<p>This command starts the NFS mount daemon, and waits up to the default of 30 seconds for it to start. The mount daemon should not be already running, and other daemons have been started in the appropriate order.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRNFSSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRNFSSVR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<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="#STRNFSSVR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>