Use DBL

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

It is possible to use other ACCENT R objects without first declaring a DBL by including the IN DBL clause in the command.  If the IN DBL clause is used then @DBL_NAME is left blank.

Syntax

USE DBL dbl_name

USE NO DBL

USE DBL dbl_name

gives the name of the DBL 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.

EXAMPLE

*USE DBL BOOKS<CR>

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

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

Once a DBL is declared, any subsequent USE DBL command automatically closes the current DBL and blank the current Data Sets and Data Indexes but not any declared GS's..

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