Revision as of 14:34, 19 March 2009

SET AUTOCATALOG

Class

Databases

Purpose

Enable files to be automatically added to a database catalog

Syntax

SET AUTOCATALOG ON | OFF | (<expL>)

SET AUTOCATALOG TO <database>

See Also

ADATABASES(), ALTER INDEX, ALTER TABLE, CLOSE DATABASES, CLOSE TABLES, COMPILE DATABASE, CREATE DATABASE, CREATE INDEX, CREATE TABLE, CREATE VIEW, DB_MAXWKA, DBUSED(), DISPLAY DATABASE, DISPLAY INDEXES, DISPLAY TABLES, DROP DATABASE, DROP INDEX, DROP TABLE, LIST DATABASE, LIST INDEXES, LIST TABLES, OPEN DATABASE, PACK DATABASE, REBUILD DATABASE, REINDEX DATABASE, SET EXCLUSIVE, USE

Description

The SET AUTOCATALOG commands allow tables and their index files to be automatically added to a database catalog. The database itself should be closed when using the auto catalog commands. The SET AUTOCATALOG TO <database> command specifies the name of the database for which the catalog should be updated. SET AUTOCATALOG ON | OFF allows updates to the catalog to be toggled on and off. Once the auto catalog commands are active, tables and their indexes can be opened from the interactive prompt or from an application and the database catalog will automatically be updated. For additional details on the information stored in the database catalog, please see the OPEN DATABASE command.

Databases in Recital are implemented as directories containing files that correspond to the tables and associated files in the database. Operating System file protection can be applied individually to the files for added security. The directories are sub-directories of the Recital data directory. The environment variable / symbol DB_DATADIR points to the current Recital data directory. Databases are opened using the OPEN DATABASE command. Database commands can be issued as SQL statement commands or as Recital/4GL commands.

Example

close databases
set autocatalog to southwind
set autocatalog on
do myapp

Products

Recital Database Server, Recital Mirage Server, Recital Terminal Developer