MMLOCATE(8)                Legato NetWorker 4.1.1                MMLOCATE(8)


NAME
       mmlocate - NetWorker media location reporting command

SYNOPSIS
       mmlocate [ -s server ] -l [ -n volname | -i volid | location ]
       mmlocate [ -s server ] -d location
       mmlocate [ -s server ] -c { -n volname | -i volid } location
       mmlocate [ -s server ] -L
       mmlocate [ -s server ] -u { -n volname | -i volid } location

DESCRIPTION
       The mmlocate command is used to access and manage the volume location
       information contained in the media database.  The information
       contained in a volume's location field is meant to give the user an
       idea of where the volume can physically be found.  Other NetWorker
       commands will display the location along with the volume name (see
       the versions sub-command of recover(8)).  Any user is allowed to use
       this command with the -l (default) or -L options.  The -d, -c, and -u
       options are limited to NetWorker administrators (see nsr(5)).

       Running mmlocate without any arguments will list all volumes and
       their locations for the specified server (if no server is specified
       the current host is used).

       Note that each time nsrjb(8) moves a piece of media inside a jukebox,
       the location of a volume is set to the name of the jukebox.

OPTIONS
       -c location
              Clear location field for specified volume.  If no volume is
              specified by volname or volid, then all volumes matching the
              given location will have their location field cleared.

       -d location
              Delete all volumes having the given location.  The user will
              be prompted for deletion of each volume.

       -i volid
              Restrict the operation to volid.

       -l     List entries (default).  A database query is performed using
              the supplied volname or volid or location.

              If a volume name or volume id is given, then only that
              volume's location information is displayed.  If a location is
              provided, then only volumes in that location are displayed.
              When the -l argument is supplied with no other options (volume
              name, volume id, or location), volumes with no location set
              are displayed.

       -L     List all locations found in the database.

       -n volname
              Restrict the operation to volname.



Licensed material--property of copyright holder(s)                         1





MMLOCATE(8)                Legato NetWorker 4.1.1                MMLOCATE(8)


       -s server
              Use server's media database.

       -u     Update the location for a volume.  Locations are limited to a
              maximum length of 64 characters.  A -n volname or -i volid and
              a location must be supplied.

EXAMPLES
       Update (or add) a record showing volume Offsite.011 now at location
       'Media Vault'
              mmlocate -u -n Offsite.011 'Media Vault'

       Delete volumes at location 'Media Shelf 6'
              mmlocate -d 'Media Shelf 6'

       Delete location information for volume NonFull.001
              mmlocate -c -n NonFull.001

       List the location of volume NonFull.001
              mmlocate -n Full.001

       List all volumes stored in the location 'Media Vault'
              mmlocate 'Media Vault'

FILES
       /nsr/mm/mmvolume         The media database.

SEE ALSO
       nsrmm(8), mminfo(8), nsr(8), nsrjb(8), recover(8)

DIAGNOSTICS
       Server does not support remote update operations....
              If you are running mmlocate against an old server, you are not
              allowed to use the -u or -c options.  You must login to that
              server and run the mmlocate program there.






















Licensed material--property of copyright holder(s)                         2