Click above to get retro games delivered to your door ever month!

THE_USUAL() declares and initialises some variables and arrays
which may be useful to the the data screen functions you write for
modules managed by THE_USUAL().

choice is a numeric memory variable which holds the most recent
selection made by the user from THE_USUAL()'s light bar menu.

cols[ choice ] contains the column number at which
THE_USUAL()'s current selection is displayed.

graf_row is the row where THE_USUAL() paints a graphic
line -- below the menu prompts or messages --. You will probably
locate any pulldown menu at graf_row + 1.

is_append is set true if the user is adding a new record, otherwise
it is false.

_level is 1 + the number of zooms required to reach the current
table.

_max_rels is the number of relations for which there is space in
the current dictionary. The dictionaries supplied with the example
applications have room for 10 relations per dictionary record.

m_alias is the current table alias.

prev_alias is the previous alias selected.

prev_level is the level before the last zoom or un-zoom.
At entry, _level = prev_level = 1. Each zooms increments _level,
each un-zoom decrements it.

repaint is used to tell THE_USUAL() when to re-draw
a data screen with a call to your udf_scr.

stlin_msg is declared PUBLIC by THE_USUAL(). It is
used to set a message for the next call to STAT_LINE(). Remember
that you may also pass a status line message directly as a parameter to
STAT_LINE().

u_alias[] is the array of table aliases in use in the current
call to THE_USUAL().

u_fname[] is the array of file names for these aliases.

u_recno[] is the array of record numbers for these tables at
the time the table was selected.

u_home[] is the array of table aliases which have relations set
to other tables while the current table is selected.

u_relkey[] is the array of keys for these relations.

u_rltype[] is the array of relation types parallel to u_home[]
etc. In the present implementation, u_rltype[] elements are "C" for
parent-child relations, "P" for child-parent relations, or blank.

u_lookup[] is the array of lookup tables for these relations.

u_depend[] is the array of tables upon which the currently
selected file depends. Example: if, when THE_USUAL() is called
for table A, table A is related to B, and B to C, then B and C are in
u_depend[].