Commands Reference, Volume 2

dtappintegrate Command

Purpose

The Common Desktop Environment application integration tool.

Syntax

dtappintegrate -s ApplicationRoot [ -t TargetPath ] [-l Language ] [ -u ]

Description

The dtappintegrate command links the application CDE configuration files from application-specific locations to system locations and updates the system's Browser help volumes for the languages affected. The dtappintegrate command is used during the installation process of an application. The application installation script should invoke the dtappintegrate command at the end.

There are four key subdirectories under the application root (referred to as $APP_ROOT ) dictated by CDE policy. The directories are:

$APP_ROOT/dt/appconfig/types/ Language	For filetype, Front Panel, and action files.
$APP_ROOT/dt/appconfig/appmanager/ Language	For application group files.
$APP_ROOT/dt/appconfig/icons/ Language	For icons used by the CDE managers.
$APP_ROOT/dt/appconfig/help/ Language	For application help. For example, the default-language application SpreadSheet would load its desktop icons under: /opt/SpreadSheet/dt/appconfig/icons/C/.bm and /opt/SpreadSheet/dt/appconfig/icons/C/.pm, where /opt/SpreadSheet is the value of $APP_ROOT.

Note: $APP_ROOT is a syntactical convention of this document and is not used by the runtime environment.) All of these CDE configuration files and subdirectories are placed under a common top and should always include the default language subdirectory C.

In the simplest case, the command takes as input the application root, for example, /opt/thisapp. The outputs from this operation are corresponding subdirectories and files on the application server that contain relative symbolic links to the applications CDE configuration files described above, under the following system locations:

/etc/dt/appconfig

Top-level application configuration subdirectory, consists of following subdirectories:

/etc/dt/appconfig/types/Language/: Contains the *.dt and any *.fp links.
/etc/dt/appconfig/appmanager/Language/: Contains links to the application group subdirectory and the action script files to appear as actions under the Application Manager.
/etc/dt/appconfig/help/Language/: Contains symbolic links to the help files installed under the application's root.
/etc/dt/appconfig/icons/Language/: Contains symbolic links to the CDE icons for the application.

Flags

-s ApplicationRoot	Integrates the application located at ApplicationRoot. This flag is required.
-t TargetPath	Links the application CDE configuration files from the application-specific location to TargetPath rather than to the system locations. This flag is optional. If the -t flag is supplied, the files are linked under the specified subdirectory. For example, specifying -t /etc/dt/private would cause the application help files to be symbolically linked under /etc/dt/private/help/Language. This flag is typically used only by system administrators who want to create separate applications and not by the application post-installation script. By default (with no -t specified), the application subdirectory root is global to the application host. All applications installed on the host will have their configuration files copied to the same place for merging with other application configuration files.
-l Language	Specifies the language to integrate. Basically, this flag indicates the directories under which to find the application CDE configuration files. If this parameter is not specified, all languages will be integrated. This parameter is optional.
-u	Integration of application is canceled. This flag is optional.