Abstract for Network File System Guide and Reference
Summary of changes
What's New in V2R1
Using z/OS Network File System
Introduction
Overview
z/OS UNIX files
z/OS UNIX advantages
NFS protocol compliance
Crossing between file systems–NFS server
z/OS conventional MVS data sets
Mounting MVS data sets onto a client mount point
Creating z/OS conventional MVS data sets
Serializing and sharing data sets
NFS version 2 and version 3 statelessness
NFS version 4 state
Name space and file system management
z/OS NFS File System Type Selection
Specifying the path type prefix and the customer-configurable path resolution heuristic
Valid mount path specifications
Back-level (prior to V1R11)
MVS prefix
MVS implicit prefix
Implicit prefix support restrictions
Server control files
Attributes data set
Exports data set
Mount handle data set
Log data set
Tested clients for the z/OS NFS server
NFS protocol attributes for the z/OS NFS server
z/OS NFS server restrictions
Tested servers for the z/OS NFS client
z/OS NFS client restrictions
WebNFS support
NFS version 3 and version 4 with TCP/IP protocols
Internet Protocol version 6
User-specified port range support
Dynamic addressing
64-bit exploitation
Data transfer and conversion
Native ASCII support
Creating z/OS conventional MVS data sets
Overriding data set creation attributes
Preparing to create an MVS file
Naming MVS files
Restrictions on using alias names for MVS files
Creating physical sequential files
Creating direct access files
Creating PDSs and PDSEs
Creating a PDS or PDSE - mkdir dsntype(pds), dsntype(library)
Removing a PDS or PDSE - rm, rmdir
Accessing PDS or PDSE members
Updating or extending a PDS or PDSE member
Timing out while writing a PDS or PDSE member
Wildcard copy to a PDS or PDSE
Limitations of a PDS
Concurrent writes to a PDSE
ISPF extended statistics support for PDS or PDSE members
Creating VSAM files
Exploiting SAM striped files
Exploiting large format data sets
Exploiting data sets on extended address volumes
Using z/OS conventional MVS data sets
Special MVS considerations
Selection of an MVS data storage format
File size determination and time stamps
Ownership and permissions
File reading and writing
Random access to files
Cached data writing
Case sensitivity–maplower, nomaplower
Selection of text or binary processing modes–text, binary
Binary processing mode
Text processing mode
Using the lf line terminator
Selection of how blanks are handled–blankstrip, noblankstrip
Potential fixed/variable/undefined record length data set logical I/O errors
MVS prefix support
Number representation
Partial record identification
Symptoms of GFSA824W/GFSA825W messages
Access to migrated files–retrieve, noretrieve; wait, nowait
Access to migrated system-managed data sets
File handle refresh
Mapping between the workstation and MVS file systems
File extension mapping
Mounting of MVS data sets onto a client mount point
Mount examples
Variants of the mount command
Use of a PDS or PDSE as a directory
Use of multiple mount points
Data set serialization and sharing
NFS protocol
NFS file system attributes
Delegating management of a file's resources to an NFS client
Using z/OS UNIX System Services files
z/OS UNIX file system
POSIX compatibility
NFS protocol
Attributes specific to z/OS UNIX System Services
Synchronous write to a z/OS UNIX file for NFS version 2 protocol
Synchronous write to a z/OS UNIX file for NFS version 3 or 4 protocol
Authorization checking when writing to a z/OS UNIX file
HFSPREFIX site attribute
Protecting your z/OS UNIX System Services files
Accessing z/OS UNIX files from a client
Mount examples
z/OS UNIX data transfer and conversion
Data transfer under the NFS version 4 protocol
Text or binary processing - NFS version 2 and 3 protocols
Linking an MVS data set to a z/OS UNIX file system
Creating an external link
Displaying the contents on an external link
Deleting an external link
Accessing symbolic links on z/OS NFS version 4
UNIX look and feel
NFS file system attributes
Displaying and modifying remote file system access control lists
Remote ACL management restrictions:
AIX restrictions
z/OS client restrictions
z/OS server restrictions
z/OS NFS file locking and access control
Locking in NFS versions 2 and 3 (NFS server only)
Using Network Lock Manager (NLM) in NFS V2 and V3
Monitored locks
Non-monitored locks
Specifying a grace period for reclaiming locks
Listing locks held for a file
Releasing locks held for a file
Using Network Status Monitor (NSM) in NFS V2 and V3
Locking in NFS version 4
Byte-range locking
Share reservations
Specifying a grace period for reclaiming locks
Listing locks held for a file
Releasing locks held for a file
Commands and examples for AIX and UNIX clients
Using commands on AIX
Quick reference of AIX and UNIX commands
Accessing z/OS UNIX file systems and z/OS conventional MVS files
Mvslogin command examples
“Permission denied” message
Mount command examples using an MVS prefix
Overriding default attributes
Mount command example: overriding server default attributes without an MVS prefix
Getting authorization to access files
Saving of mount points
Automatic timed logout - logout attribute
Displaying default and mount point attributes - showattr
Unmounting and logging out of z/OS
Disconnecting your mount point - umount
Ending your z/OS session - mvslogout
Commands and examples for z/OS NFS clients
Using commands on the z/OS NFS client
Accessing z/OS
Mvslogin command examples
“Permission denied” message
Mount command syntax and examples
Data conversion
BSAM, QSAM, and VSAM ESDS access to remote files
Invoking the Mount command on the z/OS platform
Additional mount command examples
Automount facility mount
Getting authorization to access files
Saving of mount points
Automatic timed logout - logout attribute
Unmount command syntax and examples
Disconnecting your mount point - unmount
Displaying client and server statistical information–nfsstat
Displaying server mount information–showmount
Displaying default and mount point attributes–showattr
Ending your z/OS session - mvslogout
Initialization attributes for the z/OS NFS client
Client attribute syntax
Datacaching attribute
Mount processing parameters and installation parameters
NFS client translation support
z/OS NFS client with z/OS NFS server
Initialization attributes for the z/OS NFS server
Attributes used for z/OS UNIX file access
Multipliers
Duplicate attributes
Data set creation attributes syntax
Processing attributes syntax
Timeout attributes
Retrieve attributes
Mapped keyword processing attribute
Native ASCII processing attributes
Considerations for native ASCII environment support
NFS servers with non-z/OS based NFS clients
Site attributes syntax
Customization and Operations
Customization
Protecting your programs and files
Protecting the server control files
Setting up the z/OS NFS authorization
Protecting the file system on z/OS with the NFS V4 protocol
GSS credential acquisition
Security context acceptance
Security negotiation
Mount point establishment
NFS4ERR_WRONGSEC handling
Protecting the file system on z/OS with the Security site attribute
Unrestricted data access–security(none)
Exports list checking–security(exports)
SAF checking–security(saf)
SAF and exports list checking–security(safexp)
SAF checking with checklist processing
File system export
Authorization of file operations
Customizing installation security exits
Using UNIX style credentials for authentication
Converting data
Creating the conversion environment for Unicode Services
Collecting NFS usage data
Configuring the z/OS NFS client
Creating the PARMLIB statement for the client
Updating z/OS system data sets for the client
PARMLIB updates
PROCLIB updates
Allocating client log data sets
NFS Client with Multiple TCPIP stacks
Mounting remote file systems
Setting up reserved (privileged) ports
Configuring a secure z/OS NFS client
Configuring the z/OS NFS server
Attributes data set
Exports data set
When the modified exports data set takes effect
Directory statement
Examples of entries in an exports data set
Examples of specifying directories
Examples of specifying access parameters
Client id specification
Netgroup definitions
Wildcard characters
IP address representation
Address Prefix Representation
Checklist data set
Mount handle data sets
Lock data sets
Converting data between ASCII and EBCDIC - NFS V2 and V3 only
Customizing the translation table
Enabling the xlat processing attribute
Updating z/OS system data sets for the server
Allocating the z/OS NFS server log data sets
Side file data set
Modifying tcpip.ETC.RPC and etc/rpc
Setting up a user-specified port range
Configuring a secure z/OS NFS server
Using dynamic client IP addressing
Terminal ID based restricted MVSLOGIN
SERVAUTH based restricted MVSLOGIN
Data Labeling
Using multiple TCP/IP stacks
Configuring multiple NFS servers with multiple TCP/IP stacks
Invocation
Example CINET configuration in BPXPRMxx to start an NFS server in a multiple server environment
Example procedure to start an NFS server in a multiple server environment
User interactions
Errors
Messages and codes
Configuring a single NFS server with multiple TCP/IP stacks
Invocation
Example CINET configuration in BPXPRMxx to start a single NFS server in a multi stack environment
User interactions
Errors
Messages and codes
Installing the client enabling commands
Retrieving commands for AIX, Sun Solaris, and Linux
Porting the mvslogin, mvslogout, and showattr commands
Porting on different compilers and operating systems
Compiling
Linking
Running commands
NFS v4 protocol name mapping
Inbound owner/owner_group processing
Outbound owner and owner_group attributes processing
Domain processing in NFSv4 Name Mapping
Network File System operation
Starting the z/OS NFS client
Stopping the z/OS NFS client
Starting component tracing for the z/OS NFS client
Starting the z/OS NFS server
Starting multiple servers
Stopping the z/OS NFS server
Starting the z/OS NFS NSM and z/OS NFS NLM
Starting component tracing for the z/OS NFS server
Entering operands of the modify command for the z/OS NFS server
Addds operand
bufferusage operand
bufhigh operand
Cbsniff operand
DlyDTimeout operand
Exportfs operand
Freeds operand
Freeze operand
List operand
Mapfile operand
racf_cache_reset operand
Release operand
smf operand
Status operand
Swapldb operand
Swapmhdb operand
Unmount operand
Unmntall operand
Unmnthfs operand
Unmntmvs operand
v4delg operand
Entering operands of the modify command for diagnosis
Debug operand
Flushlog operand
Listlock operand
Log operand
Smf operand
Sockhang operand
Switchlog operand
Version operand
Displaying NFS trace information
Installation-wide exit routines for the z/OS NFS server
Requirements for NFS
Sample link-edit JCL
Storage blocks of the server exits
Global exit block (GXB)
User exit block (UXB)
Login installation-wide exit
Requirements of the login exit
Options of the login exit
Structure of the login exit message
Contents of the login exit parameter list
Login exit parameter list
Request codes to the login exit
Return codes from the login exit
System initialization routine of the login exit
Start of new user session routine of the login exit
User login request routine of the login exit
User logout request routine of the login exit
System termination routine of the login exit
File security installation-wide exit
Requirements of the file security exit
Structure of the file security exit message
Contents of the file security exit parameter list
File security exit parameter list
Request codes to the file security exit
Return codes from the file security exit
Validate allocate request routine of the file security exit
Validate write request routine of the file security exit
Validate read request routine of the file security exit
Return security permissions routine of the file security exit
Performance Tuning
Performance tuning in the NFS environment
What is performance tuning?
How is performance characterized?
What is the NFS environment?
How to tune for performance
Impact of the NFS protocol on performance
Optimizing the NFS environment
Network performance tuning
NFS client system performance tuning
NFS server system performance tuning
z/OS constraints
Evaluating z/OS NFS performance
Evaluating throughput
Single process throughput
Multiple process throughput
Multiple client throughput
Evaluating NFS command response time
Evaluating CPU utilization
Collecting server usage data
Tuning the z/OS NFS server
Data set creation attributes
Block size and record length
Record format
Data set organization and data set type
B37/D37/E37 ABEND handling
NFS server cache monitoring and reporting
Processing attributes
Character translation
File size determination
Data set timeout specification
Accessing migrated files
Asynchronous z/OS UNIX processing
Site attributes
Buffer usage and caching
Ordering out-of-sequence data
Storage considerations
Subtasking
Tuning the z/OS NFS client
Caching
Dynamicsizeadj
Bufhigh
Biod
Readahead
Delaywrite
Vers
Wsize and rsize
Diagnosis and Messages
Diagnosis and reporting of problems
Correcting input errors
Using keywords to identify a problem
Component identification keyword
Release level keyword
Type-of-failure keyword
ABENDxxx
MSGGFShnnnt
WAIT
LOOP
INCORROUT
DOC SCnnnnnnnn
PERFM
Service level keyword
Using z/OS component tracing
Component trace benefits
Using NFS component trace PARMLIB members CTINFSnn and CTINFCnn
Default trace options required by the Health Checker (HC)
CTINFS00 member of SYS1.PARMLIB
CTINFC00 member of SYS1.PARMLIB
Capturing NFS Server component trace information in an SVC dump
Capturing NFS Client component trace information in an SVC dump
Using a z/OS component trace external writer
Step 1. Telling MVS to start a CT external writer
Step 2. Telling NFS to connect to a CT external writer and start sending records
Using IPCS to view records from an external writer
Filtering NFS ctrace records in IPCS
Processing Traces in Batch Mode
Setting up a dump data set for abnormal ends
Searching the IBM database for APARs and PTFs
Contacting the IBM Support Center
Diagnostic aids
First failure data capture
Symptom data
SVC dump
Dump title
Dump content
Eye-catchers
Dump suppression
Data capture suppression
Invocation
Errors and messages
Debug trace data capture
NFS client hang problem analysis
Environmental checklist
Network File System messages
Server messages
GFSA300I - GFSA319I
GFSA801I
Client messages
GFSC098I
Client/Server Shared Messages
GFSN5001E
Messages from the client platform (AIX)
Return codes
Reason codes
Special reason codes (xx is 00-0F)
Reason codes from NFS Client or NFS Server modules (xx is 10-FF)
USS JRcccc reason codes (0000-0FFF)
Global reason codes (yyyy = 1000 - 3FFF)
Module specific reason codes (yyyy = 4000 - 4FFF)
File size value for MVS data sets
Storage of the file size value
System-managed PS, VSAM, and PDSE data sets
Migrated system-managed data sets
Non-system-managed, PDS, and direct data sets
How the file size value is generated
Using fastfilesize to avoid read-for-size
Using nofastfilesize
Time stamps for MVS data sets
Time stamps for system-managed VSAM and PS data sets
Time stamps for non-system-managed PS and DA data sets
Storage of time stamps
Client program requirements
Generating time stamps
Time stamps for non-system-managed VSAM data sets
Time stamps for PDSs and PDSEs
Setting time stamps
NFS server attributes
NFS file system attributes for MVS data sets
NFS file system attributes for z/OS UNIX file systems
NFS protocol attributes
NSM (statd) protocol
Using supported NSM (statd) procedures
NFS system server sample attribute table
Sample exports data set
Sample startup procedures
Sample z/OS NFS server startup procedures
Sample z/OS NFS client startup procedures
Retrieval of source code for client enabling commands
PCNFSD protocol
Accessing data with PCNFSD
Accessing z/OS UNIX files
Starting the PCNFSD server
Using supported PCNFSD protocols
Version 1 of the PCNFSD protocol
Procedure 0: do nothing
Procedure 1: perform user authentication
Version 2 of the PCNFSD protocol
Procedure 0: do nothing
Procedure 1: give descriptions
Procedure 12: perform mapping
Procedure 13: perform user authentication
SMF C and assembler header macros
SMF C header macro GFSASSMF
SMF assembler header macro GFSAUSMF
Capturing diagnostic information using z/OS NFS log data sets and from other components
Using log data sets
Server log data sets
Setting up the z/OS NFS server log data set
Client log data sets
Setting up the z/OS NFS client log data sets
Debug trace data capture
z/OS NFS server debug trace capture
z/OS NFS server DEBUG trace types
z/OS NFS client debug trace capture
Related component trace capture
z/OS UNIX System Services activity trace
z/OS hierarchical file system (HFS) physical file system activity trace
z/OS TCP/IP activity trace
AIX client activity trace
SUN client activity trace
z/OS dump
GFSAMHDJ sample code for creating NFS mount handle data sets and lock data sets
Setting up NFS functions with Kerberos Support
Setting up a Linux Client/Server with NFS Version 4 Kerberos Support
Windows recommendations and limitations
Setting up a Kerberos Key Distribution Center
Dotted decimal syntax diagrams
Glossary