MMLOCATE(8)                 Legato NetWorker 3.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
       mmlocate is used to access and manage the volume location information
       contained in the media database.  The information contained in the
       location record is meant to give the user an idea of where the volume
       can be found, and 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 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 mm(8) command a default loca­
       tion is not created.  mmlocate 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 3.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 'Tape Library'
              mmlocate 'Tape Library'

FILES
       /nsr/mm/mmvolume         The media database.

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

















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