mminfo

The mminfo program reports information about Backup media and save sets. The default mminfo report displays information about the save sets that completed properly during the last twenty four hours. This report includes; the volume name, client name, creation date, amount of data saved to the volume, level of backup performed and the name of the save set.

See "Examples of mminfo Report Commands" for a list of examples of how to use the mminfo command.

The following example describes the format and options available for the mminfo command:

mminfo [-avV] [-o order] [-s server] [report] [query] [volname...]
<report>: [-m | -B | -S | -X | -r reportspecification]
<query>: [-c client] [-N name] [-t time] [-q query specification]

• 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 -B option to produce a list of the bootstraps generated in the previous five weeks. The bootstrap report format is used, with one line of output printed for each matched save set. Each line shows the save date and time, save level, ssid, starting file number, starting record number, and volume.

• Use the -c client option to restrict the report information to the media and save sets that pertain to the specified client.

• Use the -m option to display a media-only report. This report displays information about each volume contained within the specified Backup server's media database.

  Use the -v option concurrently with the -m option to display; the internal volume identifier (volid), the number of the next file to be written and the media type.

  Use the -V option concurrently with the -m option to display volume characteristics where:

  • The d flag, indicates that the volume is currently being written to.

  • The r flag, indicates that the volume is marked as read-only.

• Use the -N saveset-name option to restrict the reported information to the media and save sets pertaining to the specified save set name.

• Use the -o order option to sort the output in a specified order. order may be any combination of the letters celmontR, where:

  • c, client

  • e, expiration date of the volume

  • l, length or percentage of space used on the volume

  • m, media

  • n, saveset name

  • o, filename and record number

  • R, reverse

  • t, the last time the media was accessed

    The default sorting order for a saveset report is mocntl.

• Use the -q queryspecification option to add the given query constraint to the list of constraints on the current query. Multiple -q options may be specified, and combined with the shorthand query constraints -c, -N and -t. The syntax of the queryspecification is:

  [!] name [comp value] [ , ... ]

name, is the name of a database attribute, such as "name="hot"name="hot"" Save Set" comp, is a valid comparator for the attribute, from the set ">", ">=","=" value, is the value being compared.

The comparator and value must be specified for all attributes, except flags. If a string contains commas, quote the value using single or double quotes. The following is a valid string comparison:

name="Daily, ""hot"" Save Set"

Except for multiple character string values, all of the specified constraints must match a given save set and/or media volume. Numeric constraints can be specified by a, and all character string constraints can be specified by multiple possible values. For example:

%used>20,%used<80
client=mars,client=saturn 

Refer to the CUSTOM QUERIES AND REPORTS section in the mminfo(1m) man page for further information on the syntax to use for the query specification.

• Use the -r reportspecification option to specify how a report is displayed. Specify the media and save set attributes to be displayed, order of the columns, column widths, and line breaks. The syntax of a reportspecification is:

  name [(width)] [, name [(width)]...]

  name, is the name of a database attribute

  width, specifies how wide the column should be

• Use the -s server option to display volume and save set information from the specified Backup server. The default value for server is the current system.

• Use the -t time option to restrict the reported information to the media and/or save sets pertaining to the save sets created on or after time. Refer to the nsr_getdate(3) man page for a description of the recognized time formats. The default value for time is "yesterday."

• Use the -v option to enable verbose display reports that include:

  • aborted completed purged and incomplete save sets

  • creation time

  • internal save set identifier (ssid),

  • An indicator of which portion of a save set resides on a volume.

    c, the entire saveset is contained on this volume.

    h, the head of the saveset is contained on this volume.

    m, a middle section of the saveset is contained on this volume.

    t, a tail section of a spanning save set is contained on this volume.

  • status of a save set, as indicated by:

    b, the save set is browsable with the recover command.

    r, the save set is recoverable with the scanner command.

    E, the save set has been marked eligible for recycling and may be over-written at any time.

    S, the save set was scanned, or rolled in. Rolled in save sets are not subject to the standard index management procedures and will remain in the file index until the user manually purges the save set.

    a, the save was aborted before completion. Aborted save sets are removed from the on-line file index by nsrck.

    i, the save is still in progress.

• Use the -S option to display a long, multi-line save set report for debugging. Each attribute of a save set is displayed in one of the following formats:

  name=value client:name

The first line of each multi-line group starts on the left margin and includes the save set identifier (ssid), save time, client and save set names. Subsequent lines for this save set are indented. The next line displays the level, the save set flags, the save set size, the number of files within the save set, and the save set expiration date. Extended attributes, clones and instances of the save set are displayed on the lines that follow.

• Use the -V option to display a more verbose report than that obtained through the use of the -v option.

  The first line includes:

  • the size of each portion of a save set contained on this volume.

  • the creation date and time

    The second line contains the following information:

  • the save time in seconds since 00:00:00 GMT, Jan 1, 1970

  • the internal save set identifier (ssid)

  • the offset of the first and last bytes of the save set contained within section

  • the media file number

  • the first record within the media file containing data for this save set

  • the internal volume identifier (volid)

  • the total size of the save set

  • the flag, indicating which part of the save set is contained in this media file (c, h, m, or t)

  • save set's status (b, r, a, or i).

• Use the -X option to prepare a save set summary report. This summary report breaks the save sets down into several overlapping categories:

  • the number of each level backup by type, performed on a save set.

  • the number of archived, migrated, empty and purged save sets.

  • the number of index save sets.

  • the number of incomplete save sets.

    For recent usage, weekly and monthly summaries displayed, including the following information:

  • the number of files saved in the time interval specified

  • the number of save sets

  • the total size, and average size per save set

  • the average size per file

  • the percentage of the amount saved for incrementals v.s. fulls

Examples of mminfo Report Commands

The following examples provide a guideline for you to follow when you create your own customized queries. Shortened syntax, wherever acceptable, is shown.

To display all the information about all the volumes managed by the server:

mminfo -m

To display media information from volumes that are labeled mars.001 and mars.002:

mminfo -m mars.001 mars.002

To display all save sets found in the file indexes named /usr:

mminfo -N /usr

To display save sets named /usr, generated by a client named venus, backed up in the past week:

mminfo -N /usr -c venus

To display save sets named /usr, generated by a client named venus, on a volume that is labeled mars.001:

mminfo -N /usr -c venus mars.001

To display a media report of all volumes written on in the past week:

mminfo -m -t `last week'

To display a media report of all non-full volumes, showing the percent used, pool name, and location of each volume:

mminfo -a -r `volume,%used,pool,location' -q `!full'

To display a media report similar to the -m report that shows the barcode instead of the volume label:

mminfo -a -r \ `state,barcode,written,%used,read,space,volexp' \
-r`mounts(5),space(2),capacity'

To display a verbose list of the instances of all save sets with more than one copy, sorted by save time and client name:

mminfo -otc -v -q `copies>1' 

To display all archive save sets with an annotation of "my project" for the past four months:

mminfo -q'annotation=my project' \
-r"volume,client,savetime,sumsize,ssid,name,annotation" \ -t'four
months ago'