Remove Mounted FS (RMVMFS)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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 or a remote file system accessed through a Network File System server (*NFS). 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.
This command can also be issued using the following alternative command name:
- UNMOUNT
For more information about Network File System commands, see i5/OS Network File System Support book, SC41-5714
Restrictions:
- The user must have input/output (I/O) system configuration (*IOSYSCFG) special authority to use this command.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| TYPE | Type of file system | *NFS, *UDFS, *ALL | Required, Positional 1 |
| MNTOVRDIR | Directory mounted over | Path name, *ALL | Optional |
| MFS | Mounted file system | Path name | Optional |
| Top |
Type of file system (TYPE)
Specifies the type of file system to be unmounted.
- *NFS
- The file system to be unmounted is a Network File System. When *NFS is specified, a directory must be specified for the Directory mounted over (MNTOVRDIR) parameter.
- *UDFS
- The file system to be unmounted is a user-defined file system. When *UDFS is specified, either the MNTOVRDIR or the Mounted file system (MFS) parameter may be specified.
- *ALL
- 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.
This is a required parameter.
| Top |
Directory mounted over (MNTOVRDIR)
Specifies the path name of the directory that was mounted over ('covered') by a previous ADDMFS (Add Mounted File System) or MOUNT command.
- 'directory-path-name'
- 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 Type of file system (TYPE) parameter, the file system mounted most recently over the specified directory will be unmounted only if it matches the specified TYPE value.
- *ALL
- All directories that were previously mounted over will be uncovered. If *ALL is specified, *ALL must be specified for the TYPE parameter.
This is a required parameter.
Note: This parameter is Unicode-enabled. See "Unicode support in CL" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/ for additional information.
| Top |
Mounted file system (MFS)
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 Type of file system (TYPE) parameter.
Note: This parameter is Unicode-enabled. See "Unicode support in CL" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/ for additional information.
| Top |
Examples
Example 1: Unmounting a Directory
RMVMFS TYPE (*NFS) MNTOVRDIR('/tools')
This command unmounts a Network File System that is accessible on directory /tools.
Example 2: Unmounting a User-Defined File System
RMVMFS TYPE(*UDFS) MFS('/DEV/QASP02/CUST1UDFS')
This command unmounts the user-defined file system /dev/qasp02/custudfs.
| Top |
Error messages
*ESCAPE Messages
- CPFA09E
- Object in use. Object is &1.
- CPFA0A9
- Object not found. Object is &1.
- CPFA1B8
- *IOSYSCFG authority required to use &1.
| Top |