modulo.def

Definition/General, Releases: AP and R83

The number of groups allocated as the primary space of a file.

Description

designates the number of groups (measured in frames) in the primary file space, as indicated during the creation or reallocation of the file.

The modulo is always an integer remainder in the range 0 to modulo-1. The formula to determine the frame number of the initial frame of the group where the item is located is: fid=base+(item.id/modulo). This initial frame number is commonly called the 'base fid'.

The modulo of a file is a critical component of the 'hashing' algorithm access method. It should never be altered in any file-defining item, as this can cause such problems as gfe's to appear.

During the full or account-restore processes, files are resized according to the optional modulo found in the 'reallocation' attribute (attribute 13) of the file-defining item. After changing to the new modulo, all items must be re-hashed before they are replaced. This can cause restore processes (also t-load and copy) to run considerably slower.

See Also

Command Name Type Description
hashing Definition Pick's retrieval algorithm.
tcl.create-file Verb: Access Creates a new file.
tcl.item Verb: Access Displays group to which item hashes.
modulo Attribute Defining Item References attribute 3 of the current item.
hashing Definition Pick's retrieval algorithm.
item-id Definition The key to an item.
access.t-load Verb: Access Loads data from t-dump format magnetic media.
full.restore Definition A total reload of the file system.
gfe.handler Definition Description of GFE handler.
primary.file.space Definition The number of groups allocated to a file.
linked.overflow Definition Additional frames attached to a file's primary file space.
frame Definition Description of a frame.
group Definition Statistical gathering of frames in a file.
tcl.resize Verb: Access resizes a file to the desired modulo.
tcl.f.modulo Verb: Access prompts for estimated file characteristics.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.