access.hash-test Verb: Access/Access: Verbs

access.hash-test

Command access.hash-test Verb: Access/Access: Verbs
Applicable release versions: AP, R83
Category Access: Verbs (152)
Description produces a "histogram", or graphic representation of item-id distribution within a given file, according to a "test" modulo provided. The command is useful when performing file reallocation providing insight into how the item-ids hash into the file, as well as providing a suggested modulo.
Syntax hash-test file.reference {itemlist} {sellist} {(options)}
test modulo:modulo <return>
Options * see "options: Access".

s Displays summary statistics only.
Example
hash-test testfile<return>
test modulo: 3<return>

file= testfile     modulo= 3        10:07:24 03 Mar 1992
frames  bytes items
1    444    1 *>
1    772    2 *>>
1   1742    2 *>>
3

Hash-Test/Istat Statistics
total item count =     5        byte count =  2958
avg. bytes/item  = 591.6  avg. items/group =   1.6
std. deviation   =    .5  avg. bytes/group = 986.0
suggested modulo =     3

This file has three groups, a total of five items. Each ">" 
("hash mark") indicates an item.
Purpose
Related file.reference
access.verbs
tcl.item
access.istat