z/OS Network File System Guide and Reference Version 2 Release 2 SC23-6883-01 This edition applies to Version 2 Release 2 of z/OS® (5650-ZOS) and to all subsequent releases and modifications until otherwise indicated in new editions. This edition replaces SC23-6883-00. © Copyright IBM Corporation 1991, 2015. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. © Copyright IBM Corp. 1991, 2015 iii iv z/OS V2R2 Network File System Guide and Reference Contents Figures ...............xi Tested servers for the z/OS NFS client .....16 || z/OS NFS client restrictions ........17 Tables ...............xiii WebNFS support ............17 NFS versions with TCP/IP protocols ......18 Internet Protocol version 6 .........19 About this document ........xvii User-specified port range support .......20 Required product knowledge ........xvii Dynamic addressing ...........20 Where to find more information .......xvii 64-bit exploitation ............21 Access to documents ..........xvii Data transfer and conversion ........21 z/OS information ..........xviii Native ASCII support ..........21 Access to softcopy documents on CD-ROM and DVD collections and the Internet ......xix Chapter 2. Creating z/OS conventional How to look up message explanations with LookAt ..............xix MVS data sets ...........23 How to read syntax diagrams ........xx Overriding data set creation attributes .....23 Related protocol specifications .......xxii Preparing to create an MVS file........23 The z/OS Basic Skills Information Center . xxiii Naming MVS files ...........24 Creating physical sequential files .......24 How to send your comments to IBM xxv Creating direct access files .........25 Creating PDSs and PDSEs .........26 If you have a technical problem .......xxv Creating a PDS or PDSE - mkdir dsntype(pds), If you have a technical problem .......xxv dsntype(library) ............26 Removing a PDS or PDSE - rm, rmdir ....26 Summary of changes .......xxvii Accessing PDS or PDSE members ......27 Summary of changes for SC23-6883-00 ....xxviii Updating or extending a PDS or PDSE member 27 Timing out while writing a PDS or PDSE Part 1. Using z/OS Network File member ..............27 System...............1 Wildcard copy to a PDS or PDSE ......27 Limitations of a PDS ..........28 Concurrent writes to a PDSE .......28 Chapter 1. Introduction ........3 ISPF extended statistics support for PDS or PDSE Overview ...............3 members ..............28 z/OS UNIX files .............4 Creating VSAM files ...........28 z/OS UNIX advantages..........4 Exploiting SAM striped files.........30 NFS protocol compliance .........5 Exploiting large format data sets .......30 Crossing between file systems–NFS server . 5 Exploiting data sets on extended address volumes 30 z/OS conventional MVS data sets .......5 Mounting MVS data sets onto a client mount Chapter 3. Using z/OS conventional point ................5 MVS data sets ...........31 Creating z/OS conventional MVS data sets . 6 Special MVS considerations .........31 Serializing and sharing data sets.......6 Selection of an MVS data storage format . 31 NFS version 2 and version 3 statelessness.....7 File size determination and time stamps ....32 NFS version 4 state ............7 Ownership and permissions ........32 Name space and file system management.....8 File reading and writing .........33 z/OS NFS File System Type Selection ......9 Case sensitivity–maplower, nomaplower....34 Specifying the path type prefix and the Selection of text or binary processing modes–text, customer-configurable path resolution heuristic. 9 binary ...............34 Implicit prefix support restrictions ......11 MVS prefix support ..........36 Server control files ............13 Number representation .........36 Attributes data set ...........13 Partial record identification ........37 Exports data set ............13 Access to migrated files–retrieve, noretrieve; wait, Mount handle data set..........14 nowait ...............39 Log data set .............14 Access to migrated system-managed data sets . 39 Tested clients for the z/OS NFS server .....14 File handle refresh ...........40 NFS protocol attributes for the z/OS NFS server 15 Mapping between the workstation and MVS file z/OS NFS server restrictions .......15 systems................40 © Copyright IBM Corp. 1991, 2015 v File extension mapping .........40 Quick reference of AIX and UNIX commands . 69 Mounting of MVS data sets onto a client mount Accessing z/OS UNIX file systems and z/OS point ...............41 conventional MVS files ..........69 Use of a PDS or PDSE as a directory .....44 Mvslogin command examples .......70 Use of multiple mount points .......44 Mount command examples using an MVS prefix 72 Data set serialization and sharing ......45 Mount command example: overriding server NFS protocol .............45 default attributes without an MVS prefix . 73 NFS file system attributes ........45 Displaying default and mount point attributes - Delegating management of a file's resources to an showattr ...............74 NFS client ...............46 Unmounting and logging out of z/OS .....78 Disconnecting your mount point - umount . 78 Chapter 4. Using z/OS UNIX System Ending your z/OS session - mvslogout ....79 Services files ............49 z/OS UNIX file system ..........49 Chapter 7. Commands and examples POSIX compatibility ...........50 for z/OS NFS clients .........81 NFS protocol ..............51 Using commands on the z/OS NFS client ....81 Attributes specific to z/OS UNIX System Services 51 Accessing z/OS ............88 Synchronous write to a z/OS UNIX file for NFS Mvslogin command examples .......88 version 2 protocol ...........51 Mount command syntax and examples ....89 Synchronous write to a z/OS UNIX file for NFS Unmount command syntax and examples . 98 version 3 or 4 protocol..........51 Displaying client and server statistical Authorization checking when writing to a z/OS information–nfsstat ...........99 UNIX file ..............52 Displaying server mount HFSPREFIX site attribute .........52 information–showmount ........104 Protecting your z/OS UNIX System Services files . 52 Displaying default and mount point Accessing z/OS UNIX files from a client ....53 attributes–showattr ..........105 Mount examples............53 Ending your z/OS session - mvslogout....107 z/OS UNIX data transfer and conversion ....54 Data transfer under the NFS version 4 protocol 54 Chapter 8. Initialization attributes for Text or binary processing - NFS version 2 and 3 the z/OS NFS client .........109 protocols ..............54 Client attribute syntax ..........109 Linking an MVS data set to a z/OS UNIX file Datacaching attribute ...........116 system ................55 Mount processing parameters and installation Creating an external link .........55 parameters ..............117 Displaying the contents on an external link . 56 NFS client translation support ........118 Deleting an external link .........56 z/OS NFS client with z/OS NFS server ....119 Accessing symbolic links on z/OS NFS version 4 . 56 UNIX look and feel............58 NFS file system attributes .........58 Chapter 9. Initialization attributes for Displaying and modifying remote file system access the z/OS NFS server ........121 control lists ..............58 Attributes used for z/OS UNIX file access....121 Remote ACL management restrictions: ....59 Multipliers ..............122 Duplicate attributes ...........122 Chapter 5. z/OS NFS file locking and Data set creation attributes syntax ......122 access control ...........61 Processing attributes syntax ........127 Timeout attributes ...........135 Locking in NFS versions 2 and 3 (NFS server only) 61 Retrieve attributes ...........136 Using Network Lock Manager (NLM) in NFS V2 Mapped keyword processing attribute ....136 andV3...............61 Native ASCII processing attributes .....137 Using Network Status Monitor (NSM) in NFS V2 Site attributes syntax ...........139 andV3...............62 Locking in NFS version 4..........63 Byte-range locking ...........63 Part 2. Customization and Share reservations ...........63 Operations ............159 Specifying a grace period for reclaiming locks . 63 Listing locks held for a file ........64 Chapter 10. Customization......161 Releasing locks held for a file .......64 Protecting your programs and files ......161 Protecting the server control files ......161 Chapter 6. Commands and examples Setting up the z/OS NFS authorization....162 for AIX and UNIX clients .......65 Protecting the file system on z/OS with the NFS Using commands on AIX ..........65 V4 protocol .............163 vi z/OS V2R2 Network File System Guide and Reference Protecting the file system on z/OS with the Addds operand............236 Security site attribute ..........167 bufferusage operand ..........236 Customizing installation security exits ....172 bufhigh operand ...........236 Using UNIX style credentials for authentication 172 Cbsniff operand ...........237 Converting data ............173 || CONSOLEMSGS operand ........238 Creating the conversion environment for Unicode DlyDTimeout operand .........238 Services ...............174 Exportfs operand ...........238 Collecting NFS usage data .........175 Freeds operand............239 Configuring the z/OS NFS client .......176 Freeze operand ............239 Creating the PARMLIB statement for the client 176 || ID2NAME operand ..........240 Updating z/OS system data sets for the client 176 List operand.............240 Allocating client log data sets .......177