The Data Manager extension provides access to several of the Palm OS Data Manager API functions.

Parameters

Bit flags for database attributes:

DmHdrAttrResDB                       &H0001 - resource database attribute

DmHdrAttrReadOnly                   &H0002 - read-only database attribute

DmHdrAttrAppInfoDirty               &H0004 - dirty records attribute

DmHdrAttrBackup                      &H0008 - backup bit attribute

DmHdrAttrOKToInstallNewer       &H0010 - can be installed over

DmHdrAttrResetAfterInstall         &H0020 - reset handheld after installing attribute

DmHdrAttrCopyPrevention          &H0040 - prevents copying the file

DmHdrAttrStream                      &H0080

DmHdrAttrHidden                       &H0100 - hidden file attribute

DmHdrAttrLaunchableData          &H0200

DmHdrAttrOpen                         &H8000

Please see the document titled "Data and Resource Manager" in Palm's "KnowledgeBase" for more information on these attributes.

Scripts API’s

All methods are global.

            Usage:  [Name of Method]

            Example of usage:  PDM_About()

PDM_About()

Shows about box.

PDM_DeleteDb(integer, integer)

Deletes the specified database. 

Example of usage:  err = PDM_DeleteDB(CardNo, LocalID).

PDM_GetLastError()

Returns the last error code.

PDM_GetDbName()

Returns the name of the LastDb cache item.

PDM_GetDbBckUpDate()

Returns the last back up date of LastDb cache

PDM_GetDbBckUpDateStr

Returns the last back up date of LastDb cache as a string

PDM_GetDbCardNo()

Returns the card no. of LastDb cache

PDM_GetDbCrDate()

Returns the creation date of LastDb cache

PDM_GetDbDataBytes()

Returns the number of bytes of the data portion of LastDb cache

PDM_GetDbModDate()

Returns the modification date of LastDb cache

PDM_GetDbModDateStr

Returns the modification date of LastDb cache as a string

PDM_GetDbModNum()

Returns the number of modifications of LastDb cache

PDM_GetDbSortInfoID()

Returns the sort info ID of LastDb cache

PDM_GetDbType()

Returns the type of LastDb cache

PDM_GetDbNumRecords()

Returns the number of records contained in LastDb cache.

PDM_GetDbTotalBytes()

Returns the number of bytes of LastDb cache

PDM_GetDbVersion()

Returns the version of LastDb cache

PDM_GetNextDb()

Consecutive calls to this API will traverse all database files matching the search criteria.

PDM_GetNumberOfMatchingDb(string, string, Boolean)

Returns the number of matching DBs.

Example of usage:  PDM_GetNumberOfMatchingDb(CreatorID, TypeID, Version)

PDM_LoadDb(integer, integer)

Loads the specified Db into the LastDb cache.

Example of usage:  PDM_LoadDB( LocalID, CardNo )

PDM_NewDbIterator(string, string, Boolean)

Starts a new search query.  Use this method to set the paramters for your next search.  Use PDM_GetNexDb() or PDM_GetNumberOfMatchingDb() to grab the files matching the search criteria.

Example of usage: PDM_NewDbIterator( CreatorID, TypeID, Latest_Version ) where 'CreatorID' specifies the creator ID to search for, 'TypeID' specifies the type of file to search for, and 'Latest_Version' can specify the version of the file.  Each of these can be set to "".  In order to search for all files simply set all  the parameters to "".

PDM_SetDbAttributes(integer, integer, integer)

Sets the attributes of the specified database file.  See the Parameters section above for information on attributes.

Example of usage:  err = PDM_SetDbAttributes(LocalID, CardNo, DBAttributeToSet)

PDM_Version()

Returns the version of this extension.

DocID: 10142  DocDate: 2005-07-18