Mount command syntax and examples

Use the TSO MOUNT command to make a connection between a mount point on your local file system and one or more files on a remote AIX, UNIX, , or other file system. The MOUNT command can only be used by a z/OS superuser.

Note: The same mount function can also be performed using the UNIX automount facility or /etc/rc shell scripts support. When the automount facility is used to manage remote NFS mount points, the NFS client user could experience ESTALE/EIO errors if the automounter unmounts the accessed mount point when the time limits specified by the automount DURATION and DELAY parameters have been exceeded. The automount default, DURATION=NOLIMIT, disables the DURATION timeout period. The DELAY for unmounting file systems should be longer than the time NFS clients are likely to keep NFS mounts to the files and directories active. For more information see z/OS UNIX System Services Command Reference.

Figure 1 illustrates the syntax of the TSO MOUNT command. For more information about the mount command, see z/OS UNIX System Services Command Reference.

Figure 1. TSO MOUNT command syntax operands

MOUNT FILESYSTEM(file_system_name)
      TYPE(NFS)
      MOUNTPOINT(local_mountpoint)
      MODE(RDWR|READ)
      PARM('hostname:"path_name,server_attributes", client_options')
      SETUID|NOSETUID
      TAG(TEXT,CCSID)
      WAIT|NOWAIT

where

FILESYSTEM(file_system_name)

Specifies the name of the file system to be added to the file system hierarchy. This operand is required. The file system name specified must be unique among previously mounted file systems. It may be an arbitrary name up to 44 characters in length of a filesystem. You can enclose file_system_name in single quotes, but they are not required.

TYPE(NFS)

Specifies the type of file system that performs the logical mount request. The NFS parameter must be used.

MOUNTPOINT(local_mountpoint)

Specifies the path name of the mount point directory, the place within the file hierarchy where the file system is to be mounted. The local_mountpoint specifies the mount point path name. The name can be a relative path name or an absolute path name. The relative path name is relative to the current working directory of the TSO/E session (usually the home directory). Therefore, you should usually specify an absolute path name. A path name is case-sensitive, so enter it exactly as it is to appear. Enclose the path name in single quotes.

Note: The mount point must be a directory. Any files in that directory are inaccessible while the file system is mounted. Only one file system can be mounted to a mount point at any time.

MODE(RDWR|READ)

Specifies the type of access for which the file system is to be opened.

RDWR specifies that the file system is to be mounted for read and write access. RDWR is the default option.

READ specifies that the file system is to be mounted for read-only access.

PARM('hostname:"path_name,server_attributes", client_attributes')

Specifies the hostname of the remote NFS server, the path name of the UNIX file or MVS data set to be mounted, the server attributes, and the client attributes.

See Initialization attributes for the z/OS NFS server for descriptions of the server attributes, including the mvsmnt processing attribute to be used with mount commands using the NFS version 4 protocol. The "client_attributes" used on the PARM parameter are the same as the NFS client attributes, although some attributes cannot be used on the mount. See Table 1 for a list of the parameters that can be used to specify client attributes on the MOUNT command.

path_name and server attributes are delimited with double quotes. path_name and server attributes are not parsed for validity by the z/OS NFS client. path_name is defined as the characters between the first double quote and the first comma before the server attributes. server attributes is defined as the characters between the first comma after the path_name and the second double quote.

If the path_name has no colon and if no server attributes are specified then the double quotes can be omitted. Enclose the entire string in single quotes. path_name is defined as the characters between the colon after the hostname and the first comma before the client_attributes. Any syntax errors that occur after the colon and before the first comma can cause the mount to fail. If the automount facility is being used, the single quotes should not be specified.

SETUID|NOSETUID

See z/OS UNIX System Services Command Reference for details about SETUID and NOSETUID.

TAG(TEXT,CCSID)

See z/OS UNIX System Services Command Reference for details about the TAG keyword.

Note: When TAG is specified, xlat(Y) must not be specified; otherwise, mount will fail.

WAIT|NOWAIT

See z/OS UNIX System Services Command Reference for details on WAIT and NOWAIT.