List operand

This operand displays a list of either the mount points or the MVS data sets that are currently active in the Network File System. This command can be entered at any time for maintenance or diagnostic purposes. The path name output of an z/OS UNIX file object might require multiple console messages. Enter the operand as follows:


>>-+-MODIFY-+--mvsnfs,list=-+-mounts--+------------------------><
   '-F------'               '-dsnames-'

The mounts option returns a list of all mount points currently active in the system for NFSv2, NFSv3, and NFSv4 protocols. The list of active mount point names and their associated current use counts (NFSv2 and NFSv3 only) are displayed, along with the list of clients which have active mounts to the mount point. If available, a client's hostname is displayed; if not, the client's IP address is displayed. For example, in the following list entry, the mount point /HFS/U/BLUE has a current use count of 3, indicating that three clients are currently accessing it. The hostnames of the two of the clients are displayed, but the third client's hostname is unavailable, so its IP address is displayed instead.

GFSA910I /HFS/U/BLUE ACTIVE =3 hostname1 hostname2 9.1.22.73

Note: Because there could be a large number of mounts or hosts for a single mount, NFS limits the console display of this message to a maximum of approximately 10 lines of the response. The entire response is recorded in the NFS log data set. Message GFSA907I is displayed on the console if not all of the information is shown.

The list of clients is always less than or equal to the current use count that is displayed on the ACTIVE parameter; if the number of clients is less than the current use count, then one or more of the clients have multiple active mounts to the mount point.

Current use counts indicate how many mount requests have been made without an unmount request for the same mount point regardless to which local directory the mount is attached. For example, suppose the high-level qualifier JOHN is mounted to the same local directory 12 times without any unmount. ACTIVE =12 is shown. Now, suppose the high-level qualifier JOAN has been mounted to 15 different local directories but 5 of them have been unmounted. ACTIVE =10 is shown, as in the following example:

GFSA910I JOHN ACTIVE =12.
...
GFSA910I JOAN ACTIVE =10.
...

With the NFS version 4 protocol, the current active mounts are reflected for the mvsmnt and nomvsmnt processing attributes, NFSv4 HFS mounts issued from non z/OS NFS clients (such as AIX, Oracle and Linux)will not be reflected if no z/OS NFS server attributes are specified. In order for such mounts to be reflected, at least one z/OS NFS server attribute must be explicitly specified. If an NFSv4 HFS mount request includes a symbolic link in the path name and the request fails with NFSERR_NOENT error (No such file or directory), the result may be an erroneous NOMVSMNT display for LIST=MOUNTS. This can result when the MVS HLQ matches the z/OS UNIX file system prefix.

The current MVSMNT parameter reflects only mounts specified with the mvsmnt processing attribute, as in the following example:

GFSA910I MIKE MVSMNT.

The current NOMVSMNT parameter reflects only mounts specified without the mvsmnt processing attribute, as in the following example:

GFSA910I BILL NOMVSMNT.

The dsnames option returns a list of all data sets that are currently active. Currently active means that the data set is either in use or has been opened for accessing but has not been closed due to timeout even though the file is not in use. A list of data sets and data set members such as these display.

GFSA912I CHRIS.TEST.
GFSA912I SMITH.PAYROLL(JULY).
GFSA912I /HFS/U/PAYROLL.

z/OS UNIX file names are truncated after 126 characters.