z/OS Version 2 Release 3 Distributed File Service zFS Administration IBM SC23-6887-30 Note Before using this information and the product it supports, read the information in “Notices” on page 469. This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and to all subsequent releases and modifications until otherwise indicated in new editions. Last updated: 2019-03-28 © Copyright International Business Machines Corporation 2001, 2019. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents List of Figures....................................................................................................... ix List of Tables........................................................................................................ xi About this document...........................................................................................xiii How this document is organized............................................................................................................... xiii Conventions used in this document ......................................................................................................... xiii z/OS information........................................................................................................................................xiv References to DFS information................................................................................................................. xiv How to send your comments to IBM......................................................................xv If you have a technical problem.................................................................................................................xv Summary of changes...........................................................................................xvi Summary of changes for zFS for z/OS Version 2 Release 3 (V2R3) ........................................................ xvi Summary of changes for zFS for z/OS Version 2 Release 2 (V2R2)..........................................................xx z/OS Version 2 Release 1 summary of changes.......................................................................................xxii Part 1. zFS administration guide............................................................................ 1 Chapter 1. Overview of the zFS File System................................................................................................3 Features.................................................................................................................................................. 3 Terminology and concepts..................................................................................................................... 4 What's new or changed for zFS in z/OS V2R3........................................................................................7 What's new or changed for zFS in z/OS V2R2........................................................................................7 What's new or changed for zFS in z/OS V2R1........................................................................................8 Chapter 2. Installing and configuring zFS................................................................................................. 11 zFS installation and configuration steps..............................................................................................11 Applying required APARs for z/OS V2R3............................................................................................. 14 Specifying zFS file systems as sysplex-aware.....................................................................................14 Using zFS read/write sysplex-aware file systems..........................................................................15 Changing the sysplex-awareness of a mounted zFS read/write file system.................................16 zFS running in the z/OS UNIX address space......................................................................................16 Chapter 3. Managing zFS processes..........................................................................................................19 Starting zFS...........................................................................................................................................19 Stopping zFS.........................................................................................................................................19 Determining zFS status...................................................................................................................20 Chapter 4. Creating and managing zFS file systems using compatibility mode aggregates................... 21 Creating a compatibility mode aggregate............................................................................................21 Using version 1.5 aggregates and extended (v5) directories..............................................................23 Creating a version 1.5 aggregate....................................................................................................23 Converting an existing aggregate to version 1.5............................................................................24 Converting an existing v4 directory to an extended (v5) directory............................................... 25 Guidelines for v4 to v5 conversion................................................................................................. 25 Growing a compatibility mode aggregate............................................................................................26 Dynamically growing a compatibility mode aggregate........................................................................26 Creating a multi-volume compatibility mode aggregate.....................................................................27 Adding volumes to a compatibility mode aggregate........................................................................... 29 Increasing the size of a compatibility mode aggregate...................................................................... 29 Copying each file and directory of the aggregate to a larger data set...........................................30 iii Copying the physical blocks of the aggregate to a larger data set................................................ 31 Encrypting and compressing zFS file system data.............................................................................. 32 The encryption process.................................................................................................................. 33 The compression process...............................................................................................................36 Decreasing the size of a compatibility mode aggregate......................................................................39 Renaming or deleting a compatibility mode aggregate.......................................................................40 Changing zFS attributes on a mounted zFS compatibility mode file system......................................41 Unmounting zFS file systems before copying or moving.................................................................... 42 Understanding zFS disk space allocation............................................................................................ 43 How data is stored on systems before z/OS V1R13...................................................................... 44 Support for type 30 SMF record .................................................................................................... 46 Sharing zFS data in a non-shared file system sysplex........................................................................ 46 Minimum and maximum file system sizes...........................................................................................46 Version 1.5 aggregates................................................................................................................... 47 Version 1.4 aggregates................................................................................................................... 47 v4 directory considerations............................................................................................................48 Chapter 5. Using zFS in a shared file system environment.......................................................................49 Overview of the shared file system environment................................................................................ 49 Read-only mounted file systems......................................................................................................... 49 zFS support for read/write file systems with different levels of sysplex-awareness.........................50 zFS-enhanced sysplex-aware support................................................................................................ 51 zFS ownership versus z/OS UNIX ownership of file systems..............................................................51 Determining the file system owner................................................................................................ 52 When is the z/OS UNIX owner important?...........................................................................................53 Dynamic movement of the zFS owner................................................................................................. 54 Considerations