                               Xvmadm Main Window Help




Menu Bar

	The menu bar in the main window has the following pulldown menus:

	File    Commands for the general administration of the xvmadm session.
		For example, there are commands for starting and stopping the
		Media Manager volume daemon (vmd). There is also a command for
		opening the device management window (xdevadm) and for
		changing the Volume Database Host.

		Device Management
			Opens the device management window (xdevadm). This menu
			item is greyed out if an xdevadm has already been 
			started from xvmadm. 

		Initiate Media Manager Volume Daemon
			Will start the Media Manager volume daemon (vmd). This
			item is greyed out when vmd is running.

		Terminate Media Manager Volume Daemon
			Will stop the Media Manager volume daemon (vmd). This
			item is greyed out if vmd is not running.

		Change Volume Database Host
			Opens a dialog from which you can change the current
			volume database you are managing to a volume database
			that resides on a different host.

		Exit
			Exits the xvmadm program.

	Actions 
		Commands for performing configuration actions on volumes,
		volume pools, and volume groups

		New 
			Provides a submenu from which you can choose to add
			new volumes or volume pools to the configuration.

		Change 
			Opens a dialog for each selected volume or volume
			pool and allows you to change its current configuration
			options. This command is not available for volume 
			groups.

		Move 
			Opens a dialog in which you can specify where to move
			a volume or a volume group. This command is not 
			available for volume pools.

		Change Volume Group
			Opens a dialog for each unique residence corresponding
			to the selected volumes and allows you to change the
			volume group of the selected volumes.

		Delete 
			Deletes selected volumes, volume pools, or volume 
			groups from the configuration.

		Eject
			Ejects a selected volume from a robot.  This command
			does not support ejection of multiple volumes as one
			operation. 

		Update Barcodes 
			Updates the barcodes for volumes you select in the 
			Volumes list.

	View    
		Commands for changing the lists that xvmadm displays in the
		main window.

		All three lists appear when you start xvmadm. However, you
		can choose not to display the volume pools or volume groups
		(or both). The volume list always appears and cannot be
		turned off through the View menu.

		There are also menu items for formatting the lists and
		initiating an immediate refresh of the main window.

		Show Volume Pools

		Show Volume Groups

		Volumes
		Volume Pools
		Volume Groups
			These three menu items will each provide a submenu
			with the menu items explained below. Each submenu
			applies to its list. If a particular list is not
			shown, the menu item that corresponds to the list
			will not be displayed.

			Select All
				This will select all the items in the 
				corresponding list.
		
			Deselect All
				This will deselect all the items in the
				corresponding list.

			Columns
				Will open a dialog in which you can change
				which columns are displayed for each item in
				the list, as well as the width and position of
				each column.

			Sort
				Opens a dialog in which you can change how the
				corresponding list is sorted.

			Filter
				Opens a dialog in which you can change how the
				corresponding list is filtered.

			Find
				Opens a dialog in which you can search the
				corresponding list for a particular string.
				
			Print List 
				Opens a dialog from which you can print the
				contents of the corresponding list to a file.
				
	Options
		Save Settings on Exit?
			This is a toggle button. When the toggle is set the
			"View" settings (the list format setting which can
			be set under the View menu) will be saved to the
			.xvmadmrc file on exit. If this file exists when xvmadm
			is initiated, xvmadm will read in the "View" settings
			and apply them. 

	Reports
		Commands to inventory robots and to obtain a detailed volume
		information report.
        
		Robot Inventory
			Will open a dialog in which you can create inventory
			reports for robotic devices that have volumes defined
			in the volume database.

			The Show Robot Contents report provides a slot-by-slot
			inventory of a selected robot.  The Compare Contents
			with Volume Configuration report will compare what is
			physically in the robot to what is in the volume
			database for that robot.

		Volume Detail
			Will open a dialog in which you can generate a detailed
			multi-line listing for a volume or volumes.

	Robots 
		Commands to update the volume database with the contents of a 
		robot as obtained from an inventory, and options for configuring
		barcode rules to be used during an update.
		
		Use Inventory to Update Volume Configuration
			Will open a dialog in which you can update the volume
			database with the contents of a robot.  This will 
			actively update the database, based on differences
			detected during a robot inventory.  In addition, robot
			inventory reports can be generated from this dialog.

		Barcode Rules
			Will open a dialog in which you can add, change, delete,
			and list barcode rules, which are used to initialize
			media added during the Update Volume Configuration
			operation.

	Windows 
		Lists each volume, volume pool, or volume group window that is
		currently open. This is very useful when you have windows open
		for several items and some are not visible on your desktop.
		Selecting a window from the list raises that window to the top.

	Help    
		Provides online help information about xvmadm.

	Some menu commands require you to select a volume, volume pool, or
	volume group before pulling down the menu. For example, you must select 
	a volume to change it.  The commands that require a prior selection 
	appear in faded type (greyed out) and are inactive until you make the 
	prerequisite selection.

	Other commands are always available without prior selection. For 
	example, the New command is always available.

	Within the menus and dialog boxes, the following special conventions 
	apply:
	
	    An ellipsis (...) to the right of a menu command indicates that 
	when you select the command, a dialog box with additional choices 
	appears. Command dialog boxes also have cancel buttons that allow you 
	to abort the command without making any changes. If there is no ellipsis
	in a menu command, the operation occurs as soon as you select it.

	    A small right-pointing triangle to the right of a menu command 
	indicates that the command is cascaded. A cascade is a linkage to 
	another pulldown menus so when you select a command, another menu 
	immediately appears. If you select a cascaded command from the second 
	menu, a third menu appears. This process continues until you select a 
	command without the cascade triangle and execute the command or open a 
	dialog box (if that command is followed by an ellipsis described above).

	    If the cursor is over the main window, it changes from the arrow 
	shape to a wristwatch shape when xvmadm is waiting for an operation to 
	complete.  For example, the cursor changes to a wristwatch shape when 
	xvmadm is updating the detailed description list and changes back to an 
	arrow shape when the update is complete.

	Volume Database Host

	The line just below the menu bar shows the host that has the volume 
	database you are currently managing. The information in the Volumes, 
	Volume Pools, and Volume Groups lists was all extracted from this 
	volume database. You can change the volume database host by using the 
	Change Volume Database Host command from the File menu.



Lists in the Main Window

	The xvmadm main window can contain up to three panes. If the information
	in a pane is too long or wide to fit, a scroll bar allows you scroll it.
	Following is a description of the three panes each which contains a
	scrolled list.

	Volumes 

	Lists the volumes in the volume database you are currently managing. 
	The host that has this database is specified on the Volume Database 
	Host line, just above the Volumes list.

	Volume Pools    

	Lists the volume pools in the volume database you are currently 
	managing.

	Volume Groups

	Lists the volume groups in the volume database you are currently 
	managing.

	You can select volumes, volume pools, or volume groups from their
	respective lists by using the mouse, keyboard, or the Select All 
	command from the View submenus. It is not possible to select items 
	from more than one list at a time.

	When an list item is selected, you can perform actions on it. For 
	example, selecting a volume enables you to change the attributes of that
	volume by using the Change command from the Actions menu.

	The number of items selected in a list appears in the upper right of 
	that pane.



Volumes List

	The Volumes list is in the upper section of the main window and shows 
	information about the volumes in the database. You specify much of this 
	information when you add volumes to the database and being familiar with
	it will be useful during configuration.

	The Volumes list always shows at least some subset of the volumes 
	currently in the volume configuration. (If volumes exist but do not 
	appear, vmd is not running and must be started, or the filter criteria 
	are in error.)  You can change the criteria for displaying volumes by 
	using the Volumes command from the View menu.

	You can change the format of this list, including the columns that 
	appear, by using commands from View menu.  Each column that can appear 
	in this list is defined below.

	You can also choose Volume Detail from the Reports menu to get 
	information about one or more volumes in multiple-line format that is 
	more convenient for viewing in some instances.  The Volume Detail report
	can also be printed to a file for printing or other manipulation.


	The following are the column definitions for the Volumes list:

	Media ID

		Uniquely identifies the volume within the database in six 
		alphanumeric characters or less.  This value is synonymous 
		with an external volume serial number (EVSN).

		You specify the media ID when you add volumes to the database. 
		When you add a volume to an optical disk media type, you specify
		media IDs for both side A and side B of the platter.  The media 
		ID is eventually matched to the VSN specified on a tpreq command
		so a user can request a specific volume.

		This name is converted to uppercase, left-justified, and 
		blank-filled in its field.

	Media Type

		Identifies the media type of the volume. When you add one or 
		more volumes, the utility displays the list of possible types 
		from which you can choose. When you display information, the 
		following designations are used.

                  DLT      -  DLT cartridge tape
                  8MM      -  8MM cartridge tape
                  4MM      -  4MM cartridge tape
                  HCART    -  1/2" cartridge tape
                  DTF      -  DTF cartridge tape
                  REWR_OPT -  Rewritable optical disk
                  WORM_OPT -  WORM optical disk
                  QCART    -  QIC - 1/4" cartridge tape
                  DLT2     -  DLT cartridge tape alternate
                  HCART2   -  1/2" cartridge tape alternate
                  DLT_CLN  -  DLT cleaning tape
                  8MM_CLN  -  8MM cleaning tape
                  4MM_CLN  -  4MM cleaning tape
                  HC_CLN   -  1/2" cleaning tape
                  DTF_CLN  -  DTF cleaning tape
                  DLT2_CLN -  DLT cleaning tape alternate
                  HC2_CLN  -  1/2" cleaning tape alternate

	Barcode

	Uniquely identifies the barcode of a DLT, 8MM, 4MM, half-inch or DTF
	cartridge tape volume in 8 alphanumeric characters or less.  When you 
	add one or more cartridge tape volumes to a TL8, TC8, TS8, TC4, TSD,
	or TLD robot, the robot automatically scans the barcodes; you need not 
	enter them at the keyboard.

	When displayed, the code is converted to uppercase, right-justified, 
	and blank-filled in its field.

	Description

	Describes the volume in 25 alphanumeric characters or less. You create 
	the description yourself when you add one or more volumes. When you add 
	a range of volumes, you specify a single description that applies to 
	all the volumes in the range.

	Robot Type

	Identifies the type of robot containing this volume.  The Volumes list 
	uses the following designations:

                  NONE - Not Robotic
                  TLD - Tape Library DLT
                  TSD - Tape Stacker DLT
                  ACS - Automated Cartridge System
                  TS8 - Tape Stacker 8MM
                  TC8 - Tape Carousel 8MM
                  TL8 - Tape Library 8MM
                  TL4 - Tape Library 4MM
                  TC4 - Tape Carousel 4MM
                  ODL - Optical Disk Library
                  TSH - Tape Stacker Half-inch
                  TLH - Tape Library Half-inch
                  TLM - Tape Library Multimedia

	This is also sometimes referred to as physical location.  When you add 
	one or more volumes that could reside in a robot, you specify either 
	that they will be standalone (Not Robotic) or the type of robot in which
	they will reside.  This characteristic does not apply to
	QIC - 1/4 inch cartridge tapes because they are always standalone.

	Robot #

	Identifies the number of the specific robot that contains this volume.
	If the robot type is NONE, this field contains a hyphen character (-).

	Robot Host

	Identifies the name of the host controlling the robotics (via either 
	RS-232 or SCSI communications) for the robot specified by the robot 
	number.  When you add one or more volumes, you must specify the host 
	name if the media is for a robot and you chose a new (unused) robot 
	number.  For ACS and TLM robots, any Media Manager server can "control",
	or communicate, with the robot.  Because of this, the robot host is
	NONE for these robot types-- that is, there is no specific host that
	must be used for robotic control.

	Volume Group

	Identifies the volume group to which this volume belongs. A volume group
	defines the volume by location and consists of a logical group of 
	volumes that reside at the same physical location.

	Volume groups are an administrator convenience for moving multiple 
	volumes.  The use of a volume group allows you, in a single operation,
	to logically move a set of volumes between a robot and a standalone 
	location, or delete them from the volume configuration, by specifying
	the volume group name rather than the individual media IDs.

	Multiple groups can be defined on a single, removable component, such as
	a carousel or data cartridge holder.

	When you add one or more volumes, you are prompted to choose a volume 
	group name.  You can define one of your own, accept one generated by the
	utility, select one that already exists, or choose to have no group name
	associated with the volumes.

	A group name that is generated by the utility is formed using the robot 
	number and the designation of the device type, for example, 00_050_TS8 
	for a tape stacker with robot number 50.

	Slot

	Identifies which slot in the robot contains the volume.  When you add
	one or more volumes to any robotic library (other than ACS) you are
	prompted to enter a slot number.

	For standalone (nonrobotic) volumes, a hyphen character (-) appears in 
	this field.

	NOTE: The volume database does not contain slot information for media 
	      in an ACS, TLH, or TLM robot.  This information is tracked by the 
	      ACS Library Software (ACSLS), IBM Automated Tape Library (ATL)
	      software, or the Distributed AML Server (DAS) software.

	Side/Face

	Indicates the location of the volume and varies depending on the media 
	type.

	If the media type is an optical disk, this field contains either A or B,
	representing the platter side on which the volume is located.

	If the media type is an 8MM tape and the robot type is TL8, this field 
	contains the xy coordinates for the slot number.

	For any other media type, the field contains the hyphen character (-).

	Pool

	Identifies the volume pool to which this volume belongs.  The purpose of
	the volume pool is to define what the volume will be used for.  Volumes 
	in a pool are grouped together for use by a single application and are 
	protected from access by other applications and users.  A value of None 
	indicates the default pool for any user or application, but not for the
	NetBackup product.  A value of NetBackup indicates the default pool for 
	NetBackup and not for any other user or application.

	Pools other than None and NetBackup can be added with the Volume Pool
	menu item in the New submenu of the Actions menu.

	Created

	Displays the date and time the volume was added to the volume database.

	Time Assigned

	This field is relevant only to tapes assigned to NetBackup or another 
	application and shows the time at which the volume was assigned.

	Last Mount

	Displays the date and time the volume was last mounted through Media 
	Manager.

	Expiration Date

	The expiration date refers to the age of the media and is the time at 
	which the media is considered too old to be reliable.  If the expiration
	date is reached, Media Manager allows no further mounts in write mode. 
	Further mounts in read mode are allowed but a message is logged to the 
	console log indicating that the media expiration date has been reached. 
	A date of 0 indicates the volume has no expiration date.

	NOTE: Do not confuse this value with the expiration date for the data 
	      images that are on the media.  The expiration date in xvmadm 
	      refers only to the physical expiration of the media, independent
	      of the data.

	      The expiration date for data is separately managed by the 
	      application that is using Media Manager.  In the case of
	      NetBackup images, it is set during schedule configuration
	      as the retention level.

	# Mounts

	This field displays the number of times the volume has been mounted.

	Cleaning Count

	If the media type is a cleaning tape, this field displays
	the number of cleanings remaining on the tape. 

	Status

	The status field is relevant only to media that is assigned to an
	application.  The status is 0x1 for media assigned to NetBackup 
	database backups, 0x2 for media assigned to HSM, and 0x0 for all 
	other NetBackup media. There is also a date in the "Assigned" field 
	for assigned media (explained earlier).

	Max Mounts

	Number of times the volume may be mounted.  If maximum mounts is 
	reached, Media Manager allows no further mounts in write mode.  Further
	mounts in read mode are allowed.  A message is logged to the console 
	log when the maxmum number of mounts has been reached.

	First Mount

	Date and time the volume was first mounted through Media Manager.

	Partner

	If the media type is an optical disk, this field displays the media ID 
	of the volume on the other side of the optical platter.  For all other 
	media types, the field shows a hyphen character (-).  You define this 
	value as Partner ID when you add the volume.



Volume Pools List

	The Volume pools list is in the middle pane of the xvmadm main window 
	and shows the attributes of the volume pools that are currently 
	configured.  Pools can be added or changed by using commands from the 
	Actions menu. 

	The following are the column definitions for the Volume Pools list:

	Index

	A numeric index corresponding to the volume pool.

	Version

	Version number of the volume pool.

	Pool

	Name of the volume pool.

	Host

	The name of the server that is allowed to request and use volumes in the
	pool.  Setting it to ANYHOST allows any host to access the volume pool.


Volume Groups List

	The Volume Groups list is in the lower pane of the xvmadm main window 
	and shows the volume groups that are currently configured. The fields in
	this list are defined below. All the fields except Volume Count also 
	appear in the Volumes list.


	The following are the column definitions for the Volume Groups list:

	Volume Group

	Name of the volume group.

	Robot #

	Number of the robot that contains this volume group.

	Robot Type

	Type of robot containing the volume group.

	Robot Host

	Name of the host that controls this robot.  NONE is for no specific 
	host.

	Media Type

	Type of media in the volume group.

	Volume Count

	Number of volumes in the group.

                                                                                
