This statement defines the DBH name.
Definition
A lower-level DBH option of DBH-IDENTIFICATION
Function
You use the DBH option DBH-NAME to define the name of the DBH.
The DBH name indicates that this DBH is to be started rather than any of the other DBHs belonging to the same configuration.
There cannot be two DBHs with the same DBH name in a single configuration. You must remember this when you load a number of SESAM/SQL DBHs (independent DBHs and/or linked-in DBHs). It is always advisable to assign a DBH name other than the default, even if the DBH is initially to be loaded only once. This prevents collisions when, for test purposes, for example, another DBH is loaded.
Like the configuration name, the DBH name identifies the cursor files and the files for transaction management. When several SESAM/SQL DBHs are loaded, these files must be uniquely identified by a configuration name and a DBH name in each case (see the section on the DBH option CONFIGURATION-NAME on "CONFIGURATION-NAME").
If the configuration and/or DBH name has the default value *BLANK, then the character “'BLANK'” is replaced by the “@” character in the file name (see the DBH option CONFIGURATION-NAME).
DBH-NAME |
= *BLANK / <alphanum-name 1..1> |
Operands
DBH-NAME = *BLANK
The blank is used as the DBH name.
DBH-NAME = <alphanum-name 1..1>
DBH name assigned by the system administrator. The characters #, @ and $ are not permitted as DBH name.