Difference between revisions of "BUILD"

From Recital Documentation Wiki
Jump to: navigation, search
(Products)
 
(One intermediate revision by one user not shown)
Line 1: Line 1:
==Class==
 
Table Basics
 
 
 
 
==Purpose==
 
==Purpose==
 
Exports bridge files, tables and their associated files in ASCII format to allow them to be transferred to a binary incompatible platform
 
Exports bridge files, tables and their associated files in ASCII format to allow them to be transferred to a binary incompatible platform
Line 68: Line 64:
  
 
==Products==
 
==Products==
Recital Database Server, Recital Mirage Server, Recital Terminal Developer
+
Recital Server, Recital [[Category:Documentation]]
[[Category:Documentation]]
+
 
[[Category:Commands]]
 
[[Category:Commands]]
 
[[Category:Table Basics]]
 
[[Category:Table Basics]]
 
[[Category:Table Basics Commands]]
 
[[Category:Table Basics Commands]]

Latest revision as of 14:36, 10 November 2009

Purpose

Exports bridge files, tables and their associated files in ASCII format to allow them to be transferred to a binary incompatible platform


Syntax

BUILD <filename> [INTO <directory>]


See Also

BACKUP DATABASE, COPY, COPY DICTIONARY, COPY STRUCTURE, COPY STRUCTURE EXTENDED, CREATE, CREATE BRIDGE, CREATE DICTIONARY, CREATE FROM, INSTALL, MODIFY STRUCTURE, SET CLIPPER, SET FILETYPE


Description

The BUILD command exports tables and their associated memo, dictionary and multiple index files into ASCII format to allow them to be transferred to a binary incompatible format. The import on the target machine requires the use of the INSTALL command.

<filename>

The <filename> is the name of a '.xaf' file. This is a text file in the following format, assuming the files data1.dbf and data2.dbf are the tables to be converted:

dbf,data1.dbf

dbf,data2.dbf

The dictionary, memo and multiple index file information is picked up automatically.

The BUILD command creates a single '.xat' file with information about all the files being exported. The '.xat' file has the same name as <filename> and is specified in the INSTALL command on the target machine. A '.xds' file is created for each table specified, containing the table structure information. A '.xmd' file is created for each table that has a memo file and a '.xdd' file for each table's data. These files contain the information required to rebuild the files on the target machine.

Recital Bridges can also be transferred. The name of the bridge file should be specified in the '.xaf' file, e.g.

brg,cisamdemo.dbf

Note: although the default extension for bridge files is '.brg', many bridge files are given a '.dbf' extension to allow them to be opened with the USE command by specifying the basename only. This is the case for the cisamdemo.dbf C-ISAM bridge file included in the Linux and UNIX distributions.

The matching '.str' file and the target data files are automatically picked up. For the cisamdemo.dbf bridge, this means that the following files are included:

cisamdemo.str

cisamdemo.dat

cisamdemo.idx

INTO <directory>

If the optional INTO <directory> clause is used, the export files will be created in the specified directory. If the directory does not exist, it will be created.


Example

On source machine demo.xaf contains the following lines:

dbf,customer.rdb
dbf,accounts.rdb
dbf,state.rdb
dbf,product.rdb
brg,cisamdemo.dbf


build demo into ./transfer

On target machine, once files have been transferred

install demo from ./transfer


Products

Recital Server, Recital