HYPER-ADD

Adds a new section to an existing hyper file by updating the lookup table in the hyper file definition item (H-pointer).

Command class

TCL-I command.

Syntax

HYPER-ADD hyper-file-name {(options}

Syntax elements

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

Options

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

N When reconciling, reports any duplicate items but does not overwrite them.

O When reconciling, overwrites any duplicate items without reporting them.

Operation

The HYPER-ADD command prompts for the new key value and hyper section name, neither of which can be present in the lookup table already.

The new section is checked to ensure that it has the required indexes.

The hyper file is locked (unless this suppressed by the L option) and HYPER-RECONCILE is used to move eligible items into the new hyper section from the BIN section (if there is one) according to the N or O option (if specified).

Comments

If the hyper file uses a simple lookup table, HYPER-ADD can add a new section anywhere in the table, but for a range lookup table, HYPER-ADD can only add new sections to the end of the table. If you need to add a new section somewhere in the middle of a range lookup table, you must use HYPER-EDIT instead. Note that HYPER-EDIT does not auto-reconcile; you should therefore use HYPER-RECONCILE to ensure the hyper file remains consistent.

You are strongly recommended not to suppress file locking. If any other users have the hyper file open when its lookup table is modified they will not see the change until the file is closed and reopened again. This may result in inconsistencies in the hyper file.