Close Statement; The Effect Of A Close Statement On The Internal Table - Tandem ENFORM 058057 Reference Manual

CLOSE Statement

The CLOSE statement allows you to delete a user variable, user aggregate, user table, a
parameter, or a record description from the internal table. The syntax of the CLOSE
statement is:
CLOSE
record-name
user-variable-name
user-aggregate-name
user-table-name
param-name
As a session progresses, ENFORM maintains an internal table for opened record
The Effect of a CLOSE
Statement on the descriptions, links of record descriptions, and definitions of user variables, user
Internal Table aggregates, user tables, and parameters. This internal table grows with each new
OPEN, LINK, DECLARE, or PARAM statement entered.
ENFORM has no way of knowing when a table entry is no longer required for a
subsequent query within the current session. For this reason, ENFORM allows you to
clear unwanted table entries from the internal table with a CLOSE statement. The
CLOSE statement does not reclaim space from the internal table, but it does eliminate
the effect that unwanted entries might have on subsequent queries. Furthermore,
regular use of CLOSE statements reduces the need to qualify fields that are present in
more than one record description.
Closing a dictionary record description also clears all links for that particular record
description.
An alternative to the CLOSE statement is the DICTIONARY statement or
?DICTIONARY command. Both completely clear the ENFORM internal table and
reclaim table space.
058057 Tandem Computers Incorporated
record-name
user-variable-name
user-aggregate-name
user-table-name
param-name
is the name of a dictionary record description previously accessed by an OPEN
statement.
is the name of a user variable previously defined by a DECLARE statement.
is the name of a user aggregate previously defined by a DECLARE statement.
is the name of a user table previously defined by a DECLARE statement.
name of a parameter previously defined by a PARAM statement.
, ... [ ; ]
Statements
CLOSE Statement
4–7