L Logon

Modes

None.

Conditions

None.

Description

This request logs on to the DBMS. If the DBMS does not support logon, this initializes a session with the DBMS. A successful logon results in what is called a logon path in Uniface terminology. It is sometimes called channel, session, or DBMS process in DBMS terminology.

If logon was successful or if a session was successfully initialized, this provides Uniface with a number to uniquely identify the created logon path.

Some DBMSs return a logon handle that is needed to identify the logon path when the database is accessed or logged on. A storage space is defined in each connector to store a table with logon handles. The connector itself decides whether to define a fixed, static storage space or to allocate a dynamically sized memory block from the operating system.

The connector is fully responsible for maintaining this table of logon handles. It maps the unique identification of the logon path towards the DBMS and onto the unique identification towards Uniface.