z/OS Network File System Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Displaying client and server statistical information–nfsstat

z/OS Network File System Guide and Reference
SC23-6883-00

Use the nfsstat command to display the NFS client and server statistical information, to reset the statistical information to zero, to display NFS mount point information, or to set the debug status.

The following nfsstat command displays the NFS and RPC statistics for the NFS client:

nfsstat -c       
The following nfsstat command resets the NFS and RPC statistics for the NFS server and client to zero. Only the root user may use this option:
nfsstat -z       
You may also use this command as follows:
  • To only reset the client side statistics, use nfsstat -cz
  • To only reset the z/OS NFS server(s) side statistics , use nfsstat -sz
The following nfsstat command displays the RPC statistics of both the NFS Client and the NFS server(s):
nfsstat -r       
You may also use this command as follows:
  • To only display the client side RPC statistics, use nfsstat -cr
  • To only display the server(s) side RPC statistics , use nfsstat -sr
The following nfsstat command displays the NFS statistics of both the NFS Client and the NFS server(s):
nfsstat -n       
You may also use this command as follows:
  • To display the NFS statistics of only the client, use nfsstat -cn
  • To display the NFS statistics of only the server(s), use nfsstat -sn
To display NFS version-specific information, use the following values with an nfsstat command option:
2
NFS version 2
3
NFS version 3
4
NFS version 4
For example, to display the NFS version 3 statistics of the z/OS NFS Client and the z/OS NFS server(s), enter:
nfsstat 	-cs3 

Figure 1 displays both z/OS NFS Server and Client NFSv3 statistics, assuming that the LPAR has one z/OS NFS Server (with the StartUpProcedure name of MVSNFS) and one z/OS NFS Client.

Figure 1. Displaying NFS Server and Client NFSv3 statistical information
$ /usr/lpp/NFS/nfsstat -3      
                                                                                
GFSC857I z/OS Network File System Server : (MVSNFS)                           
                                                                                
Server NFSv3:                                                                   
calls           badcalls                                                        
20019           0                                                               
null            getattr         setattr         lookup          access          
0           0%  0           0%  753         4%  9123       45%  2424       12%  
readlink        read            write           create          mkdir           
208         1%  1058        5%  941         5%  488         2%  118         0%  
symlink         mknod           remove          rmdir           rename          
312         1%  0           0%  1214        6%  119         0%  725         4%  
link            readdir         readdirplus     fsstat          fsinfo          
412         2%  419         2%  0           0%  1508        7%  1           0%  
pathconf        commit                                                          
1           0%  195         1%                                                  
                                                                                
GFSC857I z/OS Network File System Client :                                      
                                                                                
Client NFSv3:                                                                   
calls           badcalls                                                        
20035           0                                                               
null            getattr         setattr         lookup          access          
0           0%  0           0%  754         4%  9124       45%  2427       12%  
readlink        read            write           create          mkdir           
208         1%  1058        5%  948         5%  488         2%  118         0%  
symlink         mknod           remove          rmdir           rename          
312         1%  0           0%  1214        6%  119         0%  725         4%  
link            readdir         readdirplus     fsstat          fsinfo          
412         2%  419         2%  0           0%  1509        7%  2           0%  
pathconf        commit                                                          
2           0%  196         1%                                                  
Unicode Support service is used.                                                                                      
Figure 2 shows the output from the nfsstat command using the -r option to display the remote procedure call (RPC) statistics for the NFS client.
Figure 2. Displaying NFS client rpc statistical information
USER1:/u/user1:> nfsstat -r                                            
Client rpc:                                                          
calls           badcalls        retrans         timeout         qfull
107             0               0               0               0    
lossconn                                                             
0                                                                    
                                                                     
Unicode Support service is used.                                     

In this example:

Operand
Description
calls
Specifies the total number of RPC calls sent.
badcalls
Specifies the total of RPC calls rejected by a server.
retrans
Specifies the number of times an RPC call had to be retransmitted.
timeout
Specifies the number of times an RPC call timed out.
qfull
specifies the number of times an RPC call had to be delayed due to insufficient resources.
lossconn
specifies the number of times an RPC call had to be retransmitted on a new TCPIP connection.

Figure 3 shows the output from the nfsstat command using the -nc option to display the NFS statistics for the NFS client.

Figure 3. Displaying NFS client NFS statistical information
USER1:/u/user1:> nfsstat -nc                                                       
                                                                                
Client NFSv2:                                                                   
calls           badcalls                                                        
71              0                                                               
null            getattr         setattr         root            lookup          
0           0%  1           1%  0           0%  0           0%  68         96%  
readlink        read            writecache      write           create          
0           0%  0           0%  0           0%  0           0%  0           0%  
remove          rename          link            symlink         mkdir           
0           0%  0           0%  0           0%  0           0%  0           0%  
rmdir           readdir         fsstat                                          
0           0%  1           1%  1           1%                                  
                                                                                
Client NFSv3:                                                                   
calls           badcalls                                                        
10              0                                                               
null            getattr         setattr         lookup          access          
0           0%  0           0%  0           0%  0           0%  0           0%  
readlink        read            write           create          mkdir           
0           0%  0           0%  0           0%  0           0%  0           0%  
symlink         mknod           remove          rmdir           rename          
0           0%  0           0%  0           0%  0           0%  0           0%  
link            readdir         readdirplus     fsstat          fsinfo          
0           0%  0           0%  5          50%  3          30%  1          10%  
pathconf        commit                                                          
1          10%  0           0%                                                  
                                                                                
Client NFSv4:                                                                   
calls           badcalls                                                        
18              0                                                               
null            access          close           commit          create          
0           0%  2           5%  0           0%  0           0%  0           0%  
delegpurge      delegreturn     getattr         getfh           link            
0           0%  0           0%  9          21%  4           9%  0           0%  
lock            lockt           locku           lookup          lookupp         
0           0%  0           0%  0           0%  4           9%  0           0%  
nverify         open            openattr        open_cfm        downgrade       
2           5%  0           0%  0           0%  0           0%  0           0%  
putfh           putpubfh        putrootfh       read            readdir        
12         28%  0           0%  2           5%  0           0%  4           9% 
readlink        remove          rename          renew           restorefh      
0           0%  0           0%  0           0%  0           0%  0           0% 
savefh          secinfo         setattr         setclid         clid_cfm       
0           0%  0           0%  0           0%  2           5%  2           5% 
verify          write           rlse_lockowner                                 
0           0%  0           0%  0           0%                                 
                                                                               
Unicode Support service is used.                                               

In this example:

Operand
Description
calls
Specifies the total number of NFS calls sent.
badcalls
Specifies the total of NFS calls rejected by a server.

Figure 4 shows the output from nfsstat command using the -s option to display ALL of the z/OS NFS Server (RPC, NFSv2, NFSv3, NFSv4) statistical information.

Figure 4. Displaying all of the z/OS NFS Server (RPC, NFSv2, NFSv3, NFSv4) statistical information
# /usr/lpp/NFS/nfsstat -s        
                                                                               
GFSC857I z/OS Network File System Server : (MVSNFS)                          
Server RPC:                                                                    
calls           badcalls        nullrecv        badlen          xdrcalls       
69130           0               0               0               0              
dupreqs                                                                        
0                                                                              
                                                                               
Server NFSv2:                                                                  
calls           badcalls                                                       
26678           0                                                              
null            getattr         setattr         root            lookup         
0           0%  3519       13%  264         1%  0           0%  9616       36% 
readlink        read            writecache      write           create         
208         1%  4148       15%  0           0%  3647       14%  487         2% 
remove          rename          link            symlink         mkdir          
1212        4%  724         3%  412         1%  312         1%  118         0% 
rmdir           readdir         fsstat                                         
119         0%  388         1%  1504        6%                                 
                                                                               
Server NFSv3:                                                                  
calls           badcalls                                                       
20019           0                                                              
null            getattr         setattr         lookup          access         
0           0%  0           0%  753         4%  9123       45%  2424       12% 
readlink        read            write           create          mkdir          
208         1%  1058        5%  941         5%  488         2%  118         0% 
symlink         mknod           remove          rmdir           rename         
312         1%  0           0%  1214        6%  119         0%  725         4% 
link            readdir         readdirplus     fsstat          fsinfo         
412         2%  419         2%  0           0%  1508        7%  1           0% 
pathconf        commit                                                         
1           0%  195         1%                                                 
                                                                               
Server NFSv4:                                                                  
calls           badcalls                                                       
22433           0                                                              
null            access          close           commit          create         
0           0%  8109        8%  1039        1%  189         0%  430         0% 
delegpurge      delegreturn     getattr         getfh           link           
0           0%  0           0%  28423      30%  9559       10%  412         0% 
lock            lockt           locku           lookup          lookupp        
1028        1%  59          0%  1038        1%  7878        8%  145         0% 
nverify         open            openattr        open_cfm        downgrade      
2707        3%  1041        1%  0           0%  6           0%  0           0% 
putfh           putpubfh        putrootfh       read            readdir        
22843      24%  0           0%  1           0%  1138        1%  1686        2% 
readlink        remove          rename          renew           restorefh      
208         0%  1331        1%  724         1%  1           0%  1334        1% 
savefh          secinfo         setattr         setclid         clid_cfm       
2054        2%  0           0%  752         1%  1           0%  1           0% 
verify          write           rlse_lockowner                                 
0           0%  1180        1%  15          0%                                 
cb_null         cb_compound     cb_getattr      cb_recall                      
0           0%  0           0%  0           0%  0           0%                                            

Figure 5 shows the output from the nfsstat command using the -m option to display the server and path name of each NFS mounted file system.

Figure 5. Displaying NFS mounted file system information
# nfsstat   -m                                                                                                   
                                                                                                                 
mvshost1:"/hfs/sj/sjpl" is mounted on /sj/sjpl/host1 filesystem NFS_MNT1                                           
mvshost1:"/hfs/sj/sjpl2" is mounted on /sj/sjpl/host2 filesystem NFS_MNT2    

Figure 6 shows the output from the nfsstat command using the -m option to display the server name, path name, and attributes of mount point /mnt using the version 3 protocol with secure(upd).

Figure 6. Displaying NFS mounted file system information with secure(upd) (Versions 2 and 3 protocol only )
# tso -t "mount type (NFS) filesystem(nfs1) mountpoint('/mnt') parm('mvshost1:/hfs/home/hain,secure(udp),vers(3)')"
                                                                                                                 
mount type (NFS) filesystem(nfs1) mountpoint('/mnt') parm('mvshost1:/hfs/home/hain,secure(udp),vers(3)')           
                                                                                                                 
# nfsstat   -m  /mnt                                                                                             
                                                                                                                 
server  mvshost1                                                                                                   
path    /hfs/home/hain,secure(udp),vers(3)                                                                       
                                                                                                                 
hard            vers(3)         proto(udp)      secure(udp)                                                      
timeo(7)        retrans(3)      rpcbind(y)      accesschk(y)                                                     
delim(NA)       xlat(n)         cln_ccsid(1047) srv_ccsid(819)                                                   
convserv(LRE)   stringprep(n)   llock(y)                                                                         
rsize(32768)    wsize(32768)    readahead(8)    delaywrite(16)                                                   
acregmin(3)     acregmax(60)    acdirmin(30)    acdirmax(60)                                                     
datacaching(y)  attrcaching(y)  retry(10)       dynamicsizeadj(y) 
                                 

Figure 7 shows the output from the nfsstat command using the -m option to display the server name, path name, and attributes of mount point /mnt using the version 4 protocol with a public mountpoint.

Figure 7. Displaying NFS mounted file system information with public mountpoint (Version 4 protocol only )
# tso -t "mount type(NFS) filesystem(nfs1) mountpoint('/mnt') parm('sjvm5151:/hfs/u/public,public')"  
mount type(NFS) filesystem(nfs1) mountpoint('/mnt') parm('sjvm5151:/hfs/u/public,public')             

# /usr/lpp/NFS/nfsstat -m /mnt                                                                        
server  sjvm5151                                                                                      
path    /hfs/u/public,public                                                                          
                                                                                                      
hard    public  vers(4)         proto(tcp)                                                            
timeo(7)        retrans(3)      rpcbind(y)      accesschk(y)                                          
delim(NA)       xlat(n)         cln_ccsid(1047) srv_ccsid(819)                                        
convserv(LRE)   stringprep(n)   llock(n)                                                              
rsize(32768)    wsize(32768)    readahead(8)    delaywrite(16)                                        
acregmin(3)     acregmax(60)    acdirmin(30)    acdirmax(60)                                          
datacaching(y)  attrcaching(y)  retry(10)       dynamicsizeadj(y) 

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014