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 started ADABAS tool 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 Appendix A - XUSER).
When you access the database from an ADABAS tool, you may pass user specifications to the ADABAS Windows Clients in three ways:
1) User Specifications Predefined With XUSER
User specifications can be preset and saved by using the special tool XUSER. The XUSER entries can be accessed when starting an ADABAS tool or a precompiler program.
2) User Specifications Made When Starting a Tool
User specifications can also be passed as arguments when calling one of the database tools. For example:
easy -u parker,secret -d testdb -n sql1
3) Connect Window
If there are no predefined user specifications, or if individual specifications are missing, the connect window is called. This does not happen when precompilers and application programs are called.
The connect window 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 Windows Clients using a combination of these three ways. The combinations are described in Chapter Precedence Rules of the Various Connect Procedures.
If precompilers and application programs constructed using the ADABAS programming interface are started, user specifications can also be passed directly within the program. Different precedence rules apply in these cases; they are diescribed in the C/C++ precompiler manual. In principle, the same ways of connecting are valid for both the precompiler and application programs. These principles are explained in the following for the start of the ADABAS tools.