NAME

sfsadmin list ofds - displays information about open file descriptors (OFDs) managed by the specified server

SYNOPSIS

sfsadmin list ofds -server servername [-brief]

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. 

[-brief] Requests an abbreviated display of OFD information. 

DESCRIPTION

The sfsadmin list ofds command displays information about the open file descriptors (OFDs) managed by a server. The -brief option displays only the server identification number for each OFD and the file name. 

EXAMPLE

The following command displays information about the OFDs managed by the server /.:/branch1/server/sfs1.  Note that the Inventory file is being accessed by several OFDs. 

% sfsadmin list ofds -server /.:/branch1/server/sfs1

Ofd id: 33
        File name: Inventory
        Owner: (null)
        Open time: Mon Oct 18 11:12:04 1993
        Transaction id: 0
        Number of rpcs: 139
        Access mode: shared access
        Authority:
                read file
                inquire file
        Consistency: non-transactional
        Isolational level: non-tran accumulate
        Operation timeout: 20
        Auto close: no
        Duplicate detection: no detection
        Operational force: no
        Label: (null)
        Open transaction id: 40
        Ofd idle timeout: 60

Ofd id: 38
         File name: Inventory
         Owner: (null)
         Open time: Mon Oct 18 11:17:37 1993
         Transaction id: 65717
         Number of rpcs: 1
         Access mode: shared access
         Authority:
                 insert file
                 inquire file
         Consistency: transactional
         Isolational level: serializability
         Operation timeout: 30
         Auto close: yes
         Duplicate detection: current index
         Operational force: yes
         Label: (null)
         Open transaction id: 65717
         Ofd idle timeout: 60

Ofd id: 39
         File name: Accounts
         Owner: (null)
         Open time: Mon Oct 18 11:22:08 1993
         Transaction id: 65785
         Number of rpcs: 35
         Access mode: exclusive access
         Authority:
                 read file
                 insert file
                 update file
                 delete file
                 inquire file
                 exclusive file
                 administer file
         Consistency: transactional
         Isolational level: cursor stability
         Operation timeout: 45
         Auto close: no
         Duplicate detection: no detection
         Operational force: yes
         Label: (null)
         Open transaction id: 65780
         Ofd idle timeout: 60

OUTPUT

The following list explains the elements in the output of the sfsadmin list ofds command:

ofd id is the identification number used by the server for the OFD. 

File name is the name of the SFS file. 

Owner indicates the owner of the file. 

Open time indicates the time that the file was opened. 

Transaction id refers to the identification number of the transaction associated with the OFD, if the OFD is transactional. If the OFD is nontransactional, this identification number is zero. 

Number of rpcs refers to the number of RPCs completed using this OFD. 

Access mode can be either shared or exclusive. An access modedetermines whether other applications can simultaneously access a file. A shared access modeallows more than one application to obtain access to a file at the same time. An exclusive access modeallows only one application to obtain access to a file at a time. 

Authority lists the actions that can be performed using this OFD. An authorityis a permission to perform an operation on a file. For example, a client may have permission to perform “read” and “insert” operations. 

Consistency refers to the type of consistency for the OFD. 

Isolation level refers to the extent to which data being accessed by the OFD is protected from concurrent access by other users. An isolation levelis the degree to which operations on a file are isolated from other operations on the same file. The isolation level determines the locking policy used. 

Operation timeout refers to the maximum time, in seconds, that an operation using this OFD will take to complete before timing out. 

Auto close refers to whether or not a transactional OFD will be automatically closed when the transaction is resolved. If the OFD is nontransactional, this field will be “no” (nontransactional OFDs must be closed manually). 

Duplicate detection specifies the degree of duplication detection performed by the server on a unique index. 

Operational force applies only to nontransactional OFDs and refers to whether or not the server forces the result of an operation to be permanent after each operation. 

Label is the user-defined string for the OFD. 

Open transaction id is the identification number of the transaction that holds the open access mode lock (shared/exclusive). 

Ofd idle timeout is the time, in seconds, that an OFD may be permitted to be idle while waiting for an SFS call.  If this time period has elapsed, and another OFD requests a lock held by the idle OFD, the transaction associated with the idle OFD is terminated, closing the OFD and releasing the lock. 

PRIVILEGE REQUIRED

Encina SFS query (Q) permission on the server

RELATED INFORMATION

sfsadmin query ofd

sfsadmin terminate ofd

  —  March 1997