HYPER-RECONCILE

Reconciles a specific section, or all sections, of a hyper file by moving items to their correct sections.

Command class

TCL-I command.

Syntax

HYPER-RECONCILE hyper-file-name {key-value|entry-no|*} {(options}

Syntax elements

hyper-file-name The file-specifier of the hyper file.

key-value Selects a hyper section by its corresponding key value in the lookup table.

entry-no Selects a hyper section by the offset of its entry in the lookup table. Entry numbers start at 1.

* Selects all hyper sections.

Options

L Suppresses file locking on the hyper file (not recommended).

N Reports any duplicate items but does not overwrite them.

O Overwrites any duplicate items without reporting them.

Operation

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.

Processing of duplicate items

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.