To establish a database session, the ADABAS user must connect to the database. To be able to do so, certain user specifications must be passed to the called ADABAS component for identification purposes. The following information is required for the connect:
USERID: ADABAS user name
PASSWORD: ADABAS password of the user
SERVERDB: name of the ADABAS database to be used
SERVERNODE: name of the network node where the addressed database is located
For a distributed database, SERVERDB denotes one of the database sites.
The SERVERNODE specification is not necessary when a SERVERDB of the local computer is used.
In addition to the required user specifications listed above, additional optional user specifications such as TIMEOUT and ISOLATION LEVEL may be passed to the ADABAS tool when connecting (see Section Using XUSER).
When you access the database from an ADABAS tool, you may pass user specifications to the component in four ways:
1) User Specifications Predefined With XUSER
User specifications can be preset and stored by using the special tool XUSER. The XUSER entries can be accessed when an ADABAS tool (except CONTROL) or a precompiler program is called.
2) User Specifications Made When Calling a Tool
User specifications can also be passed as arguments when calling one of the database tools. For example:
xeasy -u parker,secret -d testdb -n sql1
3) Predefining the SERVERDB
The database name can also be predefined by setting the environment variable SERVERDB.
4) Connect Screen
If there are no predefined user specifications or if individual specifications are missing, the connect screen is called. This does not happen when precompilers and application programs are called.
The connect screen is also displayed when the user specifications did not result in a successful connect.
Missing or incorrect user specifications in a precompiler program have the effect that a program is aborted and a corresponding error message is output.
User specifications may be passed to the ADABAS tools using a combination of these four ways. The combinations are described in Section Precedence Rules of the Various Connect Procedures .
If precompilers and application programs constructed using the ADABAS programming interface are called, user specifications can be passed directly within the program. Different precedence rules apply in these cases; they are described in the precompiler manuals. In principle, the same ways of connecting are valid for both precompilers and application programs. These principles are explained in the following for calls to the ADABAS tools.
See also:
Connect With Predefined User Specifications (XUSER)
Connect With User Specifications When Calling a Tool
Precedence Rules of the Various Connect Procedures