Documentation Comments
Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.
Reality V15.2 Online Documentation (MoTW) Revision 3
HYPER-RECONCILE command (hyperreconcile.htm)
Reconciles a specific section, or all sections, of a hyper file by moving items to their correct sections.
TCL-I command.
HYPER-RECONCILE hyper-file-name {key-value|entry-no|*} {(options}
hyper-file-nameThe file-specifier of the hyper file.
key-valueSelects a hyper section by its corresponding key value in the lookup table.
entry-noSelects a hyper section by the offset of its entry in the lookup table. Entry numbers start at 1.
*Selects all hyper sections.
LSuppresses file locking on the hyper file (not recommended).
NReports any duplicate items but does not overwrite them.
OOverwrites any duplicate items without reporting them.
If you use the command with * as the second parameter, all hyper sections are selected.
If you use the command with a second parameter other than * the command first assumes that this is a key-value. If there no such key value in the lookup table, the command then tries it as an entry-no.
If the second parameter is neither a key value nor a valid entry number, or if you use the command without any second parameter, the lookup table is displayed and you are prompted for an entry number:
File table specified as:
1) key-value1 hyper-section-name1
2) key-value2 hyper-section-name2
3) key-value3 hyper-section-name3
...
Enter entry number of section ?
The command takes a lock on the hyper file (unless this is suppressed by the L option) and inspects the selected section, or sections, to check that all items are in their correct section. It moves each misplaced item to its correct section, unless a duplicate item by that name already exists in that section (the target section).
Finally, if there is a BIN section the command automatically reconciles that as well.
The N and O options determine how the command processes each duplicate item that it finds.
If neither the N nor the O option is used, you are prompted as follows:
If an older item is found in the target section:
An older item 'item-id' exists in 'hyper-section' Copy, Delete, Skip, Quit C/D/S/Q ?
If a newer item is found in the target section:
A newer item 'item-id' exists in 'hyper-section' Copy, Delete, Skip, Quit C/D/S/Q ?
In either case:
Enter C to copy the item from the source to the target section, overwriting the target item.
Enter D to delete the source item.
Enter S to leave both source and target items where they are, for later investigation.
Enter Q to quit the command.
If the N option is used, duplicate items are reported, but automatically skipped.
If the O option is used, duplicate items are not reported, and the target items are automatically overwritten.