


NSR_LABEL(5)                                         NSR_LABEL(5)


NNAAMMEE
       nsr_label - NetWorker resource type ``NSR label''

SSYYNNOOPPSSIISS
       ttyyppee:: NNSSRR llaabbeell

DDEESSCCRRIIPPTTIIOONN
       Each  NSR label template is described by a single resource
       of type NNSSRR llaabbeell (see nnssrr__rreessoouurrccee(5)).  To edit the  NSR
       label resources for a NetWorker server, type:
              nsradmin -c "type:NSR label"
       or  use  the  nnwwaaddmmiinn(8)  GUI.  See the nnssrraaddmmiinn(8) manual
       page for more information on using the NetWorker  adminis-
       tration program.

       This  resource  describes  the  templates used to generate
       volume labels.

AATTTTRRIIBBUUTTEESS
       The following attributes are defined for resource type NNSSRR
       llaabbeell.   The  information in parentheses describes how the
       attribute  values  are   accessed.    Several   additional
       attributes   (e.g.   administrator)   are  common  to  all
       resources, and are described in nnssrr__rreessoouurrccee(5).

       nnaammee      (create only, single string, static)
              This attribute specifies the  name  of  this  label
              template.  The label template is referred to by its
              name in the jukebox resource, see nnssrr__jjuukkeebbooxx(5).
              _E_x_a_m_p_l_e_: name: Default;

       ffiieellddss         (read/write, list of strings)
              This attribute specifies the constituent fields  of
              a  _l_a_b_e_l  _t_e_m_p_l_a_t_e.  When generating a volume name,
              the current value of each  field  is  concatenated.
              The first field is considered the most significant,
              the last field the least.  If there is a  _s_e_p_a_r_a_t_o_r
              (see below) defined, then it will be placed between
              fields as they are concatenated to  form  a  volume
              name.  The fields are separated by commas.

              There  are four different types of fields: `numeric
              range', `lower-case range', `upper-case range', and
              a  `list of strings'.  A `list of strings' consists
              of space (` ') separated strings.  The other  types
              are  specified  as starting and ending values sepa-
              rated by a dash (`-') .  The  starting  and  ending
              values  of  a  range  must  have the same number of
              characters.

              The _n_e_x_t attribute (see below) contains the current
              position  or  value  of each field.  After a volume
              name has  been  assigned  to  a  volume,  the  _n_e_x_t
              attribute is incremented.  When the ending value is



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





NSR_LABEL(5)                                         NSR_LABEL(5)


              reached, the current value will wrap around to  the
              starting  value.   A  `list  of  strings'  field is
              incremented by selecting the  next  string  in  the
              list.   A  numeric  range  field  is incremented by
              adding 1 to  its  current  value.   Lower-case  and
              upper-case  ranges  are incremented by moving on to
              the next letter in the least significant  position.
              In  the  example below, after aa.99, the next label
              would be ab.00.
              _E_x_a_m_p_l_e_: fields: aa-zz, 00-99;

       sseeppaarraattoorr (read/write, single choice, null ok)
              This attribute specifies the character  to  use  to
              separate  the  label fields.  It may be one of `.',
              `_', `:', `-' or NULL.
              _E_x_a_m_p_l_e_: separator: .;

       nneexxtt      (read/write, single string)
              This attribute specifies the next  volume  name  to
              use.   After  it  is assigned to a volume, the next
              volume name will be generated and remembered  here.
              The  attribute  consists of a component for each of
              the specified fields and the separator.
              _E_x_a_m_p_l_e_:
              next: aa.00;

              Using the  separator  and  field  attributes  shown
              above, the _n_e_x_t attribute would show:  next: aa.01;
              This would be followed by:  next: aa.02;

EEXXAAMMPPLLEESS
       A label resource named _e_n_g_i_n_e_e_r_i_n_g is shown below.   (Hid-
       den  options  are  not  shown.)   There are two range type
       fields defined, the first ranging from `aa' to  `zz',  the
       second from `00' to `99'.  The _s_e_p_a_r_a_t_o_r attribute has the
       value `.' and it will  be  inserted  in  between  the  two
       fields.   The _n_e_x_t attribute holds the next name that will
       be generated by this template.  After _a_a_._0_0 is  used,  the
       _0_0  will  be  incremented.   The  new  name will be _a_a_._0_1.
       After  98  more  names  have  been  generated,  the   _n_e_x_t
       attribute  will  hold  the  name _a_a_._9_9.  When this name is
       incremented, the _n_e_x_t attribute will  hold  _a_b_._0_0.   After
       generating 67,500 more names, the _n_e_x_t attribute will hold
       _z_z_._9_9.  This will be followed by _a_a_._0_0.


              type: NSR label;
              name: engineering;
            fields: aa-zz, 00-99;
         separator: .;
              next: aa.00;

       A label resource named _a_c_c_o_u_n_t_i_n_g  is  shown  below.   The
       field   attribute  defines  five  component  fields.   The



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





NSR_LABEL(5)                                         NSR_LABEL(5)


       _s_e_p_a_r_a_t_o_r  attribute  has  the  value  `.'.   It  will  be
       inserted  in  between adjacent fields.  The _n_e_x_t attribute
       holds the next name that will be used with this  template.
       After  _0_._2_3_._a_a_._A_A_._f_i_r_s_t  is  used, the fifth field will be
       incremented.  The  new  name  will  be  _0_._2_3_._a_a_._A_A_._s_e_c_o_n_d.
       This  will  be  followed  by _0_._2_3_._a_a_._A_B_._f_i_r_s_t.  After 1349
       more volume names, the  name  will  be  _0_._2_3_._a_a_._Z_Z_._s_e_c_o_n_d.
       This  will  be  followed by _0_._2_3_._a_b_._A_A_._f_i_r_s_t.  After using
       _9_._4_5_._z_z_._Z_Z_._s_e_c_o_n_d,  the   name   will   wrap   around   to
       _0_._2_3_._a_a_._A_A_._f_i_r_s_t.


              type: NSR label;
              name: accounting;
            fields: 0-9, 23-45, aa-zz, AA-ZZ, first second;
         separator: .;
              next: 0.23.aa.AA.first;


SSEEEE AALLSSOO
       nnwwaaddmmiinn(8), nnssrraaddmmiinn(8), nnssrrjjbb(8), nnssrrmmmm(8), nnssrr(8),
       nnssrr__jjuukkeebbooxx(5).



































NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3


