MMLOCATE(8)                 Legato NetWorker 4.0                 MMLOCATE(8)


NAME
       mmlocate - NetWorker media location reporting command

SYNOPSIS
       mmlocate [ -d | -l ] [ -s server ] [ -n volname | -i volid ] [ loca­
       tion ]
       mmlocate -L [ -s server ]
       mmlocate -u [ -s server ] [ -f ] -n volname location
       mmlocate -u [ -s server ] [ -f ] -i volid location

DESCRIPTION
       The mmlocate command is used to access and manage the volume location
       information contained in the media database.  The information con­
       tained in the location record 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 ver­
       sions sub-command of recover(8)).  Any user is allowed to use this
       command with the -l (default) or -L options.  The -d and -u options
       are limited to the super-user.

       Running mmlocate without any arguments will list the entire location
       database for the specified server.  If no server is specified the
       current host is used.

       When a new volume is created using the nsrmm(8) command a default
       location is not created.  The mmlocate command must be used to create
       the location record.

OPTIONS
       -d     Delete those location records that match the supplied location
              and volume name (volname).  If either location or volname is
              not supplied, that field is ignored for the match.  If no
              fields are supplied, all records in the location portion of
              the database are deleted.  Only one location argument is
              accepted.

       -f     When used with the -u option, force the supplied location to
              be used.  If this option is not supplied with the -u option
              and the location supplied does not currently exist in the
              database, the user is prompted for permission to add this
              record.

       -i volid
              Restrict the operation to volid.

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

              The query lists those records that match volname or volid AND
              location.  If volname or volid and/or location is not supplied
              all cases of the missing argument will match.

       -L     List all locations found in the database.




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

MMLOCATE(8)                 Legato NetWorker 4.0                 MMLOCATE(8)


       -n volname
              Restrict the operation to volname.

       -s server
              Use server's media database.

       -u     Update or add a location record to the database.  A -n volname
              or -i volid and a location must be supplied.

              If the volume volname does not exist, no location record will
              be added.

              If a record for the volname or volid already exists the loca­
              tion field will be changed to location.  If no record exists,
              one will be added.  See also -f above.  Print debugging and
              progress information.

EXAMPLES
       Update (or add) a record showing volume 11.Incr.A now at location
       'Vault'
              mmlocate -u -n 11.Incr.A Vault

       Delete location information for all volumes at location 'Tape
       Library'
              mmlocate -d 'Tape Library'

       Delete location information for volume 11.Incr.A
              mmlocate -d -n 11.Incr.A

       List the location of volume 11.Incr.A
              mmlocate -n 11.Incr.A

       List all volumes stored in the location 'Tape Library'
              mmlocate 'Tape Library'

FILES
       /nsr/mm/mmvolume         The media database.

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

















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