Data Manager
Previous Topic  Next Topic 

Product

Data Manager

Manufacturer

Standard Satellite Forms component

Website

http://www.satelliteforms.net/

Source code provided

Yes

Platform

PalmOS

Sample project(s)

View It!, Beam It!, Resource

Keywords

data, file, database


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