The Common Desktop Environment application integration tool.
dtappintegrate -s ApplicationRoot [ -t TargetPath ] [-l Language ] [ -u ]
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
|-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.|