Mount a UNIX file system

You can use this operation to mount a UNIX file system on a specified directory.

HTTP method and URI path

PUT /zosmf/restfiles/mfs/<file-system-name>

where:

/zosmf/restfiles specifies the z/OS® data set and file REST interface
/mfsis used for managing file systems.
<file-system-name> is the file system that you want to mount.

Request Body

The request body to mount a UNIX file system is shown in Request body to mount a UNIX file system.

Table 1. Request body to mount a UNIX file system
Field	Type	Description
action	String	Mount: you are going to mount an UNIX file system on the specified directory.
mount-point	String	Specifies the mount point you will be using to mount. It is usually a directory.
fs-type	String	Specifies the file system type that you are going to mount. The name must match the TYPE operand on a FILESYSTYPE statement in the BPXPRMxx parmlib member for the file system.
mode	String	Specifies the mode you intend to mount to the file system: Support Value: rdonly: read only rdwr: read write --all the values are case insensitive Default value: rdonly

Standard headers

None.

Custom headers

None.

Query parameters

None.

Content type

The content type is application/json.

Required authorizations

See Required authorizations.

Usage considerations

See Usage considerations for the z/OSMF REST services.

Expected response

On completion, the service returns an HTTP response, which includes a status code indicating whether your request completed. Status code 200 indicates success. A status code of 4nn or 5nn indicates that an error has occurred. For more details, see Error handling.

If the request is successfully executed, status code 204 indicates success and no content is returned.

Example request

In the following example, the PUT method is used to mount a UNIX file system.

PUT /zosmf/restfiles/mfs/JIAHJ.ZOSMF.DRIVER.HFS HTTP/1.1

Request body

{"action":"mount","mount-point":"/u/jiahj","fs-type":"HFS","mode":"rdonly"}

Example response

A sample response is shown in Figure 1.

Figure 1. Example: Mount a UNIX file system

204 No Content
Content-Type:  application/json; charset=UTF-8
Content-Length:  0
Date:  Thu, 17 Sep 2015 08:05:41 GMT