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


Release operand

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

This operand forces the Network File System to close and deallocate the MVS data set or PDS/PDSE member specified. Any locks which exist will also be released and any waiting locks for the data set or member will be cancelled. Any waiting byte range lock requests (for the specified data set) will be purged. File share reservations will also be released.

For a z/OS UNIX file, any locks held will be released and any waiting locks will be canceled. 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. Note that the currently active prefix settings apply for determining whether a z/OS UNIX file or an MVS data set is specified. The command syntax is as follows.
Attention: The NFS and NLM protocols do not provide any means for the NFS server to notify the NFS client that the file (or MVS data set) and associated locks have been released. Use of the RELEASE command can lead to data corruption because the NFS client will be unaware of the fact that its file and locks are no longer held. This command should only be used as a last resort when it is not possible to release the file any other way.

NFS v4 Delegation: The Release operand initiates the recall of any delegations associated with the file. This is done asynchronously. The release command completes immediately, not waiting for the recall to complete. If an NFS client has a write delegation, it is the client's responsibility to properly recover from the stale file error received when the client attempts to write back any modified buffers. Enter the operand as follows:

Read syntax diagramSkip visual syntax diagram
>>-+-MODIFY-+--mvsnfs,release=data_set_name-+----------+-------><
   '-F------'                               '-(member)-'   

where

data_set_name
is the name of an MVS data set or a z/OS UNIX file. If data_set_name references a PDS or a PDSE data set and does not include the member name, a syntax error will result.
For z/OS UNIX file names, specify the release operand as follows:
f mvsnfs,release='/hfs/u/jones' (hfs path specified in quotes)
For MVS data sets, specify the release operand as follows:
f mvsnfs,release=data_set_name (MVS data set name not specified in quotes)
  • If the object you specify is active, you receive a message as follows.
    GFSA914I data.set.name(member) DEALLOCATED.    
  • If the object you specify is not active, you receive a message as follows.
    GFSA915I data.set.name(member) NOT ALLOCATED.    

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014