This operand lists client NFS processes that hold
locks, share reservations or delegations for a specified file on the
z/OS Network File System server. The list of lock holders can be used
to diagnose problems with locking, share reservation or delegation
conflicts. The listlock operand lets you specify an MVS data set,
PDS or PDSE member, or z/OS UNIX file, and writes a message (GFSA791I
or GFSA792I) for each unique userid and client host pair that holds
locks, share reservations or delegations for it. Note that the currently
active prefix settings apply for determining whether a z/OS UNIX file
or an MVS data set is specified. The general command syntax is as
follows:
where
file_name
is the name of an MVS data set, z/OS UNIX file, PDS member, or
PDSE member. File names specified with a prefix must be specified
in single quotes with the prefix (/hfs or /mvs) followed by the z/OS
UNIX path name or the MVS data set name, respectively. For example,
if the HFS(/hfs) site attribute was specified, LISTLOCK='/hfs/u/user'
will indicate the z/OS UNIX file /u/user.
For an MVS data set, PDS member, or PDSE member:
If file_name references a z/OS conventional MVS data set
for the first time, message GFSA921I is issued.
If file_name references a PDS or a PDSE data set (that
does not include the member name), GFSA918I is issued.
If file_name references an invalid member name of a PDS
or a PDSE data set, GFSA919I is issued.
If file_name is found and there are no locks, share reservations
or delegations to list, message GFSA793I is issued.
When an NFS client closes a file, delegation is returned to the
NFS Server. Assuming there is no local user access request, the delegation
is kept by the NFS Server, and not returned to MVS. In this case,
message GFSA790I is issued.
For a z/OS UNIX file, if there are no locks to list, message
GFSA793I is issued.
If the specified file does not have any locks, message GFSA793I
is issued to report that no locks exist.
Since the lock information may only be reported to the server
log data set or component trace buffer, and not back to the console,
message GFSA794I is issued to indicate that the listlock function
completed successfully.
Response messages are sent to the console if there are 10 or fewer
locks to be reported. Otherwise, the response messages are only sent
to the NFS log data set.
Before reading the output of this command, you need to flush the
log using the flushlog operand.