


MMINFO(8)                                               MMINFO(8)


NNAAMMEE
       mminfo - NetWorker media database reporting command

SSYYNNOOPPSSIISS
       mmmmiinnffoo [ --aavvVV ] [ --oo _o_r_d_e_r ] [ --ss _s_e_r_v_e_r ] [ rreeppoorrtt ] [
              qquueerryy ] [ _v_o_l_n_a_m_e_._._.  ]

              < rreeppoorrtt >: [ --mm | --BB | --SS | --XX | --rr _r_e_p_o_r_t_s_p_e_c ]
              < qquueerryy >: [ --cc _c_l_i_e_n_t ] [ --NN _n_a_m_e ] [ --tt _t_i_m_e ] [
              --qq _q_u_e_r_y_s_p_e_c ]

DDEESSCCRRIIPPTTIIOONN
       The  mmmmiinnffoo  command reports information about NetWorker's
       media and save sets.  The mmmmiinnffoo command can produce  sev-
       eral  different  reports depending on the flags specified.
       Several built-in reports can be specified using short-hand
       flags.  Custom reports can also be specified.  The default
       report, along with the built-in reports printed by the use
       of  the  --vv,  --VV,  --mm, --SS, --BB, and --XX flags, are described
       first below.  The  custom  query  and  report  generators,
       using  the  --qq  _q_u_e_r_y_s_p_e_c  and  --rr _r_e_p_o_r_t_s_p_e_c options, are
       described in  the  CCUUSSTTOOMM  QQUUEERRIIEESS  AANNDD  RREEPPOORRTTSS  section.
       Other options are described in the OOPPTTIIOONNSS section.

       Without any options, mmmmiinnffoo displays information about the
       save sets that completed properly during the  last  twenty
       four  hours,  and  are  still contained in an on-line file
       index (browsable save sets).  The following information is
       printed for each save set: the containing volume name, the
       client's name, the creation date, the size saved  on  that
       volume,  the  save  set level, and the save set name.  The
       size field is displayed  in  Bytes  (B),  KiloBytes  (KB),
       MegaBytes (MB) or TeraBytes (TB).  The save set level will
       display `full', `incr', `migration' or 1  through  9,  for
       full, incremental, migration save sets, level 1 through 9,
       respectively.  The level is only kept for scheduled  saves
       and file migration; save sets generated by explicitly run-
       ning the ssaavvee(8) command (called _a_d _h_o_c saves) do not have
       an associated level.

       Specifying  the  --vv flag causes three additional fields to
       be displayed: the creation time,  the  internal  save  set
       identifier  (ssid),  and two flags.  One character is used
       per flag.

       The first flag indicates which part of the save set is  on
       the  volume.  When the save is ccompletely contained on the
       volume, a cc is displayed.  An hh is displayed when the save
       set  spans  volumes and the hhead is contained on this vol-
       ume.  The remaining sections will be on other volumes.  An
       mm  is displayed when the save set spans volumes and a mmid-
       dle section is contained on this  volume.   The  head  and
       tail  sections will be on different volumes.  There may be
       more than one middle section.  A tt is displayed  when  the



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





MMINFO(8)                                               MMINFO(8)


       ttail  section  of a spanning save set is contained on this
       volume.  Again, the other sections will be on  other  vol-
       umes.

       The second flag indicates the status of the save set.  A bb
       indicates that the save set is in the on-line index and is
       bbrowsable via the rreeccoovveerr(8) command.  An rr indicates that
       the save set is not in the on-line index and  is  rrecover-
       able  via the ssccaannnneerr(8) command.  An EE indicates that the
       save set has been marked eligible for recycling and may be
       over-written  at any time.  An SS denotes that the save set
       was scanned in (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.   An aa indicates that the save was
       aborted before completion.  Aborted save sets are  removed
       from  the  on-line file index by nnssrrcckk(8).  An ii indicates
       that the save is still in progress.  The  --vv  flag  prints
       aborted,  purged,  and incomplete save sets in addition to
       the complete, browsable save sets printed by default.

       The --VV flag displays even more detail than  the  --vv  flag,
       and  is  generally  used  for debugging.  This format also
       displays information (i.e. media file  number  and  record
       number)  that  can  be  used to speed the operation of the
       ssccaannnneerr(8) command.  Rather than displaying one  line  per
       save  set  per volume, two lines are displayed each time a
       section of a save set occurs within a file on a volume.  A
       single  save  set  will  have multiple index entries if it
       starts in one file on a volume and ends in  another.   The
       first  line  will  contain  the  fields  similar  to those
       described for the default output, above, with two  differ-
       ences.   First, the size field will now list the number of
       bytes that are contained in the section, rather  than  the
       total amount of the save set on this volume.  Second, both
       the creation date and the time are shown.  The second line
       contains  the  following  fields: 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, and the flags,
       described in the --vv paragraph above, indicating which part
       of  the save set is contained in this media file (cc, hh, mm,
       or tt) and the save set's status (bb, rr, aa, or ii).

       The --mm flag causes mmmmiinnffoo to display the name of each vol-
       ume  in the media database, the number of bytes written to
       it, the percent of space used (or the word `full' indicat-
       ing  that the volume is filled to capacity), the number of
       bytes read, the expiration date, the number of  times  the
       volume  has been mounted, and the volume's capacity.  Vol-
       umes that are recyclable (see nnssrriimm(8)) are flagged by  an



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





MMINFO(8)                                               MMINFO(8)


       EE  in the 1st column (meaning EEligible for recycling).  If
       a volume has been marked as manually-recyclable, an  MM  is
       displayed instead of the EE.  If a volume is both manually-
       recyclable and eligible for recycling, an XX will  be  dis-
       played.   Archive  and migration volumes are flagged by an
       AA, also in the 1st  column.   If  the  volume  is  not  an
       archive  or  migration  volume,  and is not recyclable, no
       flag appears.

       Specifying the --vv flag with the --mm flag causes three addi-
       tional fields to be displayed: the internal volume identi-
       fier (volid), the number of the next file to  be  written,
       and the type of media.

       Using  a --VV flag with the --mm adds a column of flags to the
       output.  There are currently two possible  flags.   The  dd
       flag  is  set  if  the  volume  is currently being written
       (ddirty).  The rr flag is set if the  volume  is  marked  as
       rread-only.   If  neither  condition  is present, the flags
       column will be empty.

       The --SS flag displays a long, multi-line save  set  report,
       which  is  used for debugging.  The number of lines varies
       per save set.  Due to the  length,  there  are  no  column
       headers.   Instead, each attribute of the save set is dis-
       played in a `name=value' manner,  except  the  client  and
       save  set name, which are displayed as `client:name'.  The
       first line of each multi-line group  starts  on  the  left
       margin  and  includes the save set identifier (ssid), save
       time as both a date/time string and seconds since 00:00:00
       GMT, Jan 1, 1970, and the client and save set names.  Sub-
       sequent lines for this save set are indented.  If the save
       set  is part of a save set series (a `continued save set')
       and is not the first in the series, the save  set  identi-
       fier  of  the  previous save set in the series in shown on
       the second line by itself.  The  next  line  displays  the
       level,  the  save  set  flags  (in  `ssflags'  format,  as
       described in the table in the CCUUSSTTOOMM QQUUEERRIIEESS  AANNDD  RREEPPOORRTTSS
       section),  the save set size in bytes, the number of files
       in the save set, and the save set expiration date (`undef'
       means  the  expiration  date  is determined by the current
       policies for the client).  If the save  set  has  extended
       attributes,  they  are printed next, at most one attribute
       per line.  The clones or instances of  the  save  set  are
       shown  last  (every  save set has at least once instance).
       The first line of each clone shows the  clone  identifier,
       the  date  and time the instance was created, and the per-
       clone flags (in `clflags' format from the  CCUUSSTTOOMM  QQUUEERRIIEESS
       AANNDD  RREEPPOORRTTSS  table).   For each instance, each section of
       that instance is shows as a fragment line.   The  fragment
       line  shows the offset of that fragment from the beginning
       of the save set, the volume identifier (volid)  containing
       the  fragment,  the media file and record numbers of start
       of  the  fragment,  an  absolute  positioning   identifier



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3





MMINFO(8)                                               MMINFO(8)


       (unused  by existing servers), and the date of last access
       of the fragment.  The --vv and --VV options have no effect  on
       this report.

       The  --XX flag prepares a save set summary report instead of
       one or more lines per save  set.   Note  that  the  entire
       media  database  must  be  examined to resolve this query,
       making it very slow and expensive.  The summary lists  the
       total  number of save sets, and breaks the total down into
       several overlapping categories summarizing  the  save  set
       types.   The  recent save set usage, if appropriate to the
       query, is also printed.  The categories are the number  of
       fulls,  the  number  of  incrementals, The number of other
       non-full, non-incremental saves, the  number  of  ad  hoc,
       archive, migration, empty and purged save sets, the number
       of index save sets, and finally, the number of  incomplete
       save  sets.  For recent usage, the number of save sets per
       day are shown, up to a week ago, along with a  summary  of
       the  week's save sets and, if applicable, a summary of the
       month's save sets.  For each line,  the  number  of  files
       (saved  in  the  time  interval specified), number of save
       sets, total size, and average size per save set, and aver-
       age  size  per  file,  are  listed.  The percentage of the
       amount saved for incrementals v.s. fulls and the  percent-
       age of browsable files are also printed, when appropriate.
       The --vv and --VV  options  have  no  effect  on  the  summary
       report.

       The --BB flag performs a canned query to output, in a conve-
       nient format, the list of bootstraps generated in the pre-
       vious  five  weeks.   In this format, there is one line of
       output for each matched save set.  Each line contains  the
       save  date  and  time,  save  level,  save  set identifier
       (ssid), starting file number, starting record number,  and
       the  volume.   The  equivalent query is described below in
       the EEXXAAMMPPLLEESS section.  The  --vv  and  --VV  options  have  no
       effect on the bootstrap display.

OOPPTTIIOONNSS
       --aa     Causes  queries to apply to all complete, browsable
              save sets, not just those in  the  last  24  hours.
              This  option  is implied by the --cc, --NN, --qq, --mm, and
              --oo options, described below.  When combined with  a
              media-only  report  (--mm  or a custom report showing
              only media information), --aa applies to all volumes,
              not  just  those  with  complete and browsable save
              sets.

       --cc _c_l_i_e_n_t
              Restricts the reported  information  to  the  media
              and/or   save  sets  pertaining  to  the  specified
              _c_l_i_e_n_t.

       --mm     Display a media report instead of the default  save



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        4





MMINFO(8)                                               MMINFO(8)


              set  report  (in  other  words,  a report about the
              media containing save sets, not the save sets them-
              selves).

       --NN _n_a_m_e
              Restricts  the  reported  information  to the media
              and/or save sets pertaining to the  specified  save
              set _n_a_m_e.

       --oo _o_r_d_e_r
              Sort  the  output  in  the specified order.  Before
              displaying the save sets, they are sorted by  vari-
              ous  fields.   Numeric  fields  are sorted least to
              greatest, other fields are  sorted  alphabetically.
              _o_r_d_e_r  may  be  any combination of the letters cceell--
              mmoonnttRR,  representing   cclient,   eexpiration   date,
              llength,  mmedia  name,  nname  of save set, ooffset on
              media (file and record number), ttime, and  RReverse,
              respectively.   The  default sorting order for save
              set reports is mmooccnnttll.  The offset fields (file and
              record)  are only considered when the --VV option has
              been selected and for custom reports that show save
              set  section  (fragment) information.  When applied
              to --mm media-only reports, the length is the  amount
              used  on the volume, the expiration date applies to
              the volume, the time is the last time the media was
              accessed, and the other order flags are ignored.

       --qq _q_u_e_r_y_s_p_e_c
              Adds the given query constraint to the list of con-
              straints on the current query.  Multiple --qq options
              may  be  given.  See the CCUUSSTTOOMM QQUUEERRIIEESS AANNDD RREEPPOORRTTSS
              section below for the syntax of the _q_u_e_r_y_s_p_e_c_.

       --rr _r_e_p_o_r_t_s_p_e_c
              Appends the given report specification to the  list
              of  attributes  to  be  displayed  for  the current
              query.  Multiple --rr options may be given.  See  the
              CCUUSSTTOOMM  QQUUEERRIIEESS  AANNDD  RREEPPOORRTTSS section below for the
              syntax of the _r_e_p_o_r_t_s_p_e_c_.

       --ss _s_e_r_v_e_r
              Display volume and save set  information  from  the
              NetWorker  system  on  _s_e_r_v_e_r.   See  nnssrr(8)  for a
              description of server selection.   The  default  is
              the current system.

       --tt _t_i_m_e
              Restricts  the  reported  information  to the media
              and/or save sets pertaining to the save  sets  cre-
              ated  on  or  after _t_i_m_e.  See nnssrr__ggeettddaattee(3) for a
              description of the recognized  time  formats.   The
              default is `yesterday'.




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        5





MMINFO(8)                                               MMINFO(8)


       --vv     Turn  on  the  verbose  display  reports, described
              above.

       --BB     Run the canned query  to  report  bootstraps  which
              have  been  generated  in  the  past five weeks, as
              described above.  This option is used by ssaavveeggrrpp(8)
              when saving the server's index and bootstrap.

       --SS     Displays  a  long,  multi-line  save set report, as
              described above.

       --VV     Displays  additional  verbose  report  output,   as
              described above.

       --XX     Prepare a summary report, as described above.

CCUUSSTTOOMM QQUUEERRIIEESS AANNDD RREEPPOORRTTSS
       The custom query and report options of mmmmiinnffoo allow one to
       generate media and save set reports matching complex  con-
       straints without resorting to pipelines and scripts.  This
       section describes the syntax of custom  query  and  report
       specifications,  and  gives some simple examples.  Further
       examples are shown in the EEXXAAMMPPLLEESS section, below.

       The custom query option, --qq _q_u_e_r_y_s_p_e_c, is an extension  to
       the  short-hand  query  options,  such as --cc _c_l_i_e_n_t, which
       allow you to make queries based on  almost  any  media  or
       save set attribute in the database, and allow various com-
       parisons in addition to  the  simple  equality  comparison
       provided  by  the  short-hand  options.   The  format of a
       _q_u_e_r_y_s_p_e_c is

            [!]  _n_a_m_e [ _c_o_m_p _v_a_l_u_e ] [ , ... ]

       where _n_a_m_e is the name of a database attribute, listed  in
       the  table  below,  _c_o_m_p  is  a  valid  comparator for the
       attribute, from the set `>', `>=',  `=',  '<=',  '<',  and
       _v_a_l_u_e  is  the value being compared.  Leading and trailing
       spaces can be used to separate the  individual  components
       of  the  specification.   The comparator and value must be
       specified for all but flag attributes.  Generally  numeric
       attributes  allow  all  five  comparators,  and  character
       string attributes generally  only  allow  equality.   When
       comparing  flags,  whose  values  are  normally `true' and
       `false', one may alternatively use the `[ ! ]  _n_a_m_e'  syn-
       tax.   The `_!_n_a_m_e' form is equivalent to `_n_a_m_e_=_f_a_l_s_e', and
       `_n_a_m_e' by itself is equivalent to `_n_a_m_e_=_t_r_u_e'.   The  com-
       parisons in the specification are separated by commas.  If
       a time or a string contains commas,  you  must  quote  the
       value  with  single  or double quotes.  Quotes are escaped
       within a string by repeating them.   The  following  is  a
       valid string comparison:

            name="Joe's daily, ""hot"" Save Set"



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        6





MMINFO(8)                                               MMINFO(8)


       Note  that  command  line shells also interpret quotes, so
       you will need to enclose the entire query  within  quotes,
       and quote the single value inside the query, possibly with
       a different kind of quote, depending on the shell.  Except
       for multiple character string values, explained below, all
       of the specified constraints must match a given  save  set
       and/or  media  volume before a line will be printed in the
       report.  Multiple --qq options may be specified, and may  be
       combined  with the short-hand query constraints --cc, --NN and
       --tt.  The order of the above query constraints is  unimpor-
       tant.

       Numeric  constraints, except for identifiers (volume, save
       set and clone identifiers) allow ranges to  be  specified,
       and all character string constraints allow multiple possi-
       ble values to be specified.  Note that  times  and  levels
       are   considered  to  be  numeric  values,  not  character
       strings.  The upper and lower bounds of  a  numeric  range
       are specified as two separate constraints.  For example,

            %used>20,%used<80

       matches  volumes  that are between 20% and 80% used.  Each
       possible value of a given character  string  attribute  is
       specified as a separate equality constraint.  For example,

            client=pegasus,client=avalon

       matches save sets from the client `pegasus' or the  client
       `avalon'.

       The  custom  report  option,  --rr _r_e_p_o_r_t_s_p_e_c, allows one to
       specify exactly which media and save set attributes should
       be shown in the report, the order of the columns, the col-
       umn widths, and where line breaks should be  placed.   The
       format of a _r_e_p_o_r_t_s_p_e_c is

            _n_a_m_e [ (_w_i_d_t_h) ] [ , _n_a_m_e [ (_w_i_d_t_h) ] ... ]

       where  _n_a_m_e  is  the  name of a database attribute, listed
       below, and the optional _w_i_d_t_h,  enclosed  in  parentheses,
       specifies  how  wide  the  column  should be.  Leading and
       trailing spaces are ignored.   The  default  column  width
       depends on the attribute; default widths are also shown in
       the table, below.  Multiple --rr options may  be  specified.
       The  order  of  the  columns in the report will be left to
       right, and correspond to the order of the attribute  names
       specified.   Each  line  of output will contain all of the
       data requested (you can cause line breaks within a logical
       line  by  using  the  _n_e_w_l_i_n_e attribute name).  If a value
       does not fit in the  requested  column  width,  subsequent
       values  in  the  line will be shifted to the right (values
       are truncated at 256 characters).




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        7





MMINFO(8)                                               MMINFO(8)


       The table below lists  all  of  the  recognized  attribute
       names,  their  valid  range  of  query values (or `NA' for
       attributes that are only valid for report specifications),
       their default column width in characters (or `NA' for flag
       attributes that are only valid for query  specifications),
       and  a  short  description.   Numeric attributes (shown as
       _n_u_m_b_e_r in the valid range column  of  the  table)  can  be
       specified  using  any of the comparators listed above, and
       can be used in range comparisons.  The _=_n_u_m_b_e_r  attributes
       have  the  same characteristics as _n_u_m_b_e_r attributes, with
       the exception that only numeric equality  comparisons  are
       allowed.   _F_l_a_g  attributes  have  the  values  `true'  or
       `false', only apply as query constraints, and have  corre-
       sponding  flag  summary strings for report specifications.
       _T_i_m_e attributes are specified in nnssrr__ggeettddaattee(3) format and
       are otherwise treated as numeric attributes (note that you
       will need to quote times that contain commas).   The  spe-
       cial  time  `forever',  when  used  as an expiration date,
       means a save set or volume will never expire.  The special
       time  `undef'  is  displayed  when  the time is undefined.
       Undefined expiration dates mean a  save  set  will  expire
       depending on its client's retention and browsability poli-
       cies.   When  output,  times  are  displayed  as  _M_M_/_D_D_/_Y_Y
       _H_H_:_M_M_:_S_S  for  numeric  month, day year (last two digits),
       hours, minutes, and seconds, respectively.  If the  column
       is very narrow (less that 14 characters), only the date is
       shown, columns less than 17 characters wide drop the  sec-
       onds,  columns  17  or more characters wide print the full
       date.  _S_i_z_e and _k_b_s_i_z_e attributes may have a scale  factor
       appended  to them, `KB' for kilobytes, `MB' for MegaBytes,
       `GB' for GigaBytes and `TB' for  TeraBytes.   The  default
       scale  (when  no  scale  is explicitly specified) on query
       constraints for  attributes  is  bytes;  the  default  for
       _k_b_s_i_z_e  attributes  is  kilobytes.   The  scale  varies in
       reports, depending on the actual value.  _S_t_r_i_n_g attributes
       may  be any arbitrary character string, enclosed in quotes
       if necessary, as described above in the query syntax para-
       graph.


        aattttrriibbuuttee     vvaalluuee   wwiiddtthh                ddeessccrriippttiioonn
          nnaammee        rraannggee
       space       NA           1  White space before the next column.
       newline     NA           1  Line break(s) within a logical line.
                                   _W_i_d_t_h is actually the number of
                                   newlines desired.
       volume      string      15  The volume name.
       volid       =number     11  The unique volume identifier.
       barcode     string      15  The volume barcode, when set.
       family      string       4  The media family (eg. tape, disk).
       type        string       7  The media type (eg. 8mm, optical).
       volflags    NA           5  Volume summary flags, dd and rr,
                                   for dirty (in use) and read-only.




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        8





MMINFO(8)                                               MMINFO(8)


       state       NA           3  Volume state summary, EE, MM, XX and AA,
                                   meaning eligible for recycling,
                                   manually-recyclable, both, and
                                   archive or migration volumes, respectively.
       full        flag        NA  Matches full volumes.
       inuse       flag        NA  Matches in-use (dirty) volumes.
       volrecycle  flag        NA  Matches recycleable volumes.
       readonly    flag        NA  Matches read-only volumes.
       manual      flag        NA  Matches manually-recyclable volumes.
       pool        string      15  The pool containing the volume.
       location    string      15  The volume's location.
       capacity    size         8  The volume's estimated capacity.
       written     kbsize       7  Kbytes written to volume.
       %used       number       5  Estimated percentage used, or `full'
                   or `full'       for volumes marked as full.
       read        kbsize       8  Kbytes read (recovered) from the volume.
       next        number       5  Next media file for writing.
       nrec        number       5  Next media record for writing.
       volaccess   time         9  Last time volume was accessed
                                   (written to or labeled).  Old servers
                                   do not provide this value reliably.
       volexp      time         9  Volume expiration date.
       olabel      time         9  The first time the volume was labeled.
       labeled     time         9  The most recent time the media
                                   volume was (re)labeled.
       mounts      number       6  Number of times the volume was mounted
                                   explicitly (reboots do not count).
       recycled    number       4  Number of times the volume
                                   was relabeled.
       avail       NA           3  Summary of volume availability, current
                                   valid values, nn meaning nearline
                                   (ie. in a jukebox), and oovv meaning
                                   the volume is being managed by SmartMedia.
       near        flag        NA  Matches nearline volumes.
       openvault   flag        NA  Matches volumes managed by SmartMedia.
       metric      number       6  Volume speed and desirability metric
                                   (unused by existing servers).
       savesets    NA           6  Number of save sets on a volume.

       name        string      31  The save set name.
       savetime    time         9  The save time.
       nsavetime   NA          11  The save time, printed as seconds
                                   since 00:00:00 GMT, Jan 1, 1970.
       ssid        =number     11  The unique save set identifier.
       level       0..9,        5  The backup level.  Manual backups
                   full, incr,     are printed as blank column
                   migration       values in reports.
                   or manual
       client      string      11  The client name for the save set.
       attrs       NA          31  The extended save set attributes.
       pssid       =number     11  When part of a save set series, the
                                   previous save set identifier in the
                                   series, zero for the first or only




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        9





MMINFO(8)                                               MMINFO(8)


                                   save set in a series.
       ssflags     NA           7  The save set flags summary, one or more
                                   characters in the set CCvvrrSSEEiiIIFF, for
                                   continued, valid, purged (recoverable),
                                   scanned-in (rolled-in), eligible for
                                   recycling, incomplete, in-progress and
                                   finished (ended), respectively.
       continued   flag        NA  Matches continued save sets.
       recoverable flag        NA  Matches recoverable (purged) save sets.
       ssrecycle   flag        NA  Matches recyclable save sets.
       incomplete  flag        NA  Matches incomplete save sets.
       rolledin    flag        NA  Matches rolled-in save sets.
       valid       flag        NA  Matches valid save sets.  All save sets
                                   are marked `valid' by current servers.
       sumflags    NA           3  Per-volume save set summary flags,
                                   as described for the --vv report.
       fragflags   NA           3  Per-section save set summary flags,
                                   as described for the --VV report.
       totalsize   number      11  The total save set size.
       nfiles      number       5  The number of the client's files
                                   in the save set.
       ssexp       time         9  The save set's expiration time, `undef'
                                   means it depends on client policies.
       copies      number       6  The number of copies (instances or
                                   clones) of the save set, all with the
                                   same save time and save set identifier.
       cloneid     =number     11  The clone identifier of one copy.
       clonetime   time         9  The time a copy was made.
       clflags     NA           5  The clone flags summary, from the
                                   set aaiiss for aborted, incomplete
                                   and suspect (read error), respectively.
       suspect     flag        NA  Matches suspect save set copies, copies
                                   that had errors during file recovery.
       annotation  string      31  Matches the string to the save set's
                                   annotation.

       first       number      11  The offset of the first byte of the
                                   save set contained within the section.
       last        NA          11  The calculated offset of the last byte
                                   of the save set contained within the
                                   current section.
       fragsize    NA           7  The calculated size of the current
                                   section of the save set.
       sumsize     NA           7  The calculated total size of all of the
                                   sections of the save set on this volume.
       mediafile   number       5  The media file number containing
                                   the current section of the save set.
       mediarec    number       5  The media record number where the
                                   first bytes of the save set are found
                                   within the current media file.
       mediamark   number       5  The absolute positioning data for
                                   the current section (not used by
                                   existing servers).




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                       10





MMINFO(8)                                               MMINFO(8)


       ssaccess    time         9  The last time this section of the save
                                   set was access (for backup or recover).

EEXXAAMMPPLLEESS
       In  the  following examples, the equivalent short-hand and
       custom versions of the report are shown, when a short-hand
       option exists for a given report or query.

       Display  all  bootstraps  generated  in  the previous five
       weeks, as reported by ssaavveeggrrpp(8)::
              mmmmiinnffoo --BB
              mmmmiinnffoo --NN bboooottssttrraapp --tt ''55 wweeeekkss aaggoo'' --oott
                   --rr ''ssaavveettiimmee((1177)),,ssppaaccee,,lleevveell((66)),,ssssiidd''
                   --rr ''mmeeddiiaaffiillee((66)),,mmeeddiiaarreecc((88)),,ssppaaccee((33)),,vvoolluummee''

       Display information about all of the volumes:
              mmmmiinnffoo --mm
              mmmmiinnffoo --aa --rr ''ssttaattee,,vvoolluummee,,wwrriitttteenn,,%%uusseedd,,rreeaadd,,ssppaaccee,,vvoolleexxpp''
                   --rr ''mmoouunnttss((55)),,ssppaaccee((22)),,ccaappaacciittyy''

       Display  media  information  from  volumes  mmaarrss..000011   and
       mmaarrss..000022:
              mmmmiinnffoo --mm mmaarrss..000011 mmaarrss..000022
              mmmmiinnffoo --mm --qq ''vvoolluummee==mmaarrss..000011,,vvoolluummee==mmaarrss..000022''

       Display all save sets named //uussrr:
              mmmmiinnffoo --NN //uussrr
              mmmmiinnffoo --qq nnaammee==//uussrr

       Display  save  sets named //uussrr, generated by client vveennuuss,
       in the past week:
              mmmmiinnffoo --NN //uussrr --cc vveennuuss
              mmmmiinnffoo --qq ''nnaammee==//uussrr,,cclliieenntt==vveennuuss''

       Display save sets named //uussrr, generated by  client  vveennuuss,
       on volume mmaarrss..000011:
              mmmmiinnffoo --NN //uussrr --cc vveennuuss mmaarrss..000011
              mmmmiinnffoo --qq ''nnaammee==//uussrr,,cclliieenntt==vveennuuss,,vvoolluummee==mmaarrss..000011''

       Display  a  media  report of all volumes written on in the
       past week:
              mmmmiinnffoo --mm --tt ''llaasstt wweeeekk''
              mmmmiinnffoo --mm --qq ''ssaavveettiimmee>>==llaasstt wweeeekk''

       Display a media report of all  non-full  volumes,  showing
       the percent-used, pool and location of each volume:
              mmmmiinnffoo --aa --rr ''vvoolluummee,,%%uusseedd,,ppooooll,,llooccaattiioonn'' --qq ''!!ffuullll''

       Display  a media report similar to the --mm report but show-
       ing the barcode instead of the volume label:
              mmmmiinnffoo --aa --rr ''ssttaattee,,bbaarrccooddee,,wwrriitttteenn,,%%uusseedd,,rreeaadd,,ssppaaccee,,vvoolleexxpp''
                   --rr ''mmoouunnttss((55)),,ssppaaccee((22)),,ccaappaacciittyy''

       Display a verbose list of the instances of all  save  sets



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                       11





MMINFO(8)                                               MMINFO(8)


       with  more  than  one copy, sorted by save time and client
       name:
              mmmmiinnffoo --oottcc --vv --qq ''ccooppiieess>>11''

       Display all archive save sets with an annotation of  "pro-
       ject data" for the past four months.
              mmmmiinnffoo --qq''aannnnoottaattiioonn==pprroojjeecctt ddaattaa''
                   --rr""vvoolluummee,,cclliieenntt,,ssaavveettiimmee,,ssuummssiizzee,,ssssiidd,,nnaammee,,aannnnoottaattiioonn""
                   --tt''ffoouurr mmoonntthhss aaggoo''

FFIILLEESS
       //nnssrr//mmmm//mmmmvvoolluummee  The  save set and media volume databases
                         (actually accessed by nnssrrmmmmddbbdd(8)).

SSEEEE AALLSSOO
       nnssrr__ggeettddaattee(3), nnssrr__llaayyoouutt(5),  nnssrraaddmmiinn(8),  nnssrrmmmmddbbdd(8),
       rreeccoovveerr(8), ssaavveeggrrpp(8), ssccaannnneerr(8).

DDIIAAGGNNOOSSTTIICCSS
       nnoo mmaattcchheess ffoouunndd ffoorr tthhee qquueerryy
              No  save sets or volumes were found in the database
              that matched all of the constraints of the query.

       iinnvvaalliidd vvoolluummee nnaammee ``_v_o_l_n_a_m_e''
              The volume name given is not  in  a  valid  format.
              Note  that  volume names may not begin with a dash.
              Queries that match no volumes wil return the  error
              `no matches found for the query'.

       oonnllyy oonnee ooff --mm,, --BB,, --SS,, --XX oorr --rr mmaayy bbee ssppeecciiffiieedd
              Only  one  report  can be generated at a time.  Use
              separate runs of mmmmiinnffoo to obtain multiple reports.

       iinnvvaalliidd ssoorrttiinngg oorrddeerr ssppeecciiffiieerr,, cchhoooossee ffrroomm ``_c_e_l_m_n_o_t_R''
              Only  letters from _c_e_l_m_n_o_t_R may be used with the --oo
              option.

       oonnllyy oonnee --oo aalllloowweedd
              Only one sorting order may be specified.

       oonnllyy oonnee --ss aalllloowweedd
              Only one server can be queried at  one  time.   Use
              multiple runs of mmmmiinnffoo to obtain reports from mul-
              tiple servers.

       OOuutt ooff MMeemmoorryy
              The query exhausted available memory.  Try  issuing
              it  again, using the sorting order --oomm, or make the
              query more restrictive (eg. list specific  volumes,
              clients, and/or save set names).

       iinnvvaalliidd vvaalluuee ssppeecciiffiieedd ffoorr ``_a_t_t_r_i_b_u_t_e''
              The  value  specified is either out of range (eg. a
              negative number for a  value  that  can  only  take



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                       12





MMINFO(8)                                               MMINFO(8)


              positive  numbers),  the  wrong type (an alphabetic
              string value specified for a numeric attribute), or
              just  poorly  formatted  (eg.  non-blank characters
              between a close quote and the next comma or a miss-
              ing close quote).

       vvaalluuee ooff ``_a_t_t_r_i_b_u_t_e'' iiss ttoooo lloonngg
              The  value  specified  for _a_t_t_r_i_b_u_t_e is longer than
              the maximum accepted value.  Query attributes  must
              have values less than 65 characters long.

       nnoonn--oovveerrllaappppiinngg rraannggee ssppeecciiffiieedd ffoorr ``_a_t_t_r_i_b_u_t_e''
              The range specified for _a_t_t_r_i_b_u_t_e is a non-overlap-
              ping numeric range, and cannot possibly  match  any
              save set or volume in the database.

       uunnkknnoowwnn qquueerryy ccoonnssttrraaiinntt:: _a_t_t_r_i_b_u_t_e
              The  given  query  _a_t_t_r_i_b_u_t_e is not valid.  See the
              CCUUSSTTOOMM QQUUEERRIIEESS AANNDD RREEPPOORRTTSS table for a list of  all
              valid attribute names.

       nneeeedd aa vvaalluuee ffoorr qquueerryy ccoonnssttrraaiinntt ``_a_t_t_r_i_b_u_t_e''
              The  _a_t_t_r_i_b_u_t_e is not a flag, and must be specified
              in the `_n_a_m_e _c_o_m_p_a_r_a_t_o_r _v_a_l_u_e' format.

       ccoonnssttrraaiinntt ``_a_t_t_r_i_b_u_t_e'' iiss oonnllyy vvaalliidd ffoorr rreeppoorrttss
              The _a_t_t_r_i_b_u_t_e specified for a  query  may  only  by
              used  in  report  (--rr)  specifications.  Calculated
              values,   flag   summaries,   save   set   extended
              attributes,  and  formatting  tools (ssppaaccee and nneeww--
              lliinnee) may not be used in queries.

       iinnvvaalliidd ccoommppaarraattoorr ffoorr qquueerryy ccoonnssttrraaiinntt ``_a_t_t_r_i_b_u_t_e''
              The comparator used is  not  valid  for  the  given
              _a_t_t_r_i_b_u_t_e.  See the CCUUSSTTOOMM QQUUEERRIIEESS AANNDD RREEPPOORRTTSS sec-
              tion for  a  list  of  the  valid  comparators  for
              _a_t_t_r_i_b_u_t_e.

       qquueerryy ccoonnssttrraaiinntt ``_a_t_t_r_i_b_u_t_e'' ssppeecciiffiieedd mmoorree tthhaann oonnccee
              The  given  attribute  was specified more than once
              with the same  comparator,  and  is  not  a  string
              attribute  (string attributes can match one of sev-
              eral specific values).

       uunnkknnoowwnn rreeppoorrtt ccoonnssttrraaiinntt:: _a_t_t_r_i_b_u_t_e
              The given report _a_t_t_r_i_b_u_t_e is not  valid,  see  the
              CCUUSSTTOOMM  QQUUEERRIIEESS AANNDD RREEPPOORRTTSS table for a list of all
              valid attribute names.

       ccoonnssttrraaiinntt ``_a_t_t_r_i_b_u_t_e'' iiss oonnllyy vvaalliidd ffoorr qquueerriieess
              The _a_t_t_r_i_b_u_t_e specified for  a  report  is  a  flag
              matching  attribute  and  may only by used in query
              (--qq) specifications.  See the  CCUUSSTTOOMM  QQUUEERRIIEESS  AANNDD
              RREEPPOORRTTSS  table  for  the  appropriate  flag summary



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                       13





MMINFO(8)                                               MMINFO(8)


              attribute that one may use in reports  of  a  given
              flag.

       ccoolluummnn wwiiddtthh ooff ``_a_t_t_r_i_b_u_t_e'' iiss iinnvvaalliidd
              The  width specified for _a_t_t_r_i_b_u_t_e is out of range.
              Column widths must be positive  numbers  less  than
              256.

       mmiissssiinngg cclloossee ppaarreenntthheessiiss aafftteerr rreeppoorrtt ccoonnssttrraaiinntt
       ``_a_t_t_r_i_b_u_t_e''
              The width of _a_t_t_r_i_b_u_t_e is missing a close parenthe-
              sis.

       mmiissssiinngg ccoommmmaa aafftteerr rreeppoorrtt ccoonnssttrraaiinntt ``_a_t_t_r_i_b_u_t_e''
              There  are  non-blank  characters  after  the width
              specification for _a_t_t_r_i_b_u_t_e without any comma  pre-
              ceding them.

       NNoo ddaattaa rreeqquueesstteedd,, nnoo rreeppoorrtt ggeenneerraatteedd
              The  given  report specification contains only for-
              matting, no data attribute names.

LLIIMMIITTAATTIIOONNSS
       You cannot specify save set extended attributes  as  query
       constraints.

       You cannot list several possible equality matches for num-
       bers, only for strings.

       Some queries, namely those that are not  highly  selective
       (few  query constraints) and use a sorting order where the
       volume name is not the primary  sort  key,  still  require
       mmmmiinnffoo to retrieve the entire database before printing any
       of it.  Such queries use up large  amounts  of  memory  in
       mmmmiinnffoo,  but  not, as was the case with older versions, in
       nnssrrmmmmddbbdd.

       You cannot make a report that  shows  save  set  or  media
       instances  and  a  summary without running mmmmiinnffoo at least
       twice.

       You cannot specify query constraints that compare database
       attributes with each other.

       You cannot make a report that uses -B flag with -c flag.












NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                       14


