Release File System Locks (RLSIFSLCK)

Where allowed to run: All environments (*ALL) Threadsafe: No

Parameters Examples Error messages

The Release File System Locks (RLSIFSLCK) command can be used to release all Network File System (NFS) byte-range locks held by a specified NFS client, or to release all byte-range locks (of any type) held on a specified object. This command should only be used to free resources that cannot be freed using normal means.

For more information about byte range locks, see the fcntl API in System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter or Network File System book, SC41-5714

Restrictions:

1. The user must have input/output (I/O) system configuration (*IOSYSCFG) special authority to use this command.

2. The user must have execute (*X) authority to the directories in the path name prefixes.

3. The user must have read (*R) authority to the object whose locks are being released.

Top

---

 

Parameters

Keyword	Description	Choices	Notes
RMTLOCNAME	Remote location	Character value	Optional, Positional 1
OBJ	Object	Path name	Optional, Positional 2

Top

 

Remote location (RMTLOCNAME)

Specifies the host name or internet address of a remote system whose NFS-related locks on local files are to be released.

To be successful, the remote system name must be valid. The user can assign host names to an internet address with the Work with TCP/IP host table entries option on the Configure TCP/IP menu (CFGTCP) command. Also, a remote name server can be used to map remote system names to internet addresses. Use the Change remote name server option on the CFGTCP menu to specify a remote name server.

Host names must follow these conventions:

• The first character must be either A through Z or 0 through 9.

• The last character must be either A through Z or 0 through 9.

• Uppercase and lowercase characters are allowed, but no significance is attached to the case.

• Blanks ( ) are not allowed.

• The special characters, period (.) and minus (-), are allowed.

• Parts of the name separated by periods (.) cannot exceed 63 characters in length.

• Names must be from 1 to 255 characters in length.

'remote-location-name'

Specifies the host name or internet address of a remote system whose NFS-related locks on local files are to be released.

Either the RMTLOCNAME or Object (OBJ) parameter must be specified, but not both.

Top

 

Object (OBJ)

Specifies the path name of an object on which all byte-range locks are to be released. This will release all locks on that object, regardless of the type of lock or the type of process that is holding them.

'path-name'

Specifies the path name of the local object for which all locks are to be released.

For more information on specifying path names, refer to "Object naming rules" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.

Either the Remote location (RMTLOCNAME) or OBJ parameter must be specified, but not both.

Top

---

 

Examples

Example 1: Releasing Locks for a Remote System

 RLSIFSLCK   RMTLOCNAME('rainbow1')

This command releases the NFS-related locks held on local files by the system named rainbow1.

Example 2: Releasing Locks for a Local Object

 RLSIFSLCK   OBJ('/CustAccounts/May')

This command releases all byte-range locks held on the object /CustAccounts/May.

Top

---

 

Error messages

*ESCAPE Messages

CPFA09C

Not authorized to object. Object is &1.

CPFA0A9

Object not found. Object is &1.

CPFA0B6

TOOBJ parameter is not allowed with a pattern in OBJ for CPY.

CPFA1B8

*IOSYSCFG authority required to use &1.

Top