SELECT

From Recital Documentation Wiki
Jump to: navigation, search

Purpose

Select a cursor


Syntax

SELECT <workarea | alias>


See Also

ALIAS(), SELECT(), SET FILTER, SET RELATION, SET VIEW, USE, WORKAREA()


Description

The SELECT command is used to select a cursor. At any given time, a particular cursor is active and selected. When you USE a table in a selected cursor, an ALIAS name may be optionally specified. If none is specified, the table basename can also be used as the alias as can the cursor letter A to Z. The alias 'm' is reserved for memory variables and cannot be used to reference a cursor. This ALIAS name gives the cursor an identification, so that you can reference fields in cursors other than the currently selected one, by preceding the field name with the ALIAS name followed by '->' or '.' followed by the field name. This construction is known as an alias pointer.

Each cursor contains the context for the table that has been opened in that cursor. The current record pointer, the current record, the format file, the index files, the filter condition, and the relationships to other workareas. The SELECT 0 command selects the next available cursor and provides an alternative to using the WORKAREA() function. The LIST STATUS command provides full details of the current status of each cursor.


Example

select a
use patrons index events, dates alias pat
select b
use addresses index addr_names alias add
select pat
? add.state


Products

Recital Server, Recital