The below list of Frequently Asked Questions (FAQs) is constantly updated based on our customer's requests. As with any database interface, NativeDB heavily relies on the quality of the lower database layers it communicates with. We encourage you to re-check this list of known issues if you encounter any problem or have questions not covered in our documentation.

"Using NativeDB Alerts, sometimes a few clients stops receiving incoming messages?"
Every client using NativeDB Alerts consumes an extra thread/task at the ASA server-side to handle receiving messages. Hence consider the -gn server option to increase the number of tasks that the database server can handle concurrently. The default value is 20. This can be to few if you have many concurrently active clients. To our knowledge and experience a value of 120 solves your issue.

"I have a situation where I am distributing an application that is used on laptops/notebooks where the user suspends or hibernates the computer. A problem has arisen where the database connection is terminated/lost when the notebook restarts if it is left off for a longer period of time. Is there any known way to work around this problem?"
We have experienced this problem in a few cases when the database connection is based on local TCP. To work around the problem set the TAsaSession.ClientParams property to "commlinks=shmem". This will force ASA to use a local shared memory connection instead. For shared memory connections, the only time the server ever disconnects the client is when the client process terminates (i.e. the server can no longer find the client process id in the list of running processes).

"I can't determine how to set a database's name on startup. I'm establishing a workstation connection by starting up a database file (dbf) with dbeng6. The dbn defaults to the file's prefix, but I want to name it something else?"
When specifying the database file using the TAsaSession.LoginDatabase property only, ASA will by default name the database to the database file prefix. To name it differently, the trick is to clear the LoginDatabase property and instead specify the entire startup line explicitly in the TAsaSession.ServerParams property.
  AsaSession1.ClientParams := 'dbn=demo_db';
  AsaSession1.LoginDatabase := ''
  AsaSession1.LoginEngineName := 'demo_db'
  AsaSession1.ServerParams := 'start=dbeng6.exe "C:\Asa6\asademo.db" -n demo_db'
  AsaSession1.ServerType := stServer;
  AsaSession1.Connected := True;
  on E: EAsaException do ShowMessage(E.Message);
These settings will start the database file 'asademo.db' and name it 'demo_db'. The database engine (eng) itself will by default be named 'demo_db' too. If you even want to name the engine differently, you need to include another -n switch before the first database file is specified.
AsaSession1.LoginEngineName := 'demo_eng'
AsaSession1.ServerParams := 'start=dbeng6.exe -n demo_eng "C:\Asa6\asademo.db" -n demo_db'
"I am trying to connect to an SQL Anywhere 5 network database server loading two different database files. On the client-side I'm running DBCLIENT.EXE as an NT service. The service is configured to NOT interact with the desktop. If I try to connect to any of these databases I get an error '-83: specified database not found'?"
When connecting to your database using the SQL Anywhere Client (DBCLIENT.EXE), running as an NT service without desktop interaction, SA will fail to connect if the ENG= parameter is specified in the connection string. To avoid this behavior both TAsaSession.LoginEngineName and LoginDatabase properties should be cleared before you attempt to connect. Instead use the ClientParams property directly to specify the connection details:
  AsaSession1.ClientParams := 'agent=client;dbf=MyDatabase2';
  AsaSession1.LoginDatabase := ''
  AsaSession1.LoginEngineName := ''
  AsaSession1.ServerType := stClient;
  AsaSession1.Connected := True;
  on E: EAsaException do ShowMessage(E.Message);
"Could you suggest a listing of 3rd-party components which provide drivers for NativeDB?"
NativeDB will work with most 3rd party products through the Borland VCL/CLX TDataSource component. However, some 3rd party companies have special drivers for NativeDB: Flexible reporting tools are available from ReportBuilder Pro DADE, RAVE/ReportPrinter, FastReport or the Shazam Power Query components library. Other popular 3rd party components include ASTA for ultra-thin client data-access over the Internet, ObjectSight for building object-oriented database applications using persistent business objects and the Rubicon text search engine."

"I'm using NativeDB for Kylix 2 on Linux Mandrake 8 (Kernel 2.4.3-20), but are experiencing some strange problems when executing my application from within the Kylix IDE. Everything works fine when executing the application stand-alone, but from Kylix I get the Linux signals SIGALRM(14), SIGIO(28) and SIGIO(29) when I attempt to connect to the database using the TAsaSession.Connected property?"
NativeDB is internally prepared to handle these kernel signals gracefully. The issue here is that the signals are catched by the Kylix debugger before NativeDB get any chance to handle them. So the workaround is to disable the signals (for the debugger only) through the Kylix menu "Tools | Debugger | Options", to allow NativeDB to continue the connection attempt within the IDE in debug mode.

1) Select Tools | Debugger Options
2) Select the "Signals" tab
3) Highlight "14", "28" and "29"
4) Change the option "Handled By" to "User Program"

"Using ASA7, I'm getting an error '-192: Update operation attempted on non-updateable query', if my query includes an updateable JOIN?"
The ASA7 option ANSI_UPDATE_CONSTRAINTS controls whether updates are restricted to those permitted by the SQL/92 standard. It controls the following update types:
1) Updates of cursors containing JOINS
2) Updates of columns that appear in an ORDER BY clause
3) The FROM clauses is not allowed in UPDATE statements.

To allow your JOIN to be updated, set the option permanently to OFF using Sybase Central or temporary using TAsaSession.SetOption.

"Is it any way to monitor the different SQL statements sent from NativeDB to ASA?"
You can include the "-zr " switch in the engine startup line to enable request logging information in the server window. The same log can also be written to a file by using the -zo switch.

"I know this is not a NativeDB question, but do you know which ASA EBFs that is approved to run on Windows XP?"
The following link should answer you question:

"Using ASA 6.03, I get an Access Violation error when opening a query which has user-defined datatypes in it (e.g 'money')?"
This AV is caused by a known ASA bug. The combination ASA and a query which includes user-defined datatypes, causes "DBLIB6.DLL" to fail, with an Access Violation, when opening the query.Sybase has announced a fix to this problem by build #2946 - Engineering Case #211083. For further details, refer to your ASA "rdme_ebf.txt" file shipped with the EBF. A workaround is to replace the user-defined datatypes with the base datatype behind it (e.g. a "money" column could be changed into "numeric(16,4)"). The permanent solution is to upgrade your ASA client-interface SW to a more recent build (EBF).

"Using ASA7, I'm getting an error '-192: Update operation attempted on non-updateable query', if my query includes an ORDER BY clause?"
This behavior is controlled by the ASA7 option ANSI_UPDATE_CONSTRAINTS. When initializing a new database for ASA7 this option defaults to CURSORS, while an upgraded database has this option turned OFF by default. If you want to disable this constraint to allow the update, set the option permanently to OFF using Sybase Central or temporary using TAsaSession.SetOption. If you you don't want to change this database option, the cursortype actUnique will come to the rescue and will, in most cases, return an updateable cursor. However, the actUnique cursortype is slightly slower than the actDefault or actFixedScroll cursortypes.

"I am trying to use NativeDB with the Delphi6 TRIAL Edition, but get an error message '[Fatal Error] File not found: NdbBase.pas', when I compile my application?"
Unless you are using our Professional edition (w/source-codes), you can't use NativeDB with the Delphi6 Trial Edition. The reason is that Borland have used a different build for their Trial edition, thus causing the compiler to complain about the current NativeDB .DCU format, and in turn attempts to rebuild the units (The error-message you get is caused by this re-compile attempt). In other words, the .DCU format produced by the regular Delphi6 Personal, Professional and Enterprise compilers are incompatible with the Delphi 6 Trial Edition.

"I'm using TAsaDataset with persistent data-fields. This works very well, but once I add lookup-fields (FieldKind = fkLookup) to the dataset, navigational operations on the dataset starts to work slower. Is it anything I can do about it?"
On each lookup-field, simply set TField.LookupCache := True. Without caching lookup-fields, NDB's live server-cursor could potentially re-fetch data from the lookup-table (LookupDataSet) unnecessarily often, and this could cause this performance problem. Enabling LookupCache is especially important with larger lookup-tables, or lookup-fields which resides in detail- tables of a master-detail relationship. Refer to your Delphi/BCB online-help on TField.LookupCache for further details.

"Can I use NativeDB with Kylix Open Edition?"
Unless you are using our Professional edition (w/source-codes) and installed the FreeCLX library you can not use the NativeDB binaries with Kylix Open Edition. The Kylix Open Edition cannot use any binaries produced by the Kylix Trial edition, the Kylix Desktop Developer edition or the Kylix Server Developer edition. You need at least one of these three editions to use NativeDB on Kylix/Linux.

"I'm converting an ODBC based application to NativeDB. All our current customer- installations heavily rely on an existing ODBC DSN. So for simplicity reasons and to ease the conversion, is it possible to allow NativeDB to retrieve the connection information from this ODBC datasource?"
Yes, the ASA connection parameter "DSN=" will do just this. DBLIB (the DB interface that NativeDB uses) will only use this parameter to get the connection information from the ODBC datasource. Once connected, all data-access will be plain DBLIB without ODBC involved. The following sample shows how to setup NativeDB's TAsaSession to connect to ASA using an ODBC datasource (DSN):

  AsaSession1.ClientParams := 'dsn=ASA 7.0 Sample';
  AsaSession1.ServerType := stClient;
  AsaSession1.Connected := True;
  on E: EAsaException do ShowMessage(E.Message);
"I'm a registered NativeDB developer and wonders if I need to purchase a separate Linux/Kylix license in addition to my existing NativeDB license (on Windows/Delphi)?"
No. All currently registered developers will receive the new Kylix version as part of their support-deal and their free-updates subscription. Simply make sure you have a valid support-deal with us, and that your current subscription haven't expired. If you need to renew your support-deal, please contact our sales department at

"I'm using TAsaDataset and is updating a query/result-set (Edit-Post) which contains a Stored Function call in the WHERE clause. But I'm experiencing a rather slow update operation. What can I do to improve it?"
Change your TAsaDataset.CursorType to actFixedScroll. With the actDefault (DYNAMIC SCROLL) cursors, the Stored Function must be evaluated everytime a row is fetched from the server. However, with a actFixedScroll (SCROLL) cursor, the function will only be evaluated the first time the row is fetched. After that the row is kept in an ASA temp table and is just returned directly from subsequent fetches. PREFETCH is also probably having an impact here. Try turning it off and rerun the query/updates. It should be faster than now, but in general using stored procedures in the WHERE clause is not a good thing to do if you need good performance.

"Using TAsaDataset, I'm getting an exception '-668: Cursor is restricted to FETCH NEXT operations' when opening a query that contains one or more proxy-tables?"
This error reflects the driver capabilities of the remote database you are connecting to. This error is seen when your remote database supports unidirectional cursors only (forward only). To prevent this cursor restriction, when opening a proxy-table, set your TAsaDataset.CursorType to actInsensitive. This cursor type is similar to the ODBC STATIC cursor type and will allow you to both navigate backwards and forward on proxy-tables.

"Can I use NativeDB with the Delphi 5 Standard edition?"
For Delphi 5 you need at least the Professional edition to use our VCL based data access components TAsaDataset and TAsaStoredProc. The Standard version does not have any data access components or any data aware controls.However, if you don't need to use any VCL based data-aware controls in your project, you could use our generic data-access class TAsaSQL instead. Upon NativeDB installation, follow our general setup instructions, but skip the part to install the Delphi packages. The step to add the NativeDB Delphi5\ directory to your unit search path, must be followed though. When using our components in your Delphi 5 Standard project, just add "NdbBase" and "NdbAsa" manually to your unit's USES clause, and create the neccessary TAsaSession and TAsaSQL instances by code, instead of using the Delphi control-palette. If you require to have the NativeDB controls shown up in Delphi control-palette, you must create and install your own package (.DPK) by adding the files "NdbBase.dcu" and "NdbAsa.dcu" to this package.

"Does NativeDB supports MIDAS and TClientDataset's?"
Yes, it's supported on the Delphi5/BCB5 implementation. But do note that our lack of cached updates, will require you enable the TDataSetProvider.ResolveToDataSet property (set it to True).

"The latest versions of NDB suddenly caused the link between my Master-Detail based queries to break?"
Starting from version 1.87 we added a new property to the TNativeParam class (accessed through TAsaDataset.Params) to make it more compatible with the BDE (TQuery and TParam classes). This property is called Bound, and stores the current assignment status (True or False) of the host variable. When TNativeParam.Bound is True, it indicates that the parameter has been assigned a value explicitly (either design-time or runtime). While False means that the host variable is still unassigned. When Bound is True, its said that the parameter is "bound to" the explictly assigned value, and will not retrieve the parameter value from the Master table anymore. As a result, the Master-Detail relation would break, if the parameter assigned to represents any of the linked fields. So to re-establish the Master-Detail link, either reset your TAsaDataset.Params property, or assign a False value to the TNativeParam.Bound property. The TNativeParam.Bound and the standard VCL TParam.Bound property has the same behavior, so for more information, refer to your Delphi/C++Builder online help on the TParam.Bound property. To reset the Bound property for all parameters, enter the TAsaDataset.Params property and press the Reset button.

"One of my tables have a column with a default value of "timestamp". I am trying to retrieve all the rows within a specified timestamp range, by assigning a TDateTime value to a host variable, but my query always returns an empty result-set?"
The fractional part of a TDateTime second in Delphi/C++Builder is precise to three decimal places (milliseconds), while SA/ASA supports 6 digits accuracy (microseconds). So when the host variable is bound to a TDateTime datatype you will not be able to make a valid comparison. You will solve this problem if you change the database option DEFAULT_TIMESTAMP_INCREMENT from the initial value of 1 to 1000.

"I issued an SQL with the 'Count' function but TAsaDataset returns more than one row. It seems that any query containing aggregate functions return more than one row. Why?"
This problem is caused by a bug in some ASA6 and ASA7 EBF's. These EBF's doesn't set the EOF and BOF markers properly when navigating NEXT and then followed by one or more PRIOR cursor navigations. You need to upgrade to a later ASA build, or as a workaround, change your cursortype to actFixedScroll or change your database option PREFETCH to OFF. A permanent fix is now available with ASA EBF

"Using Borland C++Builder I get an Access Violation (AV) when calling the OpenRead/ OpenWrite methods?"
This problem is seen if you pass a C NULL pointer in the "VarValues" variant array parameter to specify that you are not using any host variables. Pass a "&Null" variant instead, followed by a dimension count of zero (0).

AsaSQL1->OpenRead("select * from customer", &Null, 0);
"I'm using C++ Builder 4, but get an EAccessViolation (AV) in the NativeDB module NdbBase once I launch my app. executable. This error only shows up when I run my application EXE outside the BCB4 environment?"
This is a BCB4 linking problem, and is only a seen using the Trial version of NativeDB. The Trial version includes the BCB4 standard module "SYSINIT" to check the system variable "ModuleIsPackage" to decide if your application is running in designtime or runtime mode. Make sure your linker (ilink32) includes the BCB4 system module SYSINIT.OBJ or the corresponding lib file.

"When I try to connect my TAsaSession object to the database I get an AV?
This problem is typically a result of a DLL conflict when you have mulitple SA/ASA installations on the same PC. In this situation you need to force a path to your ASA DLLs. Use the TAsaSession.LibraryPath for this purpose and let it point to the correct ASA directory where the dblib?.dll file resides. This would typically be the \Win32 directory under your ASA installation home directory.

"When calling TAsaDataset.Edit, I sometimes get a 'Could not perform the edit because another user changed the record' exception. What is the best way to handle this concurrency problem?"
This error is seen when NDB detects that another user has updated the record that you currently try to edit. So you have to decide if you want to let the current user procceed with his updates or not. A nice way could be to warn the user, that the row has changed, by defining an OnEditError handler with your TAsaDataset. In this handler you could let the user decide to continue/retry the edit process or abort the operation.

An OnEditError similar to the following could be used:

procedure TForm1.AsaDataset1EditError(DataSet: TDataSet;
  E: EDatabaseError; var Action: TDataAction);
  Confirm: Word;
  Confirm := MessageDlg(E.Message + '. Abort or Retry the operation?',
    mtConfirmation, [mbAbort, mbRetry], 0);
  if Confirm = mrRetry then
    Action := daRetry
    Action := daAbort;
"I get an error if I try to install the NDB packages with Delphi 4?"
A Delphi 4 bug is actually causing this. You need to upgrade your current D4 version to the latest service pack.

What is the difference between the OnConnectionDropped and the OnConnectionTerminated events offered by TAsaSession?
OnConnectionTerminated is a "polling event" fired by the next database access function that detects the loss of connection. All internal buffers and connection properties are reset automatically before the event is called. OnConnectionTerminated is supported by all SA/ASA versions from WSQL3.2 to ASA7.

OnConnectionDropped on the other hand, is utilizing a new feature of ASA 7.01. This event is triggered real-time and reports a connection drop back to the application, as a callback. TAsaSession translates this callback into a Delphi/C++Builder user event. OnConnectionDropped is reporting a drop of connection that is caused by liveness timeout. Internal buffers and connection properties are NOT reset automatically upon calling the event. Its the programmers responsibility to reset or reconnect by assigning a proper value to TAsaSession.Connected. OnConnectionDropped is sensitive to reentrancy and you can not call other NDB dataaccess functions from within it. To avoid reentrancy problems, the following sample illustrates how to put this event into good use.

// User defined windows message declared with global scope.

procedure TForm1.WMReconnect(var Msg: TMessage);
  // Toggle the connection property to force a database reconnection.
  AsaSession1.Connected := False;
  AsaSession1.Connected := True;

procedure TForm1.AsaSession1ConnectionDropped(Sender: TObject);
// User defined event handler for the OnConnectionDropped event.
  // Avoid reentrancy by posting (not SendMessage) the user defined
  // windows message to the application message queue.
  PostMessage(Handle, WM_RECONNECT, 0, 0);
"Is there a way to avoid my application from 'hanging' if it gets blocked by another transaction holding an exlusive lock on the same row?"
You have two options to avoid this situation. Either you can turn the database option BLOCKING OFF, or you can handle the blocking inside your own TAsaSession.OnServerWait event. This event is called repeatedly while the database operation is blocked. If you want to timeout the blocking you can call TAsaSession.Stop to cancel the operation.

"Why am I getting an error if i try to start the ASA network server engine using TAsaSession?"
The network server engine has a way of protecting clients from starting and stopping databases. This mechanism is controlled by the "-gd" startline switch. When starting the network server engine from within your application you need to use "-gd all" as part of the "start=dbsrv7.exe" parameter. This switch is only required by ASA6 or later releases.

"Does NDB support persistent fields as I am used to with TQuery?"
Yes. NDB fully support persistent fields, including calculated fields and lookup fields. After dropping a TAsaDataset instance to a form or data module, double-click it and add persistent fields as needed.

"Can I execute batches of SQL statements with NativeDB?"
Batches or groups of statements are supported by SA/ASA and can be executed through NativeDB. Batches of statements are typically used with compound statements. In contrast to stored procedures, compound statements are executed "on the fly" by the client application, while a stored procedure are stored in the database. A compound statement starts with the keyword BEGIN and ends with the keyword END. In cases where you don't want to write stored procedures, groups of statements are very convenient.

The following are examples of using compound statements:

ABatch := 'begin' +
          ' declare cust_id int;' +
          ' set cust_id = 101;' +
          ' select * from customer where id=cust_id;' +
AsaSQL1.OpenRead(ABatch, Null);
Or using an atomic compound statement that doesn't return a cursor:

ABatch := 'begin atomic' +
          ' declare cust_id int;' +
          ' declare phone_no char(12);' +
          ' set cust_id = 101;' +
          ' set phone_no = ''3175558414'';' +
          ' update customer set phone=phone_no where id=cust_id;'+
AsaSQL1.Execute(ABatch, Null);
The above examples use NativeDB's TAsaSQL component. The same statements could also be used with TAsaDataset filling the SQL property and calling TAsaDataset.Open with the batch that returns a cursor, while TAsaDataset.ExecSQL for the atomic statement.

"Why do I get trailing blanks right padded to all character fields?"
This problem is caused by the SQL Anywhere database create-option "Ignore trailing blanks in Comparisons". When creating the database via Sybase Central, you will see a checkbox option "Ignore trailing blanks...". Turning this feature ON will cause all string-fields to include trailing blanks. To trim off these trailing blanks, when data is fetched into your application, set the TAsaSession.TrimBlanks propertyto True. If you instead want to totally disable this database option, follow these steps:

1. UNLOAD the old database.
2. Create a new database with "Ignore Trailing Blanks..." unchecked.
3. Run the Reload.sql script, as created by UNLOAD, on the new database.

"Can I connect to a Watcom SQL server, using NativeDB?"
Yes, you can. The following properties of TAsaSession, shows an example when connecting to WSQL4, over a LAN:

procedure TForm1.btnConnectClick(Sender: TObject);
   AsaSession1.ClientParams := 'start=dbclient.exe -x tcpip';
   AsaSession1.LibraryFile := 'dbl40t.dll';
   AsaSession1.LibraryPath := 'C:\Program Files\Sybase\wsql40\nt'
   AsaSession1.ServerType := stClient;
   AsaSession1.LoginEngineName := 'MyServer';
   AsaSession1.LoginDatabase := 'MyDatatbase';
   AsaSession1.LoginUser := 'dba';
   AsaSession1.LoginPassword := 'sql';
   AsaSession1.Connected := True;
"How can I translate strings in my OEM based database collation through NativeDB?"
TAsaSession has a property named OEMConvert. If set to True, all database input/output will be translated back and forth from ANSI to OEM characters. This feature translates characters using the CharToOem and OemToChar Win32 API functions.

"Should I use TAsaDataset or TAsaSQL to access my data?"
You can use either/or, or a mix between them. TAsaDataset is designed to work with Borland data-aware components (DBGrid, DBEdit etc), while TAsaSQL is designed with optimal ease of use and flexibility in mind. Actually TAsaDataset is just a wrapper class around a TAsaSQL instance, with added support for VCL data-aware controls.

"How can I think about TAsaSession compared to VCL's TDatabase and TSession?"
TAsaSession is actually a representation of both, while different in implementation and design. The requirement for one TAsaSession in each thread, makes it related to TSession while the general database connection methods relates it to TDatabase. Also note that TAsaSession contains all the database and connection settings that TDatabase keeps and maintain within the BDE and ODBC configuration tools.

Copyright 1995-2016 Liodden Data - All rights reserved - E-Mail: Last modified: