Common Desktop Environment: Desktop KornShell User's Guide

Built-in libDt Action Commands

The set of commands in this section provide you with the tools for loading the action databases, querying information about actions defined in the databases, and requesting that an action be initiated.

DtDbLoad

Reads in the action and data-types databases. If called multiple times, then the old databases are freed before the new ones are read. This command must be called before any of the other libDt action commands, or any of the libDt data typing commands. The shell script should also use the DtDbReloadNotify command, so that the shell script can be notified if new databases must be loaded.

DtDbReloadNotify ksh-command

Requests notification whenever the action or data-types databases need to be reloaded. The specified kshell command is executed when the notification is received. Typically, the kshell command includes a call to the DtDbLoad command.

DtActionExists actionName

Tests to see if an action exists in the database with the name specified by the actionName parameter. Returns a value which can be used in a conditional statement.

DtActionLabel variable actionName

Returns the localizable LABEL attribute associated with the indicated action. If the action does not exist, then an empty string is returned.

DtActionDescription variable actionName

Returns the value of the DESCRIPTION attribute associated with the indicated action. An empty string is returned if the action is not defined, or if the DESCRIPTION attribute was not specified.