Performs two different functions:
When creating a database, this parameter names the new database file.
When opening a connection to an existing database, this parameter identifies the database.
An UltraLite client application that connects to a Palm device in addition to another platform using the same connection string.
If you are connecting from an UltraLite administration tool, or your connection object only connects to a Palm OS database, use DBF.
PALM_FILE=name
PALM_FILE=vfs: [ volume-label: | volume-ordinal: ] filename
The default depends on what you set:
If you do not set a value for this connection parameter, then the value for the DBF parameter, if one has been set, is used.
If you do not set a value for this parameter or the DBF parameter, then the default value is ulstore.udb.
RecommendationAlways explicitly specify the parameter; do not rely on default behavior. |
Do not use this parameter with desktop administration utilities; use the DBF parameter instead while working with Palm databases.
The value of PALM_FILE must meet the file name requirements for Palm OS platforms.
If you are developing on AppForge, you also need to use the PALM_DB parameter.
This parameter takes precedence over the DBF parameter.
On file-based stores, always specify the absolute file path. If directories are specified in the full path name, they are created if they do not already exist.
Any leading or trailing spaces in parameter values are ignored. This connection parameter's value cannot include leading single quotes('), leading double quotes ("), or semi-colons(;).
The following example creates a new connection and identifies different database files for the desktop, Palm OS, and Windows CE platforms:
Connection = DatabaseMgr.OpenConnection("UID=JDoe;PWD=ULdb; NT_FILE=c:\test\MyTestDB.udb;CE_FILE=\database\MyCEDB.udb;PALM_FILE=MyPalmDB_MyCreatorID")