				Xvmadm Tutorial


		Media Management Utility (with graphical interface)

Tutorial topics:

	1. Introduction to xvmadm
	2. Motif
	3. X resources
	4. Configuring X server keyboard support
	5. Trademarks


1. Introduction to xvmadm

The xvmadm utility provides the same functionality as the vmadm
utility, but has a different user interface.  xvmadm uses the MIT X
Window System (tm) and the OSF/Motif (tm) look-and-feel to provide a
graphical user interface.  The prerequisite to usage of xvmadm is an X
terminal or a workstation that has an X server, compatible with MIT's
release X11R5 or later.  The vmadm utility is available for those who
lack X equipment or who prefer a character-based user interface.  All
xvmadm functionality is also available through the vmadd, vmchange,
vmcheckxxx, vmctrldbm, vmdelete, vminitlists, vmpool, vmquery, vmrule,
and vmupdate commands.

You must be the super-user (root) to use xvmadm.

2. Motif

xvmadm uses OSF/Motif 1.2 libraries to standardize its look and feel.

2a. Main window and dialog boxes, and Help.

xvmadm consists of a main window that is displayed for the duration,
plus several dialog boxes that popup when xvmadm needs more information
or to display more information. The main window consists of three panes.
Each pane contains a scrolled list. The menubar offers the commands that 
you can use to operate on the items displayed in these lists. Some of the 
commands can be used at any time and are always displayed in a normal font.
Other commands can only be used after you have indicated to which item the 
operation applies. Until you do so these commands are displayed in a greyed
out font, then they are displayed in a normal font once you have satisfied
the prerequisites. 

Similar to applications on a Macintosh or Microsoft Windows, the order
in which you use the mouse is to scroll as needed to see the right
information, then click the mouse upon an object to indicate that it
is what you intend to process, then pull a command from the menubar
which will initiate the operation.  Most commands will then require
additional information from you, and will popup a dialog box specific
to the situation.

A Help menu is shown at the far right edge of any menubar on the main
window.

Some dialogs have their commands on pushbuttons at the bottom. For these 
dialogs, help is available through a pushbutton labeled "Help" at the right 
bottom corner of the dialog.

2b. Scrollable lists.

There are several uses of the Motif "scrolled list widget".  This a
subwindow with one or more lines of text.  Scrollbars are automatically
provided any time there are more lines than can fit, or if any of the
displayed lines are too wide.  Each line of text is a target for mouse 
selection.

2c. Ellipses and arrows on menu items

By convention, if a menu command has an ellipses (three dots), then
the command will not complete until you have responded to a popup
dialog.  Such dialogs always offer you a way to cancel the command
without doing anything permanent.  So it is always safe to experiment
with any "ellipses" menu command and its dialog.

Some menu items are marked by a small right-pointing arrow or triangle. 
This means that when you drag or click the mouse onto this menu item, an 
additional menu will immediately cascade. Nothing will be done until you 
move the mouse and use the cascaded menu.

2d. Option menus

Some dialogs have Motif "option menus".  An option menu is a method to
select one of many mutually exclusive values.  Until you do something
with the mouse, the only screen area used is just enough to display
the value currently in effect.  This is shown inside a rectangle, plus
a tiny box is drawn near the right edge after the value label.  When
you operate the mouse anywhere within the larger rectangle, the menu
explodes to take enough screen area to show you all possible values.
After you have chosen one of the possible values, the menu contracts
back to minimal size to show your new value.


2e. Cursor shape

When xvmadm is performing an action for which there is a reasonable
expection that the response could take more than a few seconds, it
converts the cursor shape into an wristwatch.  Also, while a response is 
incomplete, some of the scrolled lists will be temporarily erased from the 
screen.

2f. Popup menus

The three lists in the main windows have popup menus through which most
of the actions that apply to the items in the lists can be done. A popup
menu is activated by pressing mouse button 3 while over the list.


3. X resources

An X resource file XNB is included in the NetBackup release materials.
This file can be used to customize xvmadm.


4. Configuring X server keyboard support

The NetBackup release materials include a model version of the
XKeysymDB file.  Some systems, particularly Sun machines using the
Open Look window manager, might not have default keyboard mappings for
various editing keys such as Backspace.  You should compare the text
within Media Manager's model XKeysymDB file with what you have on
your X server machine, and consider editing your copy of XKeysymDB to
include these keyboard mappings if they are not already there.

5. Trademarks

X Window System is a trademark of the Massachusetts Institute of
Technology.

Open Software Foundation, OSF, OSF/Motif, and Motif are trademarks of
the Open Software Foundation, Inc.



