DFBTR_Add_Owner

Purpose

Add an owner name to the list of owner names.

Syntax

DFBTR_ADD_OWNER Owner

Owner: The owner name to add to the internal list. It may be a constant or a string variable.

What It Does

This command adds an owner name to the list of owner names kept by the driver. These owner names will be used when opening a Pervasive.SQL data table. An owner name has a maximum length of 8 characters and is case sensitive.

The driver maintains an internal list of owner names to use when opening Pervasive.SQL tables. Whenever a Pervasive.SQL table needs to be opened without an assigned individual owner name, the driver will attempt to use the first owner name in the list. If it fails, it will try the next owner name in the list until it reaches the end. If it still cannot open the table after trying all owner names, it will attempt to open the table without an owner name.

If the owner name list is empty, the driver will immediately try to open the table without an owner name. If it still cannot open the table, it will generate an error 21051 (BTR:51).