z/OSVersion 2 Release 4

Network File SystemGuide and Reference

IBM

SC23-6883-40

Note

Before using this information and the product it supports, read the information in “Notices” on page619.

This edition applies to Version 2 Release 4 of z/OS (5650-ZOS) and to all subsequent releases and modifications untilotherwise indicated in new editions.

Last updated: 2020-06-23© Copyright International Business Machines Corporation 1991, 2020.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract withIBM Corp.

Contents

Figures............................................................................................................... xiii

Tables............................................................................................................... xvii

About this document...........................................................................................xxiRequired product knowledge.................................................................................................................... xxiWhere to find more information................................................................................................................ xxi

Access to documents...........................................................................................................................xxiHow to read syntax diagrams..................................................................................................................xxiiiRelated protocol specifications...............................................................................................................xxivz/OS Basic Skills in IBM Knowledge Center.............................................................................................xxv

How to send your comments to IBM.................................................................. xxviiIf you have a technical problem............................................................................................................. xxvii

Summary of changes ........................................................................................ xxixSummary of changes for SC23-6883-40................................................................................................xxix

General changes.................................................................................................................................xxixMessage changes............................................................................................................................... xxix

Summary of changes for SC23-6883-02 ................................................................................................ xxxGeneral changes..................................................................................................................................xxxMessage changes................................................................................................................................ xxx

Summary of changes for z/OS Version 2 Release 2 (V2R2) as updated December 2015.................... xxxi

Part 1. Using z/OS Network File System................................................................. 1

Chapter 1. Introduction............................................................................................................................... 3Overview................................................................................................................................................. 3Networking..............................................................................................................................................3

INET...................................................................................................................................................4CINET................................................................................................................................................ 8

z/OS UNIX files..................................................................................................................................... 10z/OS UNIX advantages....................................................................................................................11NFS protocol compliance............................................................................................................... 11Crossing between file systems–NFS server...................................................................................11

z/OS conventional MVS data sets........................................................................................................ 11Mounting MVS data sets onto a client mount point....................................................................... 12Creating z/OS conventional MVS data sets.................................................................................... 12Serializing and sharing data sets....................................................................................................12

NFS version 2 and version 3 statelessness......................................................................................... 13NFS version 4 state.............................................................................................................................. 13Name space and file system management......................................................................................... 14z/OS NFS File System Type Selection..................................................................................................14

Specifying the path type prefix and the customer-configurable path resolution heuristic..........15Implicit prefix support restrictions................................................................................................ 17

Server control files............................................................................................................................... 18Attributes data set.......................................................................................................................... 18Exports data set.............................................................................................................................. 19Mount handle data set.................................................................................................................... 19

iii

Log data set.....................................................................................................................................19Tested clients for the z/OS NFS server................................................................................................19

NFS protocol attributes for the z/OS NFS server........................................................................... 20z/OS NFS server restrictions...........................................................................................................20

Tested servers for the z/OS NFS client................................................................................................21z/OS NFS client restrictions............................................................................................................22

WebNFS support.................................................................................................................................. 22NFS versions with TCP/IP protocols ................................................................................................... 23Internet Protocol version 6.................................................................................................................. 24User-specified port range support.......................................................................................................25Dynamic addressing............................................................................................................................. 2564-bit exploitation................................................................................................................................25Data transfer and conversion...............................................................................................................26

Native ASCII support...................................................................................................................... 26NFS Error Client Loop Detection Facility..............................................................................................26

Chapter 2. Creating z/OS conventional MVS data sets............................................................................. 27Overriding data set creation attributes................................................................................................27Creating or exploiting encrypted Physical Sequential or VSAM data sets..........................................27Preparing to create an MVS file............................................................................................................28

Naming MVS files............................................................................................................................ 28Creating physical sequential files........................................................................................................ 29Creating direct access files.................................................................................................................. 29Creating PDSs and PDSEs.................................................................................................................... 30

Creating a PDS or PDSE - mkdir dsntype(pds), dsntype(library)...................................................30Removing a PDS or PDSE - rm, rmdir............................................................................................. 31Accessing PDS or PDSE members..................................................................................................31Updating or extending a PDS or PDSE member.............................................................................31Timing out while writing a PDS or PDSE member.......................................................................... 32Wildcard copy to a PDS or PDSE.....................................................................................................32Limitations of a PDS........................................................................................................................32Concurrent writes to a PDSE.......................................................................................................... 32ISPF extended statistics support for PDS or PDSE members....................................................... 32

Creating VSAM files.............................................................................................................................. 33Exploiting SAM striped files................................................................................................................. 34Exploiting large format data sets.........................................................................................................34Exploiting data sets on extended address volumes............................................................................34Exploiting compressed format data sets.............................................................................................34

Chapter 3. Using z/OS conventional MVS data sets..................................................................................35Special MVS considerations.................................................................................................................35

Selection of an MVS data storage format.......................................................................................35File size determination and time stamps.......................................................................................36Ownership and permissions........................................................................................................... 36File reading and writing.................................................................................................................. 36Case sensitivity–maplower, nomaplower......................................................................................38Selection of text or binary processing modes–text, binary...........................................................38MVS prefix support......................................................................................................................... 39Number representation.................................................................................................................. 40Partial record identification............................................................................................................ 40Access to migrated files–retrieve, noretrieve; wait, nowait..........................................................41Access to migrated system-managed data sets............................................................................42File handle refresh.......................................................................................................................... 42

Mapping between the workstation and MVS file systems ..................................................................42File extension mapping...................................................................................................................43Mounting of MVS data sets onto a client mount point...................................................................43Use of a PDS or PDSE as a directory...............................................................................................46Use of multiple mount points......................................................................................................... 46

iv

Data set serialization and sharing.................................................................................................. 47NFS protocol................................................................................................................................... 47NFS file system attributes.............................................................................................................. 47

Delegating management of a file's resources to an NFS client.......................................................... 47

Chapter 4. Using z/OS UNIX System Services files...................................................................................49z/OS UNIX file system.......................................................................................................................... 49POSIX compatibility............................................................................................................................. 50NFS protocol.........................................................................................................................................51Attributes specific to z/OS UNIX System Services..............................................................................51

Synchronous write to a z/OS UNIX file for NFS version 2 protocol............................................... 51Synchronous write to a z/OS UNIX file for NFS version 3 or 4 protocol........................................51Authorization checking when writing to a z/OS UNIX file..............................................................52HFSPREFIX site attribute............................................................................................................... 52WINPREFIX site attribute...............................................................................................................52

Protecting your z/OS UNIX System Services files............................................................................... 53Accessing z/OS UNIX files from a client.............................................................................................. 53

Mount examples............................................................................................................................. 54z/OS UNIX data transfer and conversion.............................................................................................55

Data transfer under the NFS version 4 protocol............................................................................ 55Text or binary processing - NFS version 2 and 3 protocols...........................................................55

Linking an MVS data set to a z/OS UNIX file system........................................................................... 56Creating an external link.................................................................................................................56Displaying the contents on an external link................................................................................... 56Deleting an external link.................................................................................................................56

Accessing symbolic links on z/OS NFS version 4................................................................................ 57UNIX look and feel............................................................................................................................... 58NFS file system attributes....................................................................................................................58Displaying and modifying remote file system access control lists..................................................... 58

Remote ACL management restrictions:......................................................................................... 59

Chapter 5. z/OS NFS file locking and access control................................................................................ 61Locking in NFS versions 2 and 3 (NFS server only)............................................................................. 61

Using Network Lock Manager (NLM) in NFS V2 and V3.................................................................61Using Network Status Monitor (NSM) in NFS V2 and V3............................................................... 62

Locking in NFS version 4...................................................................................................................... 62Byte-range locking..........................................................................................................................63Share reservations.......................................................................................................................... 63Specifying a grace period for reclaiming locks.............................................................................. 63Listing locks held for a file.............................................................................................................. 63Releasing locks held for a file.........................................................................................................64

Chapter 6. Commands and examples for AIX and UNIX clients.............................................................. 65Using commands on AIX...................................................................................................................... 65Quick reference of AIX and UNIX commands..................................................................................... 69Accessing z/OS UNIX file systems and z/OS conventional MVS files................................................. 69

Mvslogin command examples........................................................................................................ 70Mount command examples using an MVS prefix...........................................................................71Mount command example: overriding server default attributes without an MVS prefix..............72

Displaying default and mount point attributes - showattr..................................................................73Unmounting and logging out of z/OS................................................................................................... 76

Disconnecting your mount point - umount.................................................................................... 76Ending your z/OS session - mvslogout...........................................................................................77

Chapter 7. Commands and examples for z/OS NFS clients......................................................................79Using commands on the z/OS NFS client ........................................................................................... 79

Accessing z/OS................................................................................................................................86Mvslogin command examples........................................................................................................ 86

v

Mount command syntax and examples......................................................................................... 87Unmount command syntax and examples.................................................................................... 95Displaying client and server statistical information–nfsstat......................................................... 96Displaying server mount information–showmount..................................................................... 100Displaying default and mount point attributes–showattr........................................................... 101Ending your z/OS session - mvslogout.........................................................................................103

Chapter 8. Commands and examples for Windows clients....................................................................105Installing the Windows native NFS client..........................................................................................105Configuring Windows user name mapping........................................................................................105Configuring printer sharing................................................................................................................ 106Using commands on Windows...........................................................................................................106Quick reference of Windows commands...........................................................................................112Accessing z/OS UNIX file systems and z/OS conventional MVS files...............................................113

mvslogin command examples......................................................................................................114mount command example using an MVS prefix.......................................................................... 116mount command example using a Windows prefix.....................................................................116Getting authorization to access files............................................................................................117Saving of mount points.................................................................................................................117Automatic timed logout - logout attribute................................................................................... 117

Administering the Windows NFS client............................................................................................. 117Displaying server RPC information.................................................................................................... 119Displaying server mount information................................................................................................ 120Displaying default and mount point attributes..................................................................................120Unmounting and logging out of z/OS................................................................................................. 123

Disconnecting your mount point.................................................................................................. 123Ending your z/OS session............................................................................................................. 123

Chapter 9. Initialization attributes for the z/OS NFS client....................................................................125Client attribute syntax........................................................................................................................125Datacaching attribute.........................................................................................................................131Mount processing parameters and installation parameters.............................................................132NFS client translation support...........................................................................................................133z/OS NFS client with z/OS NFS server............................................................................................... 133

Chapter 10. Initialization attributes for the z/OS NFS server.................................................................135Attributes used for z/OS UNIX file access.........................................................................................135Multipliers...........................................................................................................................................136Duplicate attributes........................................................................................................................... 136Data set creation attributes syntax................................................................................................... 136Processing attributes syntax............................................................................................................. 140

Timeout attributes........................................................................................................................149Retrieve attributes........................................................................................................................150Mapped keyword processing attribute........................................................................................ 150Native ASCII processing attributes..............................................................................................151

Site attributes syntax......................................................................................................................... 153

Part 2. Customization and Operations................................................................ 171

Chapter 11. Customization......................................................................................................................173Protecting your programs and files................................................................................................... 173

Protecting the server control files................................................................................................173Setting up the z/OS NFS authorization.........................................................................................173Protecting the file system with RPCSEC_GSS..............................................................................174Protecting the file system on z/OS with the Security site attribute............................................ 178Customizing installation security exits........................................................................................ 183Using UNIX style credentials for authentication......................................................................... 183

vi

Converting data.................................................................................................................................. 184UTF-8 translation support................................................................................................................. 184Creating the conversion environment for Unicode Services.............................................................185Collecting NFS usage data................................................................................................................. 186Configuring the z/OS NFS client.........................................................................................................187

Creating the PARMLIB statement for the client...........................................................................187Updating z/OS system data sets for the client............................................................................ 187Allocating client log data sets...................................................................................................... 188NFS Client with Multiple TCPIP stacks........................................................................................ 188Mounting remote file systems......................................................................................................188Setting up reserved (privileged) ports......................................................................................... 189Configuring a secure z/OS NFS client...........................................................................................190

Configuring the z/OS NFS server........................................................................................................191z/OSMF workflow for NFS.............................................................................................................191Attributes data set........................................................................................................................192Exports data set............................................................................................................................193Checklist data set......................................................................................................................... 202Mount handle data sets................................................................................................................ 202Lock data sets............................................................................................................................... 203Converting data between ASCII and EBCDIC - NFS V2 and V3 only.......................................... 204Updating z/OS system data sets for the server........................................................................... 205Allocating the z/OS NFS server log data sets...............................................................................206Side file data set........................................................................................................................... 206Modifying tcpip.ETC.RPC and etc/rpc.......................................................................................... 206Setting up a user-specified port range.........................................................................................207Configuring a secure z/OS NFS server......................................................................................... 208Using dynamic client IP addressing.............................................................................................211Terminal ID based restricted MVSLOGIN.................................................................................... 212SERVAUTH based restricted MVSLOGIN..................................................................................... 213Data Labeling................................................................................................................................ 215Using multiple TCP/IP stacks....................................................................................................... 215Configuring multiple servers in INET........................................................................................... 218

Installing the z/OS NFS utilities.........................................................................................................224Retrieving utility source for AIX, Sun Solaris, Linux, or macOS.................................................. 225Retrieving utility binaries for Windows........................................................................................ 227Porting the z/OS NFS utilities....................................................................................................... 228Porting on different compilers and operating systems............................................................... 229

NFS v4 protocol name mapping........................................................................................................ 231Inbound owner/owner_group processing................................................................................... 232Outbound owner and owner_group attributes processing......................................................... 233Domain processing in NFSv4 Name Mapping..............................................................................234

Using the NFS Error Client Loop Detection Facility........................................................................... 234

Chapter 12. Network File System operation...........................................................................................237Starting the z/OS NFS client...............................................................................................................237Stopping the z/OS NFS client.............................................................................................................238Starting component tracing for the z/OS NFS client......................................................................... 238Starting the z/OS NFS server............................................................................................................. 241

Starting multiple servers.............................................................................................................. 242Stopping the z/OS NFS server............................................................................................................243Starting the z/OS NFS NSM and z/OS NFS NLM................................................................................ 244Starting component tracing for the z/OS NFS server........................................................................ 244Entering operands of the modify command for the z/OS NFS server...............................................247

Addds operand............................................................................................................................. 249bufferusage operand.................................................................................................................... 250bufhigh operand............................................................................................................................250Cbsniff operand............................................................................................................................ 251CONSOLEMSGS operand.............................................................................................................. 251

vii

DlyDTimeout operand...................................................................................................................251exportchk operand....................................................................................................................... 252Exportfs operand.......................................................................................................................... 252Freeds operand.............................................................................................................................252Freeze operand.............................................................................................................................253ID2NAME operand........................................................................................................................253List operand.................................................................................................................................. 253Mapfile operand............................................................................................................................255racf_cache_reset operand........................................................................................................... 255Release operand...........................................................................................................................255smf operand..................................................................................................................................256Status operand............................................................................................................................. 256Swapldb operand..........................................................................................................................257Swapmhdb operand..................................................................................................................... 257Unmount operand.........................................................................................................................257Unmntall operand.........................................................................................................................258Unmnthfs operand........................................................................................................................258Unmntmvs operand...................................................................................................................... 258v4delg operand.............................................................................................................................258

Entering operands of the modify command for diagnosis................................................................ 258chkloop operand...........................................................................................................................259Debug operand............................................................................................................................. 260Flushlog operand.......................................................................................................................... 260Listlock operand........................................................................................................................... 260Log operand.................................................................................................................................. 261Smf operand................................................................................................................................. 262Sockhang operand........................................................................................................................262Switchlog operand........................................................................................................................263Version operand............................................................................................................................263

Displaying NFS trace information...................................................................................................... 263

Chapter 13. Installation-wide exit routines for the z/OS NFS server.................................................... 265Requirements for NFS........................................................................................................................265

Sample link-edit JCL.....................................................................................................................266Storage blocks of the server exits................................................................................................266

Login installation-wide exit................................................................................................................267Requirements of the login exit..................................................................................................... 269Options of the login exit................................................................................................................269Structure of the login exit message............................................................................................. 269Contents of the login exit parameter list..................................................................................... 269Login exit parameter list...............................................................................................................270Request codes to the login exit....................................................................................................270Return codes from the login exit..................................................................................................271System initialization routine of the login exit...............................................................................271Start of new user session routine of the login exit...................................................................... 271User login request routine of the login exit..................................................................................272User logout request routine of the login exit............................................................................... 272System termination routine of the login exit............................................................................... 273

File security installation-wide exit.....................................................................................................273Requirements of the file security exit.......................................................................................... 275Structure of the file security exit message.................................................................................. 275Contents of the file security exit parameter list.......................................................................... 275File security exit parameter list....................................................................................................276Request codes to the file security exit.........................................................................................277Return codes from the file security exit.......................................................................................277Validate allocate request routine of the file security exit............................................................277Validate write request routine of the file security exit................................................................ 278Validate read request routine of the file security exit................................................................. 278

viii

Return security permissions routine of the file security exit...................................................... 279

Part 3. Performance Tuning................................................................................281

Chapter 14. Performance tuning in the NFS environment..................................................................... 283What is performance tuning?.............................................................................................................283

How is performance characterized?............................................................................................ 283What is the NFS environment?.....................................................................................................284How to tune for performance....................................................................................................... 284

Impact of the NFS protocol on performance.................................................................................... 285

Chapter 15. Optimizing the NFS environment........................................................................................289Network performance tuning.............................................................................................................289NFS client system performance tuning............................................................................................. 290NFS server system performance tuning............................................................................................ 291

z/OS constraints........................................................................................................................... 292

Chapter 16. Evaluating z/OS NFS performance......................................................................................295Evaluating throughput........................................................................................................................295

Single process throughput........................................................................................................... 295Multiple process throughput........................................................................................................ 296Multiple client throughput............................................................................................................296

Evaluating NFS command response time......................................................................................... 296Evaluating CPU utilization.................................................................................................................. 296Collecting server usage data..............................................................................................................296

Chapter 17. Tuning the z/OS NFS server................................................................................................ 297Data set creation attributes............................................................................................................... 297

Block size and record length........................................................................................................ 297Record format...............................................................................................................................298Data set organization and data set type...................................................................................... 298B37/D37/E37 ABEND handling....................................................................................................299NFS server cache monitoring and reporting................................................................................ 299

Processing attributes......................................................................................................................... 299Character translation....................................................................................................................299File size determination................................................................................................................. 300Data set timeout specification..................................................................................................... 301Accessing migrated files...............................................................................................................301Asynchronous z/OS UNIX processing.......................................................................................... 302

Site attributes.....................................................................................................................................302Buffer usage and caching............................................................................................................. 302Ordering out-of-sequence data................................................................................................... 303Storage considerations.................................................................................................................305Subtasking.................................................................................................................................... 305

Chapter 18. Tuning the z/OS NFS client..................................................................................................307Caching............................................................................................................................................... 307Dynamicsizeadj.................................................................................................................................. 308Bufhigh............................................................................................................................................... 308Biod.....................................................................................................................................................308Readahead......................................................................................................................................... 308syncwrite............................................................................................................................................ 308Delaywrite.......................................................................................................................................... 308Vers.....................................................................................................................................................309Wsize and rsize...................................................................................................................................309

Part 4. Diagnosis and Messages..........................................................................311

ix

Chapter 19. Diagnosis and reporting of problems..................................................................................313Correcting input errors.......................................................................................................................313Using keywords to identify a problem............................................................................................... 313

Component identification keyword..............................................................................................314Release level keyword..................................................................................................................314Type-of-failure keyword...............................................................................................................315Service level keyword...................................................................................................................317

Using z/OS component tracing.......................................................................................................... 317Component trace benefits............................................................................................................318Using NFS component trace PARMLIB members CTINFSnn and CTINFCnn............................. 318Capturing NFS Server component trace information in an SVC dump........................................324Capturing NFS Client component trace information in an SVC dump.........................................325Using a z/OS component trace external writer ...........................................................................326

Setting up a dump data set for abnormal ends.................................................................................331Searching the IBM database for APARs and PTFs............................................................................ 331Contacting the IBM Support Center.................................................................................................. 331Diagnostic aids................................................................................................................................... 332

First failure data capture.............................................................................................................. 332Errors and messages.................................................................................................................... 334Debug trace data capture ............................................................................................................ 334NFS client hang problem analysis................................................................................................334

Environmental checklist.................................................................................................................... 335

Chapter 20. Network File System messages..........................................................................................337Server messages................................................................................................................................ 337Client messages................................................................................................................................. 440Client/Server Shared Messages.........................................................................................................470Messages from the client platform (AIX).......................................................................................... 484Messages from the client platform (Windows)................................................................................. 489

Chapter 21. Return codes....................................................................................................................... 491

Chapter 22. Reason codes...................................................................................................................... 501Special reason codes (xx is 00-0F)....................................................................................................501Reason codes from NFS Client or NFS Server modules (xx is 10-FF).............................................. 517

z/OS UNIX JRcccc reason codes (0000-0FFF)............................................................................ 517Global reason codes (yyyy = 1000 - 3FFF).................................................................................. 521Module specific reason codes (yyyy = 4000 - 4FFF)................................................................... 526

Appendix A. File size value for MVS data sets..................................................... 529Storage of the file size value....................................................................................................................529

System-managed PS, VSAM, and PDSE data sets............................................................................ 529Migrated system-managed data sets................................................................................................ 529Non-system-managed, PDS, and direct data sets............................................................................ 530

How the file size value is generated........................................................................................................530Using fastfilesize to avoid read-for-size............................................................................................ 530Using nofastfilesize............................................................................................................................ 531

Appendix B. Time stamps for MVS data sets....................................................... 533Time stamps for system-managed VSAM and PS data sets.................................................................. 533Time stamps for non-system-managed PS and DA data sets................................................................533

Storage of time stamps......................................................................................................................533Client program requirements.............................................................................................................533Generating time stamps.....................................................................................................................534

Time stamps for non-system-managed VSAM data sets....................................................................... 534Time stamps for PDSs and PDSEs...........................................................................................................534

x

Setting time stamps.................................................................................................................................536

Appendix C. NFS server attributes......................................................................537NFS file system attributes for MVS data sets......................................................................................... 537NFS file system attributes for z/OS UNIX file systems...........................................................................538NFS protocol attributes........................................................................................................................... 538

Appendix D. NSM (statd) protocol.......................................................................543Using supported NSM (statd) procedures...............................................................................................543

Appendix E. NFS system server sample attribute table....................................... 545

Appendix F. Sample exports data set..................................................................567

Appendix G. Sample startup procedures............................................................ 575Sample z/OS NFS server startup procedures......................................................................................... 575Sample z/OS NFS client startup procedures.......................................................................................... 578

Appendix H. Retrieval of source code for z/OS NFS utilities.................................581

Appendix I. PCNFSD protocol.............................................................................583Accessing data with PCNFSD.................................................................................................................. 583Accessing z/OS UNIX files.......................................................................................................................583Starting the PCNFSD server.....................................................................................................................583Using supported PCNFSD protocols....................................................................................................... 583

Version 1 of the PCNFSD protocol..................................................................................................... 583Version 2 of the PCNFSD protocol..................................................................................................... 584

Appendix J. SMF C and assembler header macros.............................................. 587SMF C header macro GFSASSMF............................................................................................................ 587SMF assembler header macro GFSAUSMF ............................................................................................ 592

Appendix K. Capturing diagnostic information using z/OS NFS log data sets andfrom other components.................................................................................. 599Using log data sets...................................................................................................................................599

Server log data sets............................................................................................................................599Client log data sets.............................................................................................................................600

Debug trace data capture........................................................................................................................601z/OS NFS server debug trace capture............................................................................................... 601z/OS NFS server DEBUG trace types................................................................................................. 602z/OS NFS client debug trace capture.................................................................................................602

Related component trace capture.......................................................................................................... 602z/OS UNIX System Services activity trace.........................................................................................602z/OS hierarchical file system (HFS) physical file system activity trace............................................603z/OS TCP/IP activity trace ................................................................................................................. 603AIX client activity trace ..................................................................................................................... 604SUN client activity trace ....................................................................................................................604z/OS dump ......................................................................................................................................... 605

Appendix L. GFSAMHDJ sample code for creating NFS server sets...................... 607

Appendix M. Setting up NFS functions with Kerberos Support.............................611Special considerations for Linux® Clients................................................................................................611Windows recommendations and limitations.......................................................................................... 611Setting up a Kerberos Key Distribution Center....................................................................................... 611

xi

Appendix N. Accessibility.................................................................................. 615Accessibility features.............................................................................................................................. 615Consult assistive technologies................................................................................................................615Keyboard navigation of the user interface..............................................................................................615Dotted decimal syntax diagrams.............................................................................................................615

Notices..............................................................................................................619Terms and conditions for product documentation.................................................................................620IBM Online Privacy Statement................................................................................................................ 621Policy for unsupported hardware............................................................................................................621Minimum supported hardware................................................................................................................621Programming interface information........................................................................................................622Trademarks..............................................................................................................................................622

Glossary............................................................................................................ 623

Index................................................................................................................ 635

xii

Figures

1. NFS server data flow and major components.............................................................................................. 3

2. Generic z/OS NFS server using INET............................................................................................................ 4

3. Multiple z/OS NFS servers in INET................................................................................................................5

4. Generic NFS server in CINET.........................................................................................................................9

5. Multiple NFS servers with TCP/IP stack affinity.........................................................................................10

6. Examples of mounting MVS data sets on Windows, UNIX and Linux clients............................................ 46

7. Example of mounting a z/OS UNIX file from a UNIX client........................................................................50

8. Displaying server attributes........................................................................................................................ 74

9. Displaying mount point attributes.............................................................................................................. 75

10. Displaying mount point attributes, part 2................................................................................................ 76

11. TSO MOUNT command syntax operands................................................................................................. 88

12. TSO UNMOUNT command syntax operands............................................................................................ 95

13. Displaying NFS Server and Client NFSv3 statistical information.............................................................97

14. Displaying NFS client rpc statistical information..................................................................................... 97

15. Displaying NFS client NFS statistical information....................................................................................98

16. Displaying all of the z/OS NFS Server (RPC, NFSv2, NFSv3, NFSv4) statistical information..................99

17. Displaying NFS mounted file system information....................................................................................99

18. Displaying NFS mounted file system information with secure(upd) (Versions 2 and 3 protocolonly ).........................................................................................................................................................100

19. Displaying NFS mounted file system information with public mountpoint (Version 4 protocol only ) 100

20. Displaying attributes...............................................................................................................................102

21. mvslogin requesting that the user be prompted for a password.......................................................... 114

22. mvslogin specifying a password, group, and account........................................................................... 114

xiii

23. mvslogin specifying a passphrase..........................................................................................................114

24. mvslogin requesting that the password be changed.............................................................................114

25. mvslogin requesting that the user be prompted for a password and that the password be changed.114

26. mvslogin without specifying a z/OS UNIX user ID................................................................................. 115

27. mvslogin without specifying a password............................................................................................... 115

28. Displaying the version of the mvslogin Windows executable................................................................115

29. Displaying server attributes....................................................................................................................121

30. Displaying mount point attributes..........................................................................................................122

31. Permission checking for the security(none) attribute........................................................................... 179

32. Permission checking for the security(exports) attribute....................................................................... 179

33. Permission checking for the security(saf) attribute...............................................................................180

34. Permission checking for the security(safexp) attribute.........................................................................181

35. Sample FILESYSTYPE parmlib statement..............................................................................................187

36. Specifying the mount handle data set in the MVSNFS procedure.........................................................203

37. Specifying the lock data set in the MVSNFS procedure.........................................................................203

38. /etc/services for mountd, mvsmount, pcnfsd, showattr, status, and nlockmgr...................................207

39. Modify tcpip.profile for z/OS NFS server services..................................................................................207

40. z/OS NFS utility source code.................................................................................................................. 229

41. Sample link-edit JCL for the NFS............................................................................................................266

42. Determining which login checking routines are used............................................................................268

43. Determining which file security checking routines are used.................................................................274

44. Displaying NFS client rpc and NFS statistical information.................................................................... 286

45. Sample network topology.......................................................................................................................289

46. Directory list comparison between DFSMS-managed and non-managed............................................ 300

47. Bufhigh utilization with percentsteal..................................................................................................... 302

xiv

48. Relationship between cachewindow and BIODs...................................................................................304

49. Logicalcache utilization for cachewindows............................................................................................304

50. z/OS NFS server component trace PARMLIB member CTINFS00 (Part 1 of 2)....................................322

51. z/OS NFS server component trace PARMLIB member CTINFS00 (Part 2 of 2)....................................322

52. z/OS NFS client component trace PARMLIB member CTINFC00......................................................... 324

53. CTRACE Display Parameters panel........................................................................................................ 328

54. NFS Server Filtering Criteria................................................................................................................... 328

55. NFS Client Filtering Criteria.................................................................................................................... 329

xv

xvi

Tables

1. Reference documents.................................................................................................................................xxi

2. Network data processed at various z/OS servers.........................................................................................7

3. Mount statements based on the IMPPREFIX setting.................................................................................16

4. View of NFS server capability..................................................................................................................... 23

5. Breakdown of text and binary writes..........................................................................................................37

6. Examples of mounting MVS data sets from clients....................................................................................44

7. NFS procedures...........................................................................................................................................47

8. Examples of the mount command for clients.............................................................................................54

9. Examples of the mvslogin command for clients........................................................................................ 70

10. Examples of the showattr command for clients...................................................................................... 73

11. Examples of the umount command for clients........................................................................................ 76

12. Example of the mvslogout command for clients......................................................................................77

13. Examples of the mvslogin command for clients...................................................................................... 86

14. Examples of the showattr command for Windows clients.................................................................... 121

15. Attributes - z/OS NFS client....................................................................................................................125

16. Client attributes...................................................................................................................................... 125

17. Mount processing parameters................................................................................................................132

18. Installation parameters.......................................................................................................................... 133

19. z/OS NFS clients with non-z/OS based NFS servers..............................................................................133

20. Attributes - z/OS NFS server...................................................................................................................135

21. Data set creation attributes....................................................................................................................136

22. Processing attributes..............................................................................................................................141

23. The mapped keyword and existing keywords........................................................................................150

xvii

24. File tagging with Unicode Services active.............................................................................................. 152

25. File tagging with Unicode Services not active........................................................................................153

26. Site attributes..........................................................................................................................................154

27. UID, GID, SGID permission checking with security site attribute.........................................................182

28. z/OS server processing of a mount request........................................................................................... 182

29. z/OS server processing of a file request.................................................................................................183

30. Shorthand for addresses with multiple zero bits...................................................................................201

31. Shorthand for addresses in mixed IPv4 and IPv6 environments..........................................................201

32. z/OS NFS server services in tcpip.ETC.RPC and etc/rpc........................................................................206

33. Files in the prefix.NFSTARB data set to download to clients................................................................ 224

34. List of installation-wide exits..................................................................................................................265

35. Format of login installation-wide exit routine parameter list................................................................270

36. Request codes to the login exit.............................................................................................................. 270

37. Return codes from the login exit............................................................................................................ 271

38. Codes and fields for system initialization.............................................................................................. 271

39. Codes and fields for start of new user session...................................................................................... 271

40. Codes and fields for user login request..................................................................................................272

41. Codes and fields for logout request....................................................................................................... 272

42. Codes and fields for system termination............................................................................................... 273

43. Format of the parameter list for the file security installation-wide exit............................................... 275

44. Request codes to the file security exit................................................................................................... 277

45. Return codes from the file security exit................................................................................................. 277

46. Codes and fields for validate allocate request.......................................................................................277

47. Codes and fields for validate write request........................................................................................... 278

48. Codes and fields for validate read request............................................................................................ 278

xviii

49. Codes and fields for return security permissions.................................................................................. 279

50. Network performance tuning symptom and action information...........................................................289

51. NFS client system performance tuning symptom and action information........................................... 290

52. z/OS constraints symptom and action information............................................................................... 292

53. Default block sizes for RAMAC 3 or ESS 2105 DASD.............................................................................298

54. Client installation parameters for tuning............................................................................................... 307

55. Mount parameters for performance and tuning.....................................................................................307

56. z/OS NFS FMIDs and release names......................................................................................................314

57. Summary of type-of-failure keywords................................................................................................... 315

58. NFS symptom data................................................................................................................................. 332

59. Dump content and storage areas........................................................................................................... 333

60. Diagnostic errors and messages............................................................................................................ 334

61. NFS server z/OS operators console message format............................................................................ 337

62. Message format for the NFS server log data set....................................................................................337

63. NFS client z/OS operators console message format............................................................................. 440

64. Message format for the NFS client log data set..................................................................................... 441

65. Common variables.................................................................................................................................. 442

66. Message format for the NFS server or NFS client log data sets ........................................................... 470

67. Externalized return codes defined by the NFS version 2 protocol........................................................491

68. Externalized return codes defined by the NFS version 3 protocol........................................................491

69. Externalized return codes defined by the NFS version 4 protocol........................................................492

70. z/OS NFS Server: z/OS UNIX return codes mapped to NFS Version 2 return codes............................ 494

71. z/OS NFS Server: z/OS UNIX return codes mapped to NFS Version 3 return codes............................ 496

72. z/OS NFS Server: z/OS UNIX return codes mapped to NFS Version 4 return codes............................ 498

73. Special NFS reason codes...................................................................................................................... 502

xix

74. Special NFS reason codes where xx = 05.............................................................................................. 502

75. Parsing error (when reason code is 6E01xxxx)......................................................................................512

76. Parsing error (when reason code is from 6E0111yy to 6E0133yy........................................................513

77. RPC error (when reason code is 6E03xxxx) .......................................................................................... 514

78. NFS reason codes that match z/OS UNIX JRcccc reason codes (0000-0FFF).....................................517

79. NFS client global reason codes (1000 - 3FFF)...................................................................................... 521

80. Reason codes for module GFSCVNAT (xx = 12).................................................................................... 526

81. Reason codes for module GFSCVMNT (xx = 18)....................................................................................527

82. Time stamp sources for PDS and PDSE members.................................................................................535

83. Time stamp sources for PDS and PDSE data sets (directories)............................................................ 535

84. File system values to get dynamic file system information...................................................................537

85. File system values to get static file system information .......................................................................537

86. File system values to retrieve POSIX information ................................................................................ 537

87. File system values to get static file system information .......................................................................538

88. File system values to retrieve POSIX information ................................................................................ 538

89. NFS Version 4 Attributes........................................................................................................................ 539

xx

About this document

This document provides users, system programmers, and operators with information about using,customizing, operating, tuning, and diagnosing the z/OS® Network File System (z/OS NFS).

For information about the accessibility features of z/OS, for users who have a physical disability, seeAppendix N, “Accessibility,” on page 615.

Required product knowledgeTo use this document effectively, you should be familiar with the IBM multiple virtual system (MVS) as acomponent of the z/OS operating system, the IBM Time Sharing Option (TSO), and their commands. Inaddition, you should be familiar with System Modification Program/Extended (SMP/E) and the basicconcepts of the NFS protocol and networking (Transmission Control Protocol/Internet Protocol (TCP/IP)).

Where to find more informationWhere necessary, this document references information in other documents, using the shortened versionof the document title. For complete titles and order numbers of the documents for all products that arepart of z/OS, see z/OS Information Roadmap.

Access to documentsTable 1 on page xxi contains additional reference information.

Table 1. Reference documents

Title Order Number

AIX Commands Reference, Volume 1 SC23-2537

AIX Commands Reference, Volume 2 SC23-2538

AIX Commands Reference, Volume 3 SC23-2539

AIX Commands Reference, Volume 4 SC23-2539

AIX Commands Reference, Volume 5 SC23-2639

AIX General Concepts and Procedures for RISC System/6000 GC23-2202

Character Data Representation Architecture Overview GC09-2207

Character Data Representation Architecture Reference and Registry SC09-2190

z/OS SMP/E Reference SA23-2276

z/OS SMP/E User's Guide SA23-2277

z/OS and Software Products DVD Collection SK3T-4271

z/OS Communications Server: IP Configuration Reference SC27-3651

z/OS DFSMS Introduction SC23-6851

z/OS DFSMS Macro Instructions for Data Sets SC23-6852

z/OS Upgrade Workflow GA32-0889

z/OS DFSMS Using the New Functions SC23-6857

z/OS DFSMS Using Data Sets SC23-6855

z/OS DFSMSdfp Advanced Services SC23-6861

z/OS DFSMSdfp Diagnosis SC23-6863

z/OS DFSMSdfp Storage Administration SC23-6860

© Copyright IBM Corp. 1991, 2020 xxi

Table 1. Reference documents (continued)

Title Order Number

z/OS DFSMShsm Diagnosis GC52-1387

z/OS Information Roadmap SA23-2299

z/OS MVS Installation Exits SA23-1381

z/OS MVS JCL Reference SA23-1385

z/OS MVS Programming: Authorized Assembler Services Guide SA23-1371

z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN SA23-1372

z/OS MVS Programming: Authorized Assembler Services Reference EDT-IXG SA23-1373

z/OS MVS Programming: Authorized Assembler Services Reference LLA-SDU SA23-1374

z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO SA23-1375

z/OS MVS System Codes SA38-0665

z/OS MVS Programming: Authorized Assembler Services Guide SA23-1371

z/OS MVS System Management Facilities (SMF) SA38-0667

z/OS MVS System Messages, Vol 1 (ABA-AOM) SA38-0668

z/OS MVS System Messages, Vol 2