mmlocate

The mmlocate program accesses and manages the volume location information contained in the media database. Any user can use this command with the -l (default) or -L options. The -c, -d and -u options are limited to Backup administrators. Running mmlocate without any arguments lists all volumes and their locations for the specified server. (If you do not specify a server, the current host is used.)

If you use the nsrjb command to move a volume inside a jukebox, the location of a volume is set to the name of the jukebox.

The following example describes the format and options available for the mmlocate program:

mmlocate [-s server] [-l] [-n volume-name | -i volumeID | location]
mmlocate [-s server] -L
mmlocate [-s server] -d location
mmlocate [-s server] -c {-n volume-name | -i volumeID}
mmlocate [-s server] -u

{-n volume-name | -i volumeID} location

• Use the -a option to apply the query to all complete, browsable save sets, not just those in the last 24 hours. This option is implied by the -c, -N, -q, -m, and -o options. When combined with a media-only report (-m or a custom report showing only media information), the -a option applies to all volumes, not just those with complete and browsable save sets.

• Use the -c option to clear the location field for the specified volume.

• Use the -d location option to delete all volumes that show the given location. You receive a confirmation prompt prior to the deletion of each volume.

• Use the -i volid option to restrict the mmlocate operation to the specified volume ID.

• Use the -l query option to perform a database query using the supplied volume name, volume ID, or location. If you list the -l option without specific query requests, volumes without a set location are displayed.

• Use the -L option to list all locations found in the database.

• Use the -n volname option to restrict the operation to the volume name listed.

• Use the -s server option to access the server's media database.

• Use the -u option to update the location for a volume. Locations are limited to a maximum length of 64 characters. You must also specify the -n volname or -i volid options and specify a location.