Datatid 1999 #6/Datatid_1999-06.iso/internet/Tango352Promo/P.SQL/PTKPKG.1/OS2RBLD.HLP

OS/2 Help File | 1998-09-30 | 8.8 KB | 242 lines

ΓòÉΓòÉΓòÉ 1. Help Contents ΓòÉΓòÉΓòÉ

The following Help Topics are available:

Main Window
Provides general information about the Rebuild utility.

Select Files Dialog
Lets you specify the files you want to rebuild.

Settings Dialog
Lets you  view and change the current settings for the Rebuild utility.

Start Rebuild Dialog
Displays a list of files to rebuild. Press the Start button to invoke the
rebuild process.

View Status File Dialog
Lets you view the status file created during the rebuild process.

About Dialog
Provides product information about the Rebuild utility.

 For Help on Help, press F1


ΓòÉΓòÉΓòÉ 2. Main Window ΓòÉΓòÉΓòÉ

The Rebuild utility can convert MicroKernel data files as shown in the table
below.

ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéOriginal  ΓöéConverted ΓöéReason for Conversion              Γöé
ΓöéFile      ΓöéFile      Γöé                                   Γöé
ΓöéFormat    ΓöéFormat    Γöé                                   Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöépre-v6.0  Γöév7.x      ΓöéTake advantage of v7.x features andΓöé
Γöé          Γöé          Γöéimprove general performance.       Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöév6.x      Γöév7.x      ΓöéTake advantage of v7.x features andΓöé
Γöé          Γöé          Γöéimprove general performance.       Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöév7.x      Γöév7.x      ΓöéOriginal file does not have a      Γöé
Γöé          Γöé          Γöésystem key.                        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöépre-v6.0  Γöév6.x      ΓöéTake advantage of v6.x features andΓöé
Γöé          Γöé          Γöéimprove general performance. Use   Γöé
Γöé          Γöé          Γöéthis option only if you are still  Γöé
Γöé          Γöé          Γöérunning the v7.x engine with other Γöé
Γöé          Γöé          Γöév6.x engines.                      Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ

The file format that results from the conversion depends on the value you set
for the MicroKernel's Create File Version configuration option, which you
specify using the Setup utility. For example, if you set the Create File
Version to 7.x and you run the Rebuild utility on v6.x files, the utility
converts the files to v7.x format.

Before you run the Rebuild utility, back up all the data files you plan to
convert. Having backup copies ensures against data loss if a power interruption
occurs while you are running the utility.

To ensure that your backup is successful, perform any one of the following
operations:

 - Close all data files before running the backup utility.

 - Use continuous operations.

 - Use a backup utility that opens the files in exclusive write mode so that
other processes cannot write to the files. Ensure that the backup utility has
exclusive rights to the files.

Once you have backed up your files, from the Options menu select the  Settings
Dialog to configure the settings that determine how the file will be rebuilt.
Then choose the  Select Files Dialog to add all the files you would like to
rebuild.  After you have made these selections, you are ready to begin the
rebuild process.  From the Run menu choose the  Start Rebuild Dialog and select
the Start button.  When the process completes, select the  View Status File
Dialog from the Run menu.


ΓòÉΓòÉΓòÉ 3. Select Files Dialog ΓòÉΓòÉΓòÉ

To select files to rebuild, click the Add... button. Use the Browse dialog to
locate the files you want to rebuild. To delete a file from the list of
selected files, highlight the file and click Delete.

You will have a chance to view this list of files again on the  Start Rebuild
Dialog prior to starting the rebuild process.

Add Button
Displays a Browse dialog that lets you select the files you want to rebuild.

Delete Button
Deletes the currently selected file from the Selected Files list.

OK Button
Saves the set of files in the Selected Files list.

Cancel Button
Closes without saving any changes.

Help Button
Displays help for this dialog.


ΓòÉΓòÉΓòÉ 4. Settings Dialog ΓòÉΓòÉΓòÉ

The Settings Dialog contains configuration parameters for the utility. The
items are explained in more detail below.

Output Directory
Specifies an alternate location for the rebuilt files. (The default location is
the current directory of the original file being rebuilt.) This option lets you
rebuild large files on a different volume or on a different server. The
MicroKernel and its communications components must be loaded on the server that
contains the rebuilt files. Do not use wildcard characters in the path.

If the Output Directory location is different than the original files location,
the original file is not deleted during the rebuild.  If the output directory
is the same as the original file, the original file will be deleted upon
completion of the rebuild.

Click the Browse... button to locate the output directory using the Directory
Browse dialog.

Status File Path
Specifies a location for the rebuild log file. (The default location is the
current working directory.)

Click the Browse... button to specify the log directory using the Browse
dialog.

System Data
Specifies whether the file is rebuilt with system data.  The MicroKernel cannot
perform logging for a file without system data when no user-defined unique key
exists.

Page Size
Specifies the page size (in bytes) of the new files. Choose either EXISTING,
512, 1024, 2048, 3072, or 4096. If you select EXISTING, the utility uses the
existing page size. The utility changes the page size if the original size does
not work.

For example, assume you have a v5.x file with a page size of 1024 and 24 keys.
Since Btrieve v6.0 and later supports only 23 keys for a page size of 1024, the
utility automatically selects a new page size for the file and writes an
informative message to the status file.

Key Number
Specifies the key by which the utility reads when rebuilding a file. If you
specify NONE for this option, the utility clones the files, drops the indexes,
copies the records into the new files, and rebuilds the indexes. Because this
method is faster and creates smaller files than specifying a key number, use it
whenever possible.

This method may create a new file in which the records are in a different
physical order than in the original file.

If you specify a key number, the utility clones and copies the files without
dropping and replacing indexes. While this method is slower than specifying
NONE, it is available in case you do not want to rebuild your indexes.

Continue On Error
Determines whether the Rebuild utility continues if it encounters an error
during the rebuild process. If you select the Yes radio button, the utility
continues with the next file even if an error occurs. The utility notifies you
of non-MicroKernel data files or other errors but continues rebuilding data
files. If you select the No radio button, the utility halts the rebuild if it
encounters an error.

Save Settings On Exit
Saves the configuration settings on the Settings Dialog when you close the
Rebuild utility.

OK Button
Saves the selected settings.

Cancel Button
Closes without saving any changed settings.

Help Button
Shows help for this dialog.


ΓòÉΓòÉΓòÉ 5. Start Rebuild Dialog ΓòÉΓòÉΓòÉ

This dialog lists the files to be rebuilt which were selected in the  Select
Files Dialog.  Ensure that you have made all the selections in the  Settings
Dialog prior to invoking the rebuild process.

By default, the Rebuild utility creates temporary files in the same directory
in which the conversion takes place. You therefore need enough disk space in
that directory (while the Rebuild utility is running) to accommodate both the
original file and the new file. You can specify a different directory for
storing these files using the Output Directory option in the  Settings Dialog.

The Rebuild utility deletes the original file after rebuilding it if the file
is being rebuilt in the same directory. If the new file is in a different
directory the original file is not deleted. Normally, the Rebuild utility
automatically deletes temporary files when the conversion is complete. However,
if a power failure or other serious interruption occurs, the Rebuild utility
may not delete the temporary files. If this occurs, look for filenames such as
_T-xxxxx.TMP and delete them.

You should view the status file after the rebuild completes.

Start Button
Selecting this button will begin the rebuilding of the files in the Files to
Rebuild list.  If there are no files to rebuild, this button will be disabled.
To select files to rebuild, go to the  Select Files Dialog.

Close Button
This button closes the dialog.

Help Button
Shows help for this dialog.


ΓòÉΓòÉΓòÉ 6. View Status File Dialog ΓòÉΓòÉΓòÉ

The Rebuild utility writes to the status file for every file it attempts to
rebuild.  The rebuild settings are listed for every file.  If  you disabled the
Continue on Error setting the status file contains the information up to the
point of the error.  The status file can be used as a reference in the future.
The status file informs you if the rebuild was successful. If the rebuild was
not successful, the status file contains error messages explaining why the
rebuild failed.  The path for the status file is specified in the Settings
Dialog.


ΓòÉΓòÉΓòÉ 7. About Dialog ΓòÉΓòÉΓòÉ

The About dialog displays various product information, including the name,
version and copyright of the Rebuild utility.

OK Button
Closes the dialog.