Register
Sign In
Creating An Installation Command File
You can create an Installation Command file using an ASCII text editor, such as Windows Notepad. To tell DataEase which documents to install in the current application, type the relevant commands in the Installation Command file. These commands include the document filename and the complete DataEase-assigned DOS filename for each document which can be identified by viewing the “Document Info” table, a built-in system table. Simply select menu options: Application -> Status -> Documents.
The Installation Command file you create can contain as many commands as you require. A command can occupy more than one line, and a line can contain more than one command. After you complete the Installation Command file, save it with the filename extension .DIW.
Installation Command File Commands;
|
To.. |
Enter this command in the file… |
Example |
| Install a document that uses a table | install <document name> from: <DOS filename.FRM> | install MEMBERS from: MEMBCAAA.FRM ; |
| Install a document that defines a table | install <document name> from: <DOS filename.FRM> table: <dos filename.TDF> ; | install MEMBERS from: MEMBCAAA.FRM table: MEMBCAAA.TDF ; |
| Install a document that defines a table and the data associated with the table | install <document name> from: <DOS filename.FRM> table: <DOS filename.TDF data: <DOS filename.DBM> ; | install MEMBERS from: MEMBCAAA.FRM table: MEMBCAAA.TDF data: MEMBCAAA.DBM ; |
| Install additional data, such as Relationships, User data, and Custom Functions | install <system filename> from: <DOS filename.DBM> ; | install Relationships from: RELACAAA.DBM ; |
| Replace a document in the current application with a new version. | Replace <document name> from: <DOS filename.FRM> ; | replace MEMBERS from: MEMBCAAA.FRM ; |
|
Note: The .FRM file in the replace statement must have the same filename as the .FRM file that you want to replace (with the exception of the fifth letter in the filename).
|
||
| Replace a document and table in the current application with a new version. | Replace <document name> from: <DOS filename.FRM> table: <DOSfilename.TDF> ; | replace MEMBERS from: MEMBCAAA.FRM table: MEMBCAAA.TDF ; |
| Replace a document, table and data in the current application with a new version. | Replace <document name> from: <DOS filename.FRM> table <DOS filename.TDF> data: <DOS filename.DBM> ; | replace MEMBERS from: MEMBCAAA.FRM table: MEMBCAAA.TDF data: MEMBCAAA.DBM ; |
| Replace data, such as Relationships, User data, and Custom Functions in the current application | replace <table name> data: <DOS filename.DBM> ; |
replace RELATIONSHIPS data: RELACAAA.DBM ;
|
| Note: The .DBM file in the replace statement must have the same filename as the .DBM file that you want to replace. | ||
| Add remarks to a command file | REM <enter any text here> |
REM This Installation Command File REM installs the MEMBERS form into REM the current application. |
An example Installation Command file is shown below:
Install EMPLOYEES from: EMPLCAAA.FRM table: EMPLCAAA.TDF ;
Install SALARY HISTORY from: SALACAAA.FRM ;
Replace Relationships from: RELACAAA.DBM ;
Install MEMBER LISTY from: MEMBCAAA.FRM ;
Replace INPUT RESERVATIONS from: INPUCAAA.FRM ;
Install FAMILY MEMBERS from FAMICAAA.FRM table: FAMICAAA.TDF data: FAMICAAA.DBM ;
This Installation Command file tells DataEase to:
- Install the EMPLOYEES form and table into the current application.
- Install the SALARY HISTORY form into the current application. (no table).
- Replace the current application’s Relationships with a new relationships file, named
RELABAAA.DBM.
- Install the MEMBER LISTY Procedure into the current application.
- Replace the current INPUT RESERVATIONS Procedure with the new one INPUCAAA.FRM.
- Install the FAMILY MEMBERS form into the current application with its table and data.
How to Create and Run an Installation Command File
1- Open an ASCII text editor, such as Windows Notepad;
2- Enter the commands you require for the installation. Refer to the “Installation Command File commands” table;
3- Save the file in the ASCII text editor with the filename extension .DIW.;
4- To execute the file in DataEase, choose menu option: Application>>Utilities>>Install. DataEase displays the “Install” dialog;
5- Choose the install type <Install From Command File>. DataEase displays the “Command File Name (DIW)” text box and the “DIW Browse” button;
6- Click the “DIW Browse” button. DataEase displays the “Script File” dialog which lets you search for and select the Installation Command file you want to install;
7- Select the Installation Command filename and click OK;
8- DataEase also lets you enter the command filename and pathname manually in the “Command File Name (DIW)” text box;
9- To store system messages in a file, check “Log Messages to File” option;
10- Click OK in the “Install” dialog. DataEase installs and/or updates the documents specified in the command file.
NOTE: As you create the Installation Command file, be sure to insert a space after each colon and before each semicolon.
