RMVMFS (Remove Mounted File System)

RMVMFS Command syntax diagram

 

Purpose

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 via 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.

This command can also be issued using the following alternative command name:

• UNMOUNT

For more information about Network File System commands, see OS/400 Network File System Support book.

 

Restrictions

1. You must have *IOSYSCFG special authority to use this command.

 

Required Parameters

TYPE

Specifies the type of file system being unmounted.

*NFS: The file system being unmounted is a Network File System. When *NFS is specified, specify a directory for the MNTOVRDIR parameter.

*UDFS: The file system being unmounted is a user-defined file system. When *UDFS is specified, you may specify either the MNTOVRDIR or the MFS parameter.

*NETWARE: The file system being unmounted is a NetWare file system. When *NETWARE is specified, specify a directory for the MNTOVRDIR parameter.

*ALL: File systems of all types are to be unmounted. If you specify *ALL, specify a value for the MNTOVRDIR parameter, and you may choose the value *ALL for its value.

 

Optional Parameters

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 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 you specify *ALL, specify *ALL for the TYPE parameter.

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 parameter.

Examples for RMVMFS

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 an User Defined File System

RMVMFS   TYPE(*UDFS)  MFS('/DEV/QASP02/CUST1UDFS')

This command unmounts the user defined file system /dev/qasp02/custudfs.

Error messages for RMVMFS

None