In this section:
The Rebuild utility provides a number of useful project management utilities. Rebuild enables you to restructure data sources, rebuild indexes, and check the integrity of data sources.
Note: You can only use this utility with FOCUS data sources.
To open the Rebuild dialog box:
The Rebuild dialog box opens, as shown in the following image.
This option can be used to perform the following functions:
Builds or rebuilds the index for the specified field. Use this option to index an additional field that was not originally specified as an index field or to change the index for a field. See Rebuilding the Index.
Checks the structural integrity of a data source. If FOCUS encounters an error during the check, it displays a message. For more information, see Checking the Integrity of a Data Source.
This option in the Rebuild dialog box enables you to:
INVOICE_DATE GT 990101
FOCUS will omit invoices earlier than 99/01/01 from the rebuilt data source.
When you first create a Master File in the Synonym Editor, you specify the fields that you want indexed. Sometimes, after data is entered, you may need to index an additional field that was not originally specified as an index field.
The first step is to alter the Master File to indicate that the field should be indexed. Altering the Master File does not actually create the index. To do this, you must use the Rebuild utility after you index a field.
From the Synonym Editor, select the field to be indexed, and then click the I - Index check box under the FIELDTYPE attribute.
Open and edit the Master File as text in the Text Editor. For instructions on indexing a field as text, see the Describing Data With WebFOCUS Language manual.
After you index a field you must rebuild the index. See How to Rebuild the Index.
To index all the fields designated as index fields in that data source, type an asterisk (*) in the Field to Index box.
The Rebuild utility rebuilds the data source, creating an index for all specified fields.
For more information on indexing fields, see the Describing Data With WebFOCUS Language manual.
It is rare for the structural integrity of a FOCUS data source to be damaged. Structural damage will occasionally occur, however, during a disk drive failure or if an incorrect Master File is used. In this situation, you can check the integrity of the Master File. Checking the integrity of a Master File performs the following essential tasks:
While checking the integrity reports on a good deal of data that would otherwise be lost, it is important to remember that backing up your FOCUS data sources frequently is the best method for preventing data loss.
Checking the Master File integrity will occasionally fail to uncover structural damage. If you have reason to believe that there is damage to your data source, though results from checking the integrity indicates otherwise, there is a second method of checking file integrity. This method uses the ? FILE and TABLEF commands. For more information, see the Describing Data With WebFOCUS Language manual.
In the Rebuild dialog box, select Check the integrity of a file.
If the Rebuild utility encounters an error during the check, it logs a message for you. You should then attempt to recover as much of the data source as possible or restore it from a backup.