NAME

sfsadmin terminate ofd - closes the specified open file descriptor

SYNOPSIS

sfsadmin terminate ofd -server servername serverofdid

ARGUMENTS

-server servername Specifies the name of the file server. The name must be registered with the DCE Directory Service. If the -server option is not specified, the default is the server defined by the environment variable ENCINA_SFS_SERVER. 

serverofdid Specifies the integer that identifies the open file descriptor (OFD) associated with the file to be closed. This number can be obtained by using the sfsadmin list ofds command. 

DESCRIPTION

A file may become unavailable if it is not appropriately closed.  For instance, if a client of an SFS server terminates abnormally, files that were exclusively opened by the client may remain open, preventing access by other users. You can use the sfsadmin list ofds command to determine currently open OFDs for a server. Then, you can force an OFD to close so that the file opened with that OFD can be accessed by others. The sfsadmin terminate ofd command forces an OFD to close. 

When an OFD is forced to close, any in-progress transaction using that OFD will be aborted. The client application owning the transaction will receive a “Transaction Aborted” error on the next operation using that OFD and any further attempts to use that OFD will generate an “OFD Invalid” error. 

EXAMPLE

The following command forces OFD 3 to close:

% sfsadmin terminate ofd 3

PRIVILEGE REQUIRED

Encina SFS administer (A) permission on the server

RELATED INFORMATION

sfsadmin query ofd

sfsadmin query tranlock

sfsadmin list ofds

  —  March 1997