Miscellaneous Functions

VOID lock(INDI|FAM);

lock a person or family in memory

VOID unlock(INDI|FAM);

unlock a person or family from memory

STRING database(void);

return name of current database

STRING version(void);

return version of LifeLines program

VOID system(STRING);

execute string as a UNIX shell command

STRING getproperty(STRING);

extract system or user property. Function available after v3.0.5.

Lock and unlock are used to lock a person or family into RAM memory, and to unlock a person or family from RAM memory, respectively.

Database returns the name of the current database, useful in titling reports. Version returns the version of the running LifeLines program, eg, 3.0.5.

System executes its string argument as a UNIX shell command by calling the UNIX system system call.

The getproperty function extracts system or user properties. Properties are named group.subgroup.property or group.property. The following keys are available at the moment:

user.fullname

The full name of the current user. This is fetched from the system when possible.

user.email

The email address of the current user. This is fetched from the system when possible.

user.address

Postal address of the current user.

user.url

URL to the users home page.

These values can be changed by adding values to user options. [Miscellaneous utilities->Edit the user options file]