Difference between revisions of "DISPLAY TABLES"

From Recital Documentation Wiki
Jump to: navigation, search
 
Line 8: Line 8:
  
 
==See Also==
 
==See Also==
[[ADATABASES()]], [[ALTER TABLE]], [[ALTER INDEX]], [[CLOSE DATABASES]], [[CLOSE TABLES]], [[COMPILE DATABASE]], [[COPY DATABASE]], [[CREATE DATABASE]], [[CREATE INDEX]], [[CREATE TABLE]], [[CREATE VIEW]], [[DB_DATADIR]], [[DB_PRINT]], [[DBUSED()]], [[DISPLAY DATABASE]], [[DISPLAY INDEXES]], [[DISPLAY SCHEMAS]], [[DROP DATABASE]], [[DROP INDEX]], [[DROP TABLE]], [[Function Keys]], [[GETENV()]], [[LIST DATABASE]], [[LIST INDEXES]], [[LIST SCHEMAS]], [[LIST TABLES]], [[OPEN DATABASE]], [[PACK DATABASE]], [[SET AUTOCATALOG]], [[SET EXCLUSIVE]] , [[SET PAGELENGTH]], [[SET PAGEWIDTH]], [[SET PRINTER]], [[SET SQL]], [[USE]]
+
[[ADATABASES()]], [[ALTER TABLE]], [[ALTER INDEX]], [[CLOSE DATABASES]], [[CLOSE TABLES]], [[COMPILE DATABASE]], [[COPY DATABASE]], [[CREATE DATABASE]], [[CREATE INDEX]], [[CREATE TABLE]], [[CREATE VIEW]], [[DB_DATADIR]], [[DB_PRINT]], [[DBUSED()]], [[DISPLAY DATABASE]], [[DISPLAY INDEXES]], [[DISPLAY SCHEMAS]], [[DROP DATABASE]], [[DROP INDEX]], [[DROP TABLE]], [[Function Keys]], [[GETENV()]], [[LIST DATABASE]], [[LIST INDEXES]], [[LIST SCHEMAS]], [[LIST TABLES]], [[OPEN DATABASE]], [[PACK DATABASE]], [[SET AUTOCATALOG]], [[SET EXCLUSIVE]], [[SET PAGELENGTH]], [[SET PAGEWIDTH]], [[SET PRINTER]], [[SET SQL]], [[USE]]
  
 
==Description==
 
==Description==
 
The DISPLAY TABLES command displays the base name and file name including the full path for each table in the currently active database.
 
The DISPLAY TABLES command displays the base name and file name including the full path for each table in the currently active database.
  
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 and can be queried using the GETENV() function.  Files from other directories can be added to the database using the ADD TABLE command or via the database catalog and SET AUTOCATALOG functionality.  Databases are opened using 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 DB_DATADIR points to the current Recital data directory and can be queried using the GETENV() function.  Files from other directories can be added to the database using the ADD TABLE command or via the database catalog and SET AUTOCATALOG functionality.  Databases are opened using the OPEN DATABASE command.
  
DISPLAY commands differ from LIST commands in that they pause every 17 lines until a key is pressed.  You can cancel any further output at this point by pressing the [ABANDON] key.  Where the output is sent to a file or printer, the pause is disabled.
+
DISPLAY commands differ from LIST commands in that they pause every screen until a key is pressed.  You can cancel any further output at this point by pressing the [ABANDON] key.  Where the output is sent to a file or printer, the pause is disabled.
  
  
Line 30: Line 30:
 
==Example==
 
==Example==
 
<code lang="recital">
 
<code lang="recital">
VFP/SQL > OPEN DATABASE southwind
+
OPEN DATABASE southwind
VFP/SQL > DISPLAY TABLES
+
DISPLAY TABLES
 
</code>
 
</code>
  

Latest revision as of 17:27, 22 December 2009

Purpose

Display table information about the active database


Syntax

DISPLAY TABLES [TO FILE <.txt filename> | (<expC>)] | [TO PRINT]


See Also

ADATABASES(), ALTER TABLE, ALTER INDEX, CLOSE DATABASES, CLOSE TABLES, COMPILE DATABASE, COPY DATABASE, CREATE DATABASE, CREATE INDEX, CREATE TABLE, CREATE VIEW, DB_DATADIR, DB_PRINT, DBUSED(), DISPLAY DATABASE, DISPLAY INDEXES, DISPLAY SCHEMAS, DROP DATABASE, DROP INDEX, DROP TABLE, Function Keys, GETENV(), LIST DATABASE, LIST INDEXES, LIST SCHEMAS, LIST TABLES, OPEN DATABASE, PACK DATABASE, SET AUTOCATALOG, SET EXCLUSIVE, SET PAGELENGTH, SET PAGEWIDTH, SET PRINTER, SET SQL, USE

Description

The DISPLAY TABLES command displays the base name and file name including the full path for each table in the currently active database.

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 DB_DATADIR points to the current Recital data directory and can be queried using the GETENV() function. Files from other directories can be added to the database using the ADD TABLE command or via the database catalog and SET AUTOCATALOG functionality. Databases are opened using the OPEN DATABASE command.

DISPLAY commands differ from LIST commands in that they pause every screen until a key is pressed. You can cancel any further output at this point by pressing the [ABANDON] key. Where the output is sent to a file or printer, the pause is disabled.


Keyword Description
TO <file> The display output will be sent to the specified file. The filename can be substituted with a <expC>, enclosed in round brackets, which returns a valid filename. If no file extension is specified, then ".txt" will be used. The command SET PAGELENGTH governs the output file pagination and SET PAGEWIDTH defines the width of each page. Page numbers are centered on the bottom of the page according to width.
TO PRINT The display output will be sent to a printer. The TO PRINT option will default to a local printer unless the command SET PRINTER TO \\SPOOLER is issued. The print request will then be spooled to the system printer, which is defined by the environment variable DB_PRINT.


Example

OPEN DATABASE southwind
DISPLAY TABLES


Products

Recital Server, Recital