CLOSE

Contents


Close is used to delete from the memory any tables and boxes open in the current application, as well as "screen-boxes".

 

Syntax

Close [ Local ] File [ list_classes ]   
Close [ Local ] Mask [ list_classes ]   
Close  [ Local ] < Inpbox | Dlgbox | Mesbox >  [ list_classes ]

 

Parameters

Element

Description

Restrictions

list_classes

List of classes separated by the character ','.

The classes must match
open OBJects.

 

Examples

# Closure of all tables
Close File

# Closure of CLIENT and FACTURE masks
Close Local Mask [CLI], [FAK]

# Removal of all boxes opened by Inpbox from the memory
Close Inpbox

 

Description and comments

The instruction Close File is used to delete from memory some or all of the open tables. To close only tables that have been opened locally (by Local Files), the instruction Close must be followed by the keyword Local.

Close File closes all the tables opened by a File or Local File command.

Close Mask and Close Local Mask operate for masks in the same way as Close File and Close Local File for tables.

Default lists of tables and masks are updated by Close.

The Close instruction followed by Inpbox, Digbox or Mesbox deletes screen-OBJects from memory that have been declared by these instructions, and whose abbreviations are given in the argument (all by default). For a Close followed by Local, only boxes opened local to a sub-programme or routine shall be closed.

 

Comments

The instruction Close File (ou Close Local File) performs an implicit Unlock of the tables concerned (all by default). The File command
actually uses a system lock per table, that is released when the table is closed (either automatically by Adonix when the table is no longer in use, or by the instruction
Close).
However, if a table has been locked globally by Lock or scanned by Readlocks, only
Close Files will be performed, without the appropriate Unlocks, in order to retain the visibility of the programming logic.

Running Close File (or Close Local File) within a transaction means that locks and channels will only be released at the end
of the transaction.

 

Associated errors

Error

Description

ERCLAS (7)

Abbreviation not found.

 

Associated key words

FILE - LOCAL - MASK - INPBOX - DLGBOX - MESBOX - UNLOCK - TRBEGIN


CONTENTS


Copyright © Sage 1999 - 2007