You can use the delete z/OS UNIX zFS Filesystem operation to delete an existing zFS
filesystem. Access Method Services are used to delete the filesystem linear data set. The file
system must not be allocated (attached or mounted) for this operation to succeed.
/zosmf/restfiles specifies the z/OS® data set and file REST interface
/mfs/zfs a UNIX System Services filesystem request for a zFS aggregate.
<file-system-name> is the filesystem (for zFS, the aggregate name) of the
file system to be deleted. This is also the VSAM linear data set name.
Custom headers
X-IBM-Target-System = <string>
This header indicates the target system name (nick name) for this request, where the system name
(nick name) is defined in the local system Systems table. The target host system must support
single-sign-on by using either an LTPA token or a valid X-IBM-Target-System-User
and X-IBM-Target-System-Password is provided for the target system. If the target
system is the local system, this header is ignored and has no effect.
X-IBM-Target-System-User
This header indicates the z/OS user ID that allows the user to access the target system. If the
X-IBM-Target-System header is not supplied, this header is ignored. Both
X-IBM-Target-System-Password and X-IBM-Target-System-User must be
provided together; otherwise, this header is ignored.
If this header is not provided in the
current request, the current request uses the authenticated user credentials to access the target
system if either of the following conditions are true:
The X-IBM-Target-System-User header was provided in a previous request
This header indicates the password that is associated with the z/OS user ID. If the
X-IBM-Target-System header is not supplied, this header is ignored. Both
X-IBM-Target-System-Password and X-IBM-Target-System-User must be
provided together; otherwise, this header is ignored.
On completion, the service returns an HTTP response, which includes a status code indicating
whether your request completed. Status code 200 OK indicates success. Status code
204 indicates success. A status code of 4nn or
5nn indicates that an error has occurred. For more details, see Error handling.
For errors, the HTTP response includes error information as a JSON error report document. See
Error report document.
Example
Refer to Figure 1
for an example of deleting UNIX Filesystems.Figure 1. Delete UNIX Filesystems
request:
DELETE https://zosmf1.yourco.com/zosmf/restfiles/mfs/zfs/HLQ.MYNEW.ZFS HTTP/1.1
response:
204 No Content
X-IBM-Target-System = <string>