NAME

vuesession — The HP VUE Session Manager.

SYNOPSIS

vuesession [options]

DESCRIPTION

Vuesession provides session management functionality during an HP VUE session, the time from login to logout.  It allows for saving a session, restoring a session, locking a session, and allocating colors for HP VUE compatible clients. 

When a session is saved, client information, server settings, and resources are retained.  Client information consists of all clients currently active in the session.  Server settings consist of settings (such as the beeper or keyboard) that are modified by a call to the server.  Resources consist of all resources currently stored on the RESOURCE_MANAGER property on the root window of the default screen. 

The session is locked by pressing the "lock" button on the workspace manager (front panel).  When the display is locked, no further input is accepted until a correct password is entered.  Correct passwords include the user who locked the display, the root password for the system, and any users specified in the keys resource. 

Color allocation provides each client with a set of colors which are used in creating visual components.  These colors can then be dynamically changed by using the HP VUE Style Manager (vuestyle(1X)). 

Vuesession is automatically invoked by the HP VUE Login Manager (vuelogin(1X)).  If the HP VUE Login Manager is not currently being used, vuesession can be invoked by putting the following command in an .xsession or .x11start file:

/usr/lib/X11/vue/etc/vuesession -norestore

WARNING:  This command must be the first X11 client in the file (other than xrdb).  It must be run in the foreground.  When using this command, no save and restore functionality is available.  Any calls that start up window managers must be removed from the startup file.  The default window manager can only be changed by setting the wmStartupCommand resource. 

OPTIONS

−norestore
This option allows users to use vuesession in a limited way.  The advantage of using this option is that vuesession can be started directly from an .x11start or .xsession script.  See use and warning above. 

CUSTOMIZATION

Vuesession’s behavior can be customized through the use of the HP VUE Style Manager’s startup dialog.  The following is the behavior that can be customized. 

Display Logout Confirmation
"Display Logout Confirmation" allows you to toggle the appearance of the logout confirmation box that appears after you click on the logout button located in the workspace manager, or choose the "Log out..." option available in the vuewm root menu.  Setting the button displays the logout dialog.  Clearing the button causes immediate exit with no confirmation.  The default behavior is that the logout confirmation dialog will be displayed. 

Set Home Session
The "Set Home Session" button allows you to save a home session for use later.  The home session is a "snapshot" session that you can return to by changing logout options.

Startup Behavior
The startup behavior allows you to specify which state the HP VUE Session Manager will restore upon startup (login).  The default is that it automatically restarts the state you were in at logout (Resume Current Session).  The other states available are "Return to Home Session" and "Ask Me at Logout."  "Return to Home Session" returns you to the last saved home session at next startup.  "Ask Me at Logout" allows you to choose which behavior you would prefer at logout time.  If "Return to Home Session" is chosen, a home session has to have been previously saved.  Otherwise the default system session will appear at next login.  Note that "Ask Me at Logout" cannot be active while "Display Logout Confirmation" is turned off.

RESOURCES

Vuesession uses the following resources. 

*The display type determines default. 

alarmTime
This resource specifies (in seconds) the amount of time before the lock dialog is removed from the screen.  When the display is locked, the pointer shows a lock cursor, and a dialog appears which asks for the user password.  If no activity from the pointer or keyboard is detected for alarmTime seconds, the dialog is removed from the screen.  The lock dialog is redisplayed as soon as a pointer or keyboard event is detected.  An alarmTime of 0 leaves the lock dialog in place for the entire time the display is locked.  The default value is 10 seconds. 

colorUse
This resource specifies the number of colors to use for the user interface. Valid types are:

•B_W —  Specifies a black and white system.  The color palettes will use two color cells for the user interface.  In this configuration only two color palettes are available: BlackWhite and WhiteBlack.  These palettes cannot dynamically change.  To change a palette, all applications using that color palette must be restarted.  This resource value forces ShadowPixmaps to True, and ForegroundColor to either black or white depending on the palette chosen. 

•LOW_COLOR — Specifies a low color system.  The color palettes will have two color sets and use a maximum of 12 color cells for the user interface, including black and white (color cells 0 and 1).  The number of color cells can be reduced by using the resources ShadowPixmaps and ForegroundColor. 

•MEDIUM_COLOR — Specifies a medium color system.  The color palettes will have 4 color sets and use a maximum of 22 color cells for the user interface, including black and white (color cells 0 and 1).  The number of color cells can be reduced by using the resources ShadowPixmaps and ForegroundColor. 

•HIGH_COLOR — Specifies a high color system.  The color palettes will have 8 color sets and use a maximum of 42 color cells for the user interface, including black and white (color cells 0 and 1).  The number of color cells can be reduced by using the resources ShadowPixmaps and ForegroundColor.  The default value for this resource will be determined by querying the X server for the number of color cells on the system. 

coverScreen
This resource specifies whether or not the screens of the display will be covered when the display is locked.  The default value is False, which means that the screens will not be covered.

dynamicColor
This resource can have values of True or False and is used to reduce the number of color cells being used. Once a palette has been selected and the user will not be changing palettes often, dynamicColor can be set to False.  When the session comes up next time, the color server will use Read Only color cells that can be shared by non-Motif1.1 clients, thus reducing total number of color cells used.  The default value is True. 

foregroundColor
This resource can have values of White, Black or Dynamic. ForegroundColor causes all text (foreground) to use either pixel 0 or 1 (Black or White) or to have a color cell dedicated to foreground and changes in response to the background color (Dynamic) for each ColorSet.  If set to White or Black, the number of color cells used per ColorSet is reduced by 1. 

keysThis resource is a list of "keyholders" who have the ability to unlock the screen any time it is locked by the user.  The list is a list of user id’s separated by commas.  For example if user kimd has the following resource active during a session: Vuesession*keys: fredh,keith Users fredh and keith have the ability to unlock the display when kimd locks it.

queryServerSettings
This resource specifies whether vuesession queries the server at logout for all its settings or saves only those settings set by using the HP VUE Style Manager.  Querying the server ensures that all settings are saved; however, there is a degradation in performance when a full query is done.  The default value is False, which means that the server will not be queried. 

shadowPixmaps
For color systems, this resource can have a value of True or False. If True, topShadowColor and bottomShadowColor use the same pixel as background and topShadowPixmap and bottomShadowPixmap are specified instead of solid color to create the 3D look.  This reduces the number of color cells per ColorSet by 2.  ShadowPixmaps defaults to True for systems with 4 or less color planes (16 or less color cells), and False for systems with more than 4 color planes. 

wmStartupCommand
This resource allows for an alternate window manager to be started at login.  If this display is NULL, vuesession starts /usr/bin/X11/vuewm.  An alternate startup might look like: Vuesession*wmStartupCommand: /usr/bin/X11/mwm Note that the command should not have any commands to a shell in it, and that it should not be surrounded by quotes.  Also, if any other window manager other than vuewm is used, clients will be restored, but may not be restored to the correct position.  By default, this resource contains a NULL value. 

writeXrdbColors
This resource should only be used if you are running non HP Motif 1.1 clients that have color schemes that conflict with HP VUE colors.  This has no impact on clients linked with the Motif 1.1 library.  This resource specifies whether color resource information should be written out. If set to False, background and foreground resources will not be written out with the values of the current palette.  This means that non HP Motif 1.1 clients will not get HP VUE colors when they are started.  The default value is True. 

COPYRIGHT

Copyright 1990 Hewlett-Packard Company. 

ORIGIN

Hewlett-Packard Comany ITO. 

RELATED INFORMATION

X(1), vuestyle(1X), vuewm(1X), vuelogin(1X). 

  —  HP VUE 2.01 (2/91)