PURPOSE: The equated command REBUILD converts the FLATTENed text file back to a binary DBL file (ready for execution). The process allows for the old DBL to be written over or renames the rebuilt DBL (so as to retain the old DBL).
There are two forms for REBUILD: the utility command invoked by itself will prompt the user for information; or the user may supply options and bypass the prompts.
FORM 1: with prompts
REBUILD
FORM 2: options bypass prompts
REBUILD [[TO DBL dbl_name] FROM sf_name [NO FORM] [NO EDIT] [DELETE]]
|
DBL dbl_name |
specifies the name for the rebuilt DBL. The name defaults to the original DBL name. |
|
FROM sf_name |
specifies the source System File (SF) name that will be rebuilt into a binary DBL. |
|
NO FORM |
disallows the reformation of Data Indexes (DI) after they are created. |
|
NO EDIT |
disallows error correction. |
|
DELETE |
removes the old DBL version. |
Defaults can be selected by pressing the Return key (without entering data). HELP lists a description of the utility. QUIT returns control to the ACCENT R command level. REBUILD will then generate a short dialogue, first prompting for the name of the text file to be converted back to a binary DBL. An error message ("No file name given, try again.") will be displayed if the Return key is pressed without a flattened file name specified. Next, REBUILD prompts for a file name to store the new DBL after it is rebuilt back to binary. The name of the old DBL name is the default. REBUILD also asks if the DI’s are to be formed (the default is yes). If the DI’s are not formed then, they will be formed when they are used. REBUILD also prompts the user if errors are to be corrected when they are encountered (the default is yes).
The following example shows FORM 1 of REBUILD. Responses to prompts are shown in bold.
*REBUILD<CR>
REBUILD version 13.00
Enter the flattened file name, HELP or QUIT: BFLAT<CR>
Enter <CR> to use DBL BOOKS
or a new DBL name: <CR>
Do you want to FORM each DI as it is created?
Enter Yes, No or <CR> for Yes: <CR>
Do you want to fix errors as they are discovered?
Enter Yes, No or <CR> for Yes: <CR>
The rebuild commands are listed as they are executed. A partial list is shown below.
DEFINE SD BOOKS
DEFINE CF BOOKS ENTRY ONLY
Forming CF BOOKS
DEFINE DI BOOKS
Forming DI BOOKS
DEFINE CM SALES_REP
DEFINE PM SALES_REP
The new version of the DBL is in BOOKS.
The following example shows FORM 2 of REBUILD.
*REBUILD FROM BFLAT DELETE
Rebuild commands list out as they are being executed. The default DBL name is used. The first line below is displayed if the DELETE option is not used.
The new version of the DBL is in BOOKS.
NOTES: If object errors are not corrected at the time REBUILD is run (using NO EDIT or "no" on error correction prompt), they should be the edited and compiled individually later.
SEE ALSO: FLATTEN, REMOVE, RESAVE