dtappgather(1) UNIX System V (1 August 1995) dtappgather(1)
NAME
dtappgather - gather application files for presentation by
the Application Manager
SYNOPSIS
[ -r ]
DESCRIPTION
The Application Manager presents personal, system, and
factory applications in an easy-to-access window. The
Application Manager is implemented as a special File Manager
view of a subdirectory that is built on a per-user, per-
session basis. The dtappgather utility is responsible for
creating and refreshing the user's Application Manager
subdirectory.
The dtappgather utility is run at login and whenever the
user invokes the ReloadApps action. The user's individual
subdirectory for the Application Manager,
/var/dt/appconfig/appmanager/$DTUSERSESSION, is opened when
the user presses the Application Manager control on the
Front Panel.
The sequence of events is as follows:
o When the user logs in, the Xsession script
sources in the Xsession.d script that sets the
DTUSERSESSION environment variable.
o Xsession then invokes the dtsearchpath utility to
set the DTAPPSEARCHPATH environment variable.
o After dtsearchpath returns with the
DTAPPSEARCHPATH assembled, the Xsession script
calls dtappgather.
o As its main function, dtappgather traverses the
DTAPPSEARCHPATH, examining each possible source
of applications and, where there are existing
source subdirectories, creates symbolic links
between the source and the user's DTUSERSESSION
subdirectory.
o Finally, dtappgather turns off write permissions
on the resulting subdirectory to ensure its
integrity.
A similar sequence occurs when the user double-
clicks the ReloadApps action after logging in.
Although the value of the DTAPPSEARCHPATH can be
modified in a local shell, the Application
Page 1 (printed 9/3/04)
dtappgather(1) UNIX System V (1 August 1995) dtappgather(1)
Manager view based on its value is not functional
until you log out and log back in. Since this
can be a tedious venture, you can verify the
Application Manager view by executing
dtsearchpath(1) and dtappgather in the local
shell. For example, to add host trout as a
system-wide application server, set the
dtsearchpath(1) input environment variable,
DTSPSYSAPPHOSTS:
DTSPSYSAPPHOSTS=trout:
Then, execute dtsearchpath(1) to update the
DTAPPSEARCHPATH environment variable.
eval `dtsearchpath`
Finally, gather the new applications by executing
dtappgather. The Application Manager will show
the new application groups but will not be
functional.
OPTIONS
The -r option causes dtappgather to retain the previous
contents of the Application Manager, although discarding
broken links. At login, dtappgather destroys the user's
previous DTUSERSESSION subdirectory before creating a new
one. At ReloadApps time, the -r option is used to minimize
visual disruption of any opened Application Manager views.
RETURN VALUES
The command always returns 0 (zero) for successful
completion.
ENVIRONMENT
DTAPPSEARCHPATH
Set by the dtsearchpath(1) utility.
DTAPPSEARCHPATH controls the places where
dtappgather will gather applications. The
default locations consist of
$HOME/.dt/appmanager (for end users),
/etc/dt/appconfig/appmanager/$LANG (for
system administrators), and
/usr/dt/appconfig/appmanager/$LANG (for
factory applications).
DTUSERSESSION Controls the location of the end user's
subdirectory where the Application Manager
will be rooted. The subdirectory name
includes both the user's $LOGNAME and
$DISPLAY in order to ensure the user's
view of the Application Manager remains
Page 2 (printed 9/3/04)
dtappgather(1) UNIX System V (1 August 1995) dtappgather(1)
consistent across sessions.
LOCALES
When searching for system administrator and factory default
Application Manager files, dtappgather always uses a value
of $LANG equal to C. When the user picks a language at
login, the corresponding $LANG subdirectories are searched.
If multiple $LANG subdirectories exist in
/etc/dt/appconfig/appmanager, all $LANG subdirectories will
appear in the Application Manager; however, if multiple
$LANG subdirectories exist in /usr/dt/appconfig/appmanager
then the language-specific subdirectory based on the current
value of $LANG is chosen instead of the C subdirectory.
Regardless of locale, all the action files that exist under
the user's $HOME/.dt/appmanager subdirectory will be
symbolically linked to the user's Application Manager
subdirectory.
FILES
/usr/dt/bin/Xsession
Among its tasks at login, the Xsession
script invokes dtsearchpath(1), and then
dtappgather.
/var/dt/appconfig/appmanager/$DTUSERSESSION
This subdirectory is where dtappgather
assembles the Application Manager view for
the particular user and CDE session.
NOTES
In the case of multiple search locations having the same
name, dtappgather picks only the first and discards the
rest. For example, if the system administrator sets
DTSPSYSAPPHOSTS=tuna:,trout:
and if both hosts, tuna and trout, have an
/etc/dt/appconfig/appmanager/C/Editors folder, then only the
Editors folder from tuna (the first host) will appear in the
user's Application Manager.
After building the user's DTUSERSESSION, dtappgather turns
off write permissions on that subdirectory to disallow
alteration by the end user. Although the end user can
resize the window and rearrange the icons within the window,
the Application Manager is intended to be a read-only source
of local and networked applications.
SEE ALSO
dtappintegrate(1), dtsearchpath(1).
Page 3 (printed 9/3/04)