VxVM User's Guide

X Resources for the Visual Administrator

Appendix A

This appendix lists X resources that can be used to configure the Visual Administrator according to personal preferences and system requirements. The default values specified here correspond to the defaults that have been compiled into the Visual Administrator. Preferences specified in the system's app-defaults file may change these defaults.

The files in /opt/vxva/app-defaults contain a subset of resources that can be used to customize some aspects of the Visual Administrator, such as fonts and colors.

The X resources and associated preferences can be specified in the user's .Xdefaults file. Refer to the X Window System documentation on X resources for further information.

Visual Administrator entries in the .Xdefaults file should take the following form:

	vxva*resource:    value

For example, the color used to represent a disabled icon can be altered from the default color (grey) to orange by editing the .Xdefaults file to include the following line:

	vxva*disabledPixel:  orange

Resources for the Visual Administrator can also be specified for a single session only by invoking the Visual Administrator as follows:

	vxva -xrm "vxva*resource:  value"

The following are the resources and their default values, which can be changed according to user preferences. The resources are listed to the left with their default values to the right. Each resource-value pair is prefaced by a brief description.

Color Resources

The following resources apply only when the Visual Administrator is run on a color monitor. The current default settings are listed below.

The basic background colors affect the entire background, unless you specify an override value.

The default background and foreground colors are as follows:

background    white
foreground    black

The colors used for all menus and menu bars, except the command window:

menubar*background    SteelBlue
menubar*foreground    white

The foreground and background color used for the VERITAS logo:

Logo.foreground    #36648B
Logo.background    White

The background color used under the main window buttons (both values must be set to the same color):

swindow*XmDrawingArea.background    #33648B
swindow*row_column.background    SteelBlue4

The background color used for the main window menu bar:

RootWin.menubar*background    SteelBlue
RootWin.menubar*foreground    White

The colors used for the command window menu bar:

cmd_main.cmd_menubar*background    SteelBlue
cmd_main.cmd_menubar*foreground    White

The basic outline colors used for the command window:

cmd_main*background    #4F94CD
cmd_main*cmd_pane*foreground    White

The colors used for the output text area in the command window:

cmd_main*cmd_pane*XmText.background    #63B8FF
cmd_main*cmd_pane*XmText.foreground    Black

The colors used for the history and the running command lists in the command window:

cmd_main*cmd_pane*XmScrolledWindow.XmList.background    #63B8FF
cmd_main*cmd_pane*XmScrolledWindow.XmList.foreground    Black

The color used for the menu bar in the view windows:

TopLevelShell.XmForm.menubar*foreground    White
TopLevelShell.XmForm.menubar*background    #63B8FF

The color used for the background in the view windows and scroll bars:

TopLevelShell.XmForm.ViewScroll.XmDrawingArea.background    #d9f0ff
TopLevelShell.XmForm.ViewScroll.XmScrollBar.background    White
TopLevelShell.XmForm.ViewScroll.background    White

The background color used for forms:

TopLevelShell.propertiesForm*background    #4F94CD

The color used for the foreground for text forms:

TopLevelShell.propertiesForm*foreground    White

The highlight color used behind form text fields and toggle buttons. For consistency, use the same color:

TopLevelShell.propertiesForm.XmForm*XmText.background    #7EC0EE
TopLevelShell.propertiesForm.XmForm.Toggle.XmToggleButton*background    #7EC0EE

The highlight color used behind the file system information property sheet text fields and toggle buttons. For consistency, use the same color:

TopLevelShell.propertiesForm.XmForm.FsMenuForm*XmText.background
    #7EC0EE
TopLevelShell.propertiesForm.XmForm.XmForm.Toggle.XmToggleButton.background
    #7EC0EE

The default color used for a volume in a view:

TopLevelShell.XmForm.ViewScroll.XmDrawingArea*VolWidgetClass.background
    #99cdeb

The default color used for a VM disk in a view:

TopLevelShell.XmForm.ViewScroll.XmDrawingArea*VmdiskWidgetClass.background
    #99cdeb

The default color used for a physical disk in a view:

TopLevelShell.XmForm.ViewScroll.XmDrawingArea*DiskWidgetClass.background    
#99cdeb

The default color used for a plex in a view:

TopLevelShell.XmForm.ViewScroll.XmDrawingArea*PlexWidgetClass.background
    #a3dbfa

The default color used for a subdisk in a view:

TopLevelShell.XmForm.ViewScroll.XmDrawingArea*SubdiskWidgetClass.background
    #c2efff

The default color used for a physical disk partition which is not associated with a disk group:

TopLevelShell.XmForm.ViewScroll.XmDrawingArea*PartWidgetClass.background
    #c2efff

The colors used for the notice popup windows:

Notice_popup*background    SteelBlue
Notice_popup*foreground    White

The color used for icons that have been selected:

selectedPixel    green

The color used for icons that are disabled and cannot be used by the Visual Administrator. For example, the color to be used for detached plexes:

disabledPixel    gray

The color used for icons that have been selected when a Visual Administrator error occurs (incorrectly selected icons, for example):

alarmPixel    red

The color used for subdisk icons that are free (unassociated) when "Show Free Subdisks" has been turned on:

freesdPixel    yellow

The color used for icons that are projecting (displaying object relationships) when "Icon Projection" has been turned on for that icon or a related icon:

projectPixel    yellow

The color used for icons that have a low usage level (as defined in the Analysis Properties Form [Table 14]) when analysis has been turned on for that icon or a related icon:

lowPixel    green

The color used for icons that have a medium usage level (as defined in the Analysis Properties Form [Table 14]) when analysis has been turned on for that icon or a related icon:

midPixel    yellow

The color used for icons that have a high usage level (as defined in the Analysis Properties Form [Table 14]) when analysis has been turned on for that icon or a related icon:

highPixel    red

The color used to indicate whether VA should run in monochrome mode. When True is specified, the Visual Administrator is forced to operate in monochrome (black and white) mode, whether or not a color monitor is being used:

mono    False

Monochrome Resources

The following resources only apply when the Visual Administrator is run on a monochrome monitor.

The color in which all foreground items are displayed. This typically applies to icon outlines and text:

foreground    black

The color that serves as the background for all windows in the Visual Administrator:

background    white

The bitmap pattern for icons that have been selected:

selectedPixmap    gray3

The bitmap pattern for icons that are disabled and cannot be used by the Visual Administrator (detached plexes, for example):

disabledPixmap    stripe4

The bitmap pattern for icons that have been selected when a Visual Administrator error occurs (incorrectly selected icons, for example):

alarmPixmap    gray1

The bitmap pattern for subdisk icons that are free (unassociated) when "Show Free Subdisks" has been turned on:

freesdPixmap    root_weave

The bitmap pattern for icons that are projecting (displaying object relationships) when "Icon Projection" has been turned on for that icon or a related icon:

projectPixmap    root_weave

The bitmap pattern for icons that have a low usage level (as defined in the Analysis Properties Form) when analysis has been turned on for that icon or a related icon:

lowPixmap    cross_weave

The bitmap pattern for icons that have a medium usage level (as defined in the Analysis Properties Form) when analysis has been turned on for that icon or a related icon:

midPixmap    root_weave

The bitmap pattern for icons that have a high usage level (as defined in the Analysis Properties Form) when analysis has been turned on for that icon or a related icon:

highPixmap    wide_weave

Icon Resources

The following resources relate to the Visual Administrator icons.

When True is specified, volume icons will be minimized when created, by default:

volumeMinimizeIcons    False

When True is specified, plex icons will be minimized when created, by default. This feature is useful to display structures within volumes, but to hide details about the subdisk structure that makes up the plex:

plexMinimizeIcons    False

When True is specified, disk icons will be minimized when created, by default:

diskMinimizeIcons    False

When True is specified, physical disk icons will be minimized when created, by default:

phyDiskMinimizeIcons    False

When True is specified, icons selected for an operation are automatically de-selected when the operation completes. If set to False, icons remain selected until the user decides to deselect them, making it possible to perform multiple operations on the same set of selected icons:

autoDeselect    True

Miscellaneous Resources

The following are miscellaneous resources.

When True is specified, the Visual Administrator will be run in tutorial mode whether or not the -t command line option has been specified. This function is useful for users who are learning to use the Visual Administrator:

tutorial    False

The title of the Visual Administrator's main window:

title    "Visual Administrator"

Specify the number of command silos supported. A command silo is a set of sequentially dependent commands (like file system create, followed by file system mount). A larger number of silos supports a larger number of concurrent operations that can be run, but also requires the Visual Administrator to use more memory:

commandSilos    50

Specify the number of commands that the Visual Administrator should remember and display in the history portion of the Command Info Window:

commandHistorySize    20

Specify the name of the disk group to be popped up by default when the Visual Administrator is run:

defaultViewWindow     NONE

Specify how often, in seconds, the Visual Administrator should check the system mount table to accurately display information about mounted file systems:

chkMntptInterval    5

When True is specified, the Visual Administrator will force the mouse to be remapped so that it can be used with a two button mouse:

twoButtonMouse    False

Changes the height of the Visual Administrator forms and the menu bars. For small resolution displays, this value can be set to 0:

marginHeight    1

Changes the width of the Visual Administrator forms and menu bars. For small resolution displays, this value can be set to 0:

marginWidth    1

The following example shows you how to change the number of columns from its default value of 6 to 12 using a resource:

vxva*viewname*numColumns    12

Substitute viewname with World, rootdg, volumes, or user created view names.

Font Settings

This section lists the existing default font settings.

The following affects the font used in views of plexes, volumes, and subdisks:

vxva.fontList    -*-lucidatypewriter-medium-r-*-*-*-120-*-*-*-*-*-*

The default font used for all menu bars:

menubar*fontList    -*-helvetica-bold-r-normal-*-*-140-*-*-*-*-*-*

The font used for the command window menu bar:

cmd_main.cmd_menubar*fontList
    -*-helvetica-bold-r-normal-*-*-140-*-*-*-*-*-*

The font used for the labels on the main window buttons:

swindow*row_column*fontList
    -*-helvetica-medium-r-*-*-*-140-*-*-*-*-*-*

The font used for the form buttons:

TopLevelShell.XmForm.XmFrame*fontList
    -*-helvetica-bold-r-normal-*-*-140-*-*-*-*-*-*

[Next] [Previous] [Top] [Contents] [Index]