HYPER-EDIT

Edits a hyper file by updating the hyper file definition item (H-pointer).

This command is intended to be used only when initially defining a hyper file; that is, after using HYPER-CREATE but before the hyper file is actually used. It can be used, for example, to correct any mistakes made during the hyper file's creation.

Using HYPER-EDIT on a hyper file that has been in use is not recommended, as it is easy to break its consistency.

Command class

TCL-I command.

Syntax

HYPER-EDIT 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).

Operation

The HYPER-EDIT command summarises what has been specified so far, including the lookup table, and gives you the opportunity to change anything, for example:

   0) Data def: BY item-id (H
      Right justified
      Ascending
      Item-lock using Hyper File as container

File table specified as:

   1) key-value1  hyper-section-name1 
   2) key-value2  hyper-section-name2 
   3) key-value3  hyper-section-name3
      ...
   N) BIN  bin-section-name

Enter field number to change or A to Add, D to Delete ?

The command offers a series of prompts similar to those displayed by the HYPER-CREATE command.

You can change the data definition item used to generate hyper keys as well as other aspects of the hyper file including item and update locks. You can also change the lookup table by editing, adding and deleting entries within it (that is, key value/section name pairs). Finally, you can change the BIN section, if any.