NAME

sfsadmin set recordlimit - resets the maximum number of records permitted in the specified file

SYNOPSIS

sfsadmin set recordlimit -server servername filename nrecords

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. 

filename Specifies the name of the file for which a record limit is being set. 

nrecords Specifies the number of records permitted in the file. 

DESCRIPTION

The SFS permits the following maximum number of records in SFS files:

For entry-sequenced files: 236-10 records. 

For relative files: 232-10 records. 

For clustered files: 264-10 records. 

The sfsadmin set recordlimit command resets the maximum number of records in the specified file. You can set the maximum number of records in a file to a value that is lower than the number of records currently in the file. However, subsequent attempts to insert a record into that file may fail:

For entry-sequenced files, attempts to insert a record will always fail unless space occupied by deleted records is freed by reorganizing the file. 

For relative files, attempts to insert a record will fail when the inserted record would occupy a slot whose number is greater than the value to which the record limit is set. 

For clustered files, attempts to insert a record will fail until the number of records in the file drops below the new record limit. 

EXAMPLE

The following command limits the number of records in the file Inventory to 1500:

% sfsadmin set recordlimit Inventory 1500

PRIVILEGE REQUIRED

Encina SFS administer (A) and exclusive open (E) permissions on the file

RELATED INFORMATION

sfsadmin create clusteredfile

sfsadmin create relativefile

sfsadmin create sequentialfile

sfsadmin expand file

  —  March 1997