
			VMADM MAIN MENU
			
The main screen for the media management utility displays the volume 
database host and several administrative options.  The "Volume Database 
Host" is the host on which the database resides and the Media Manager
volume daemon (vmd) is running.  A description of the main menu administrative 
options follows.

NOTE:  for several of the volume management operations, the administrator
       can abort the operation by pressing the ESC key.

Add Volumes
-----------
  Using this menu selection, you may define either one or several new volumes,
  which can then be added through the volume daemon.  Also, you may choose to 
  auto-populate the volume configuration with the contents of an inventory-
  capable robot.  The first question you will be asked upon choosing the 
  "Add Volumes" menu selection is whether you want to add a single volume,
  a range of volumes, or use the auto-populate approach.

  If you select auto-populate, you will be prompted for a robot to use.  If 
  inventory-capable robots are already defined in the volume configuration, a 
  list of these robots will be presented.  If none are defined or if none are 
  selected, another list of robots will be presented, this time consisting of 
  robots in the device configuration.  Selection of a robot will lead to the 
  "Inventory and Update" submenu, where all media contained in the robot can 
  be added to the volume configuration.

  If you select the single or multiple volume add, you will next be asked a 
  series of questions about the volume(s).  The following is a brief description
  of the potential questions:

	Media Type 
	  -select the appropriate type from the menu

	Description
	  -describe (in 25 characters or less) the volume(s) being added.
	  -when adding a range of volumes, this description applies to
	   all volumes within the range.

	Volume Pool
	  -select the volume pool you wish the volume to be a part of, 
   	   choosing from the list of currently defined volume pools.  Two 
	   default volume pools will always exist, namely the "None" pool 
 	   and the "NetBackup" pool.
	  -media in the "None" pool can be used by any user or application,
 	   but will not be used by NetBackup.
	  -see the "Configure Volume Pools" submenu for more information on
	   Volume Pools.
	  -when adding a range of volumes, the Volume Pool applies to
	   all volumes within the range.

 	Physical Location
	  -this choice determines the robot type for this volume
	  -only needs to be specified for those media types that can
	   be used in some type of robot library system
	  -not applicable to 1/2" reel-to-reel tape or QIC - 1/4" cartridge 
	   tape.  For these media types, the Physical Location is always 
	   "Not in robotic device".	

	Robot Number
	  -only applicable if Physical Location is something other than
	   "Not in robotic device".	
	  -the robot numbers used should match the robot numbers specified
	   and configured in tpconfig
	  -the list of in-use robots of the desired robot type is presented.  
	   You may either choose a robot from the existing list, or 
	   choose to use a new robot (New Robot Number).

	Robot Host
	  -refers to the name of the host that is connected to the
	   robotic control, either via RS-232 or SCSI communications
	  -only applicable if Physical Location is something other than
	   "Not in robotic device" and you have chosen to use a new robot.

	Volume Group
	  -refers to a logical grouping of volumes.  It is provided as a
	   convenience for moving a set of volumes between a robot 
	   location and a standalone location.
	  -all volumes within a volume group must be in the same location.
	   If a volume group is contained in a robot, all volumes in 
	   the volume group must be in the same robot.

	Media ID
	  -enter 6 or less characters; all alphabetic characters will
	   automatically be converted to uppercase.  Any input less than
	   6 characters will be left justified and blank filled.
	  -for optical disk media types, you are asked for media IDs for both
	   side A and side B of the platter
	  -when adding multiple volumes, you will be prompted for the
	   naming mode (how many alpha and numeric characters), the number of
	   volumes, and the media ID for the first volume in the range of
	   volumes.

	Injecting Volume Using Mailslot
	  -applicable for single volume adds to ODL, TL8, TLD, and TSH robot 
	   libraries.
	  -performs both physical (into robot) and logical (into database) 
	   volume insert.
	  -the physical insertion into the mailslot must be synchronized 
	   with the prompts given by vmadm.

	tpformat-ing Volumes
	  -only applicable for adding volume(s) of optical media type
	  -this optional step may cause an operator mount request 
	   requiring manual assignment
	  -note that the tpformat request will be sent to the host on which
	   you are running vmadm.

  Special Rules
	-when adding a cleaning tape, you must enter the number of cleanings
	 available on the tape.
	-the first failure in a multiple volume add will cause the multiple
	 add operation to abort.  Any volumes that were added successfully
 	 prior to the failure will remain in the database.
	-adding 1/2" cartridge tape volumes with location ACS (Automated
	 Cartridge System), TLH (Tape Library Half-inch), or TLM (Tape
	 Library Multimedia) will not prompt you for physical slot locations,
	 since that information is tracked by the robot vendor's software.
	

Delete Volumes
--------------
  Volume deletion can be done on a single volume, multiple volumes, or a
  volume group (see description of volume group above).  All of the delete
  options only remove the volume(s) from the database, and do not perform any
  physical movement of the volume(s).  If your choice is a single volume 
  deletion, simply enter the media ID of the volume to delete.  Using the 
  multiple volume delete option, enter as many volumes as you wish, ending the 
  input by a blank response (carriage return) to the "Enter Media ID:" prompt.
  If the delete volume group option is chosen, enter the name of the volume 
  group you wish to delete and all members of that volume group will be deleted.
  This operation is not allowed on volumes which are currently "assigned"
  
  NOTE:  deleting an optical volume automatically deletes its partner volume.
	 (i.e.  deleting the side A volume of a platter, deletes the side B
	  volume of the platter)

Move Volumes
------------
  Moving volumes involves changing the residence of the volume in the
  volume database, and for the robot types that support it, also includes
  physically moving the volume.  The choices available for moving volumes
  are moving a single volume, multiple volumes, or an entire volume group
  (see description of volume group above).  

  NOTE:  moving an optical volume automatically moves its partner volume.
	 (i.e.  moving the side A volume of a platter, moves the side B
	  volume of the platter)

    Moving a single volume
	Enter the media ID of the volume to move.  The current volume
	residence will be displayed, and you will then be prompted for
	the new residence information. 

 	If the current or new residence is an ODL - Optical Disk Library, 
	a TL8 - Tape Library 8mm, a TLD - Tape Library DLT, or a TSH -
	Tape Stacker Half-inch, moving the volume may optionally involve 
	physically moving the volume through the use of the mailslot (or 
	inport/outport).  In fact, it is possible to move a volume from 
	one library to another using the "eject volume" capability of this
	option to physically remove the volume from the current library, 
	and the "inject volume" capability to physically insert the volume
	into the new library.

    Moving multiple volumes
	First enter the media ID for any volume in the group.  The current
	volume residence will be displayed, and you will then be prompted
	for new residence information.  After the information about the
	residence for the first volume has been entered, you may enter as
	many volumes as you wish, ending the input by a blank response
	(carraige return) to the "Enter Media ID:" prompt.  The current 
	residence for all subsequent volumes being moved must be the same 
	as the residence for first media id.  Depending on media type
	and destination, you may also have the option to change
	robot slots on a per volume basis with move multiple volumes.
	
    Moving a volume group
	Select the volume group from the list of volume groups presented.
	The current residence of the volume group will be displayed, and
	you will then be prompted for the new residence information.

	If the current residence is non-robotic, the new volume group
	residence for volumes in the volume group can be any robot for
	which the media type is valid.  If the current residence is
	robotic, the volume group can only be moved to non-robotic. If
	you want to move a volume group from one robot to another, you
	can first move it to non-robotic, then move it to the new robot.

      CAUTION:  When moving volume groups to a robot, all volumes will
		retain their previous values for robot slot.  Volumes
		in a volume group that were added with a residence outside 
		of a library cannot be moved to a robot with the Move 
		Volume Group operation, since they have no slot information.
		

Print Information about Volumes
-------------------------------
  This menu option is used to display information about volume(s).  The 
  information is available in various levels of detail and can be filtered 
  in numerous ways.

  Use the Help option in this submenu for more information on these topics.

Configure Volume Pools
----------------------
  This menu option is used to add, change, delete, and list volume pools,
  which can then be used to group volumes and restrict/allow access to volumes. 

  Use the Help option in this submenu for more information on these topics.

Special Actions
---------------
  Choosing this menu option presents a submenu with the following options
  for administrative action:

	Change Description for Volume
	Change Volume Pool for Volumes
	Change Expiration Date for Volumes
	Change Volume Group for Volumes
	Set Maximum Allowed Mounts for Volumes
	Modify Number of Cleanings on Cleaning Cartridge
	Initiate Media Manager Volume Daemon
	Terminate Media Manager Volume Daemon
	Update/Validate Barcode for Volumes
	Inventory a Robot and Report Contents
	Inventory a Robot and Compare with Volume Configuration
	Inventory a Robot and Update Volume Configuration
	Configure Barcode Rules

  Use the Help option in this submenu for more information on these topics.

Operator Interface
------------------
  Selecting this menu option invokes the operator interface.  Upon exiting
  from the operator interface, you are returned to the main menu of vmadm.

  Use the Help option in the operator utility for more information.

Device Configuration Utility
----------------------------
  Choosing this menu option invokes the device configuration utility.  Upon 
  exiting from the device configuration utility, you are returned to the 
  main menu of vmadm.

  Use the Help option in the device configuration utility for more information.
