Collecting NFS usage data

The z/OS NFS client does not produce any System Management Facilities (SMF) records. However, it does provide the accounting information to z/OS UNIX for SMF recording. z/OS in turn provides the SMF recording services for all physical file systems (PFSs).

The z/OS NFS server does not produce z/OS UNIX SMF records. However, z/OS UNIX provides the SMF recording services for all physical file systems (PFSs).

You can use the SMF records that the z/OS NFS server produces to keep track of how MVS z/OS conventional data sets are accessed, and how long each Network File System user session lasts. The z/OS NFS server writes the following SMF records:

Record type-42 subtype 7: This record, written when a file times out, provides the Network File System file usage statistics.
Record type-42 subtype 8: This record, written when a client user logs out of NFS, provides the Network File System user session statistics.
Record type-42 subtype 26: This record, written when a client creates, removes, or renames the file objects on the NFS mounted file system, provides the NFS Client’s information, the type of operation (create, remove, rename) and object descriptive information (depending on file system type: MVS or z/OS Unix). For z/OS Unix objects, the file system name, USS device number, object name, FID, and parent FID information are saved. If the pathname of an object is desired, it is recommended to enable SMF recording for USS Type 92 and RACF Type 80 records in order to derive this information. For MVS objects, the volume name, full data set name, and member name (if appropriate) are saved.

For records containing Internet Protocol (IP) Version 6 addresses, the z/OS NFS server writes a specific type of SMF record. This record type is indicated by a version number of 2 in the smf42psv record field. In these records, the IP address field (smf42cip) is expanded to hold the larger IP V6 address values. For details on these record fields, see SMF C and assembler header macros.

You can control the SMF data collection in the following ways:

You can use the smf site attribute, described in Site attributes syntax, to determine which, if any, SMF statistics are to be collected.
You can use the smf=on or smf=off operand of the modify command. See Smf operand for a description of this command, which turns SMF data collection on and off.
You can generate an SMF report. Use the SMF report sample routine, GFSAPSMF, that can be found in the NFSSAMP library.
You can use the SMF C and Assembler header macros. See SMF C and assembler header macros for copies of the C header macro, GFSASSMF, and the Assembler header macro GFSAUSMF. Both header macros contain the mapping for SMF records and can be found in the NFSMAC library.
Check the SMF setting in the system in SYS1.PARMLIB(SMFPRMnn) for the SMF record type and subtype, where nn is determined by IEASYSmm and the operator command (SET SMF=nn). The Network File System uses the SMF type 42 record, subtypes 7 and 8. You specify SMF=nn so the system picks the member of SMFPRM with suffix nn.

You can display the SMF settings with the d smf,0 operator command.

The SMF write macro, SMFWTM, is used to write the SMF records to the SMF data set. When the server starts, the SMF option is disabled. Therefore, the operator needs to explicitly enable the SMF collection.

For more information about SMF see z/OS MVS System Management Facilities (SMF).