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

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

For more information about Network File System commands, see Network File System book, SC41-5714

Restrictions:

  1. 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, *NETWARE, *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.

*NETWARE

The file system to be unmounted is a NetWare file system. When *NETWARE is specified, a directory must be specified for the MNTOVRDIR parameter.

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

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.

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

CPFA0A9

Object not found. Object is &1.

CPFA1B8

*IOSYSCFG authority required to use &1.

Top