USE DBL

Purpose:  The USE DBL command declares a Data Base Library for current use.  Since a Data Base Library generally serves as the central application repository of a given application, this is normally the first command to be issued upon accessing ACCENT R.

Syntax

USE DBL name

USE NO DBL

USE DBL name

gives the name of the Data Base Library to be declared, and stores the name in @DBL_NAME.

USE NO DBL

states that no DBL is to be declared for current use, and clears @DBL_NAME.

It is possible to declare and refer to other ACCENT R objects without first declaring a DBL by including the IN DBL clause in the declaring command.  If this is done, @DBL_NAME is blank, and the directory information provided by the DBL is not available.

Example

*USE DBL BOOKS

NOTES:  The DBL declared by the most recent USE DBL command is known as the current or declared Data Base Library.

The CREATE DBL command both creates the Data Base Library and declares it as the current DBL.

Once a DBL is declared, any subsequent USE DBL command automatically closes the current DBL and all open Data Sets and Data Indexes before the next DBL is declared.

If a REMOVE command specifies the current DBL for removal, ACCENT R sets the USE NO DBL condition.  If the current DBL is renamed through ACCENT R, ACCENT R recognizes the new name as the current DBL.

Creating a DBL    Creating an ACCENT R Schema Definition Object