The Remove Mounted File System (UNMOUNT) command will make a previously mounted file 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:

• RMVMFS

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.

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.

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.

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.

Examples

The alternative command name for UNMOUNT is RMVMFS. The following examples use the alternative command name, but UNMOUNT can be replaced directly for RMVMFS in all of them.

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.

Error messages

*ESCAPE Messages

CPFA0A9

Object not found. Object is &1.

CPFA1B8

*IOSYSCFG authority required to use &1.