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

173 lines
6.5 KiB
HTML
Raw 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>Remove Mounted FS (RMVMFS)</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="RMVMFS.Top_Of_Page"></a>
<h2>Remove Mounted FS (RMVMFS)</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="#RMVMFS.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVMFS.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVMFS.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVMFS"></a>
<p>The Remove Mounted File System (RMVMFS) command will make a previously mounted file system inaccessible within the integrated file system name space. The file system to be made inaccessible can be a user-defined file system (*UDFS) on the local system, a remote file system accessed through a Network File System server (*NFS), or a local or remote NetWare file system (*NETWARE). If any of the objects in the file system are in use, the command will return an error message to the user. Note that if any part of the file system has itself been mounted over, then this file system cannot be unmounted until it is uncovered.
</p>
<p>This command can also be issued using the following alternative command name:
</p>
<ul>
<li>UNMOUNT
</li>
</ul>
<p>For more information about Network File System commands, see Network File System book, SC41-5714
</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>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVMFS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVMFS.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="#RMVMFS.TYPE"><b>TYPE</b></a></td>
<td valign="top">Type of file system</td>
<td valign="top">*NFS, *UDFS, *NETWARE, *ALL</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#RMVMFS.MNTOVRDIR"><b>MNTOVRDIR</b></a></td>
<td valign="top">Directory mounted over</td>
<td valign="top"><i>Path name</i>, *ALL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RMVMFS.MFS"><b>MFS</b></a></td>
<td valign="top">Mounted file system</td>
<td valign="top"><i>Path name</i></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RMVMFS.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVMFS.TYPE"></a>
<h3>Type of file system (TYPE)</h3>
<p>Specifies the type of file system to be unmounted.
</p>
<dl>
<dt><b>*NFS</b></dt>
<dd>The file system to be unmounted is a Network File System. When *NFS is specified, a directory must be specified for the <b>Directory mounted over (MNTOVRDIR)</b> parameter.
</dd>
<dt><b>*UDFS</b></dt>
<dd>The file system to be unmounted is a user-defined file system. When *UDFS is specified, either the MNTOVRDIR or the <b>Mounted file system (MFS)</b> parameter may be specified.
</dd>
<dt><b>*NETWARE</b></dt>
<dd>The file system to be unmounted is a NetWare file system. When *NETWARE is specified, a directory must be specified for the MNTOVRDIR parameter.
</dd>
<dt><b>*ALL</b></dt>
<dd>File systems of all types are to be unmounted. If *ALL is specified, a value must be specified for the MNTOVRDIR parameter, and that value may be *ALL.
</dd>
</dl>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVMFS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVMFS.MNTOVRDIR"></a>
<h3>Directory mounted over (MNTOVRDIR)</h3>
<p>Specifies the path name of the directory that was mounted over ('covered') by a previous ADDMFS (Add Mounted File System) or MOUNT command.
</p>
<dl>
<dt><b><i>'directory-path-name'</i></b></dt>
<dd>The specified directory that was previously mounted over will be uncovered. If TYPE(*ALL) was specified, all file systems mounted over the specified directory will be unmounted. If a specific file system type was specified for the <b>Type of file system (TYPE)</b> parameter, the file system mounted most recently over the specified directory will be unmounted only if it matches the specified TYPE value.
</dd>
<dt><b>*ALL</b></dt>
<dd>All directories that were previously mounted over will be uncovered. If *ALL is specified, *ALL must be specified for the TYPE parameter.
</dd>
</dl>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVMFS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVMFS.MFS"></a>
<h3>Mounted file system (MFS)</h3>
<p>Specifies the path name of the file system to be unmounted. This parameter can only be used to unmount a Block Special File (*BLKSF), when *UDFS is specified for the <b>Type of file system (TYPE)</b> parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVMFS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVMFS.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Unmounting a Directory</b>
</p>
<p>
<pre>
RMVMFS TYPE (*NFS) MNTOVRDIR('/tools')
</pre>
</p>
<p>This command unmounts a Network File System that is accessible on directory <i>/tools</i>.
</p>
<p><b>Example 2: Unmounting a User-Defined File System</b>
</p>
<p>
<pre>
RMVMFS TYPE(*UDFS) MFS('/DEV/QASP02/CUST1UDFS')
</pre>
</p>
<p>This command unmounts the user-defined file system <i>/dev/qasp02/custudfs</i>.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVMFS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVMFS.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPFA0A9</b></dt>
<dd>Object not found. Object is &amp;1.
</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="#RMVMFS.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>