


NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


NNAAMMEE
       nsr_jukebox - NetWorker resource type ``NSR jukebox''

SSYYNNOOPPSSIISS
       ttyyppee:: NNSSRR jjuukkeebbooxx

DDEESSCCRRIIPPTTIIOONN
       Each  jukebox  known to NetWorker is described by a single
       resource of type NNSSRR jjuukkeebbooxx.  A jukebox may also be  used
       to keep track of the resources, volumes and devices, being
       managed by an external media management service  that  are
       available  to  this  NetWorker  server.  An  example of an
       external media  management  service  is  OpenVault.   This
       resource describes the physical characteristics of a juke-
       box, See nnssrr__rreessoouurrccee(5) for more information on NetWorker
       resources.   To  edit the NSR jukebox resources for a Net-
       Worker server, type:
              nsradmin -c "type:NSR jukebox"
       or use the nnwwaaddmmiinn(8) GUI.   See  the  nnssrraaddmmiinn(8)  manual
       page  for more information on using the NetWorker adminis-
       tration program.

AATTTTRRIIBBUUTTEESS
       The following attributes are defined for resource type NNSSRR
       jjuukkeebbooxx.  The information in parentheses describes how the
       attribute values are accessed.  CCrreeaattee--oonnllyy indicates that
       the  value  cannot  be changed by an administrator, except
       when the resource is created.   RReeaadd--oonnllyy  indicates  that
       the   value   cannot   be  changed  by  an  administrator.
       RReeaadd//wwrriittee means the value can be set as well as  read  at
       any time.  CChhooiiccee lliisstt means that any number of values can
       be chosen from the given list.  YYeess//nnoo means only a yes or
       no  choice  is  possible.  SSiinnggllee ssttrriinngg means that only a
       single value is allowed.  NNuummbbeerr means that  only  numeric
       values  are  allowed.   SSttaattiicc  attributes  change  values
       rarely, if ever.  DDyynnaammiicc  attributes  have  values  which
       change rapidly.  HHiiddddeenn means it is an attribute of inter-
       est only to programs or experts, and these attributes  can
       only be seen when the hidden option is turned on in nnssrraadd--
       mmiinn(8) (or the View Details menu pulldown in  nnwwaaddmmiinn(8)).
       For  example, an attribute marked ((rreeaadd--oonnllyy,, ddyynnaammiicc)) has
       a value which cannot be changed by the  administrator  but
       which  may  change each time it is retrieved from the Net-
       Worker server due to underlying  state  changes.   Several
       additional  attributes  (e.g. administrator) are common to
       all resources, and are described in nnssrr__rreessoouurrccee(5).

       nnaammee      (create-only, single string)
              This attribute specifies the name of this  jukebox.
              The   value   of  this  attribute  may  follow  the
              "rd=hostname:" syntax of a remote device, when  the
              jukebox   is   defined  on  a  storage  node.   See
              nnssrr__ssttoorraaggee__nnooddee(5) for additional detail on  stor-
              age nodes.



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


              _E_x_a_m_p_l_e_: name: Huntington;

       mmooddeell          (create-only, single string)
              This attribute specifies the jukebox model.
              _E_x_a_m_p_l_e_: model: ADIC-VLS;

       pphhyyssiiccaall sslloottss (read-only, list of numbers, hidden)
              This  attribute specifies the first and last physi-
              cal slot numbers in the jukebox.   The  first  slot
              number  must be less than or equal to the last slot
              number, the numbers must be specified as two  sepa-
              rate attribute values.

              For  Silo  Tape  Libraries  (STL) this attribute is
              equal to the number of volumes  allocated  to  this
              NetWorker server, nnssrrjjbb(5) --aa or --xx..  The number of
              physical slots changes  as  volumes  are  added  or
              removed from the STL.
              _E_x_a_m_p_l_e_: physical slots: 1, 54;

       ccoonnttrrooll ppoorrtt   (read/write, single string)
              This  attribute  specifies  the path of the control
              port for the jukebox  robotics.   Control  commands
              (load  slot  47 into drive b, for example) are sent
              to the jukebox via the control port.

              The attribute has a different meaning for Silo Tape
              Libraries.  For an STL this attribute specifies the
              information required to set up a connection to  the
              STL  server.  Form  and  contents  of the attribute
              depend on the type of STL, but most often it merely
              contains the hostname of STL server.

              The   value   of  this  attribute  may  follow  the
              "rd=hostname:" syntax of a remote device, when  the
              jukebox   is   defined  on  a  storage  node.   See
              nnssrr__ssttoorraaggee__nnooddee(5) for additional detail on  stor-
              age nodes.
              _E_x_a_m_p_l_e_: control port: scsidev@0.6.0;

       ddeevviicceess        (read/write, list of strings)
              This  attribute  lists  the device pathnames of the
              devices in the jukebox.  Each entry that appears in
              this attribute must have a corresponding NNSSRR ddeevviiccee
              resource.  There must be the same number of entries
              in  the  _d_e_v_i_c_e_s  attribute as there are devices in
              the jukebox.  In addition, they must be  listed  in
              the  same order as they are physically installed in
              the jukebox.  The entries are specified as separate
              attribute values.
              _E_x_a_m_p_l_e_: devices: /dev/rmt/0mbn, /dev/rmt/1mbn;

       nnuummbbeerr ddeevviicceess (read/write, single number, hidden)
              The  number  of  configured devices in the jukebox.



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


              This value corresponds to the number of entries  in
              the ddeevviicceess attribute.
              _E_x_a_m_p_l_e_: number devices: 2;

       iiddllee ddeevviiccee ttiimmeeoouutt      (read/write, hidden)
              This  attribute  specifies the number of minutes to
              wait before unmounting a volume in an idle  device.
              Setting  this  attribute's  value to zero, disables
              unmounting idle  volumes.   The  function  of  this
              attribute  only applies to SmartMedia jukeboxes, or
              silo  and  native  jukeboxes  with  device  sharing
              enabled.
              _E_x_a_m_p_l_e_: idle device timeout: 10;

       SSmmaarrttMMeeddiiaa uuppddaattee iinntteerrvvaall         (read/write, hidden)
              This   attribute  specifies  the  number  of  hours
              between calls to  update  the  SmartMedia  server's
              database.   The SmartMedia database contains infor-
              mation copied from NetWorker's media database.  The
              information  includes,  the  pool to which a volume
              belongs, whether the volume  is  full,  etc.   This
              information  is  used by the SmartMedia server when
              selecting a volume for writing.  Since this  infor-
              mation  may  change  over  time, it is necessary to
              periodically make sure that the data replicated  in
              the  SmartMedia server's database is current.  This
              attribute  determines  the  time   period   between
              attempts   to   update   the   SmartMedia  server's
              database.  This attribute only  applies  to  Smart-
              Media jukeboxes.
              _E_x_a_m_p_l_e_: SmartMedia update interval: 12;

       wwrriittee eennaabblleedd  (read/write, yes/no, hidden)
              This  attribute  indicates  whether  writing can be
              done to the mounted volume.  This attribute is only
              used  during  a  jukebox  ``Load'' operation.  This
              attribute is used to pass information between  Net-
              Worker programs, and should not be changed manually
              by the administrator.
              _E_x_a_m_p_l_e_: write enabled: Yes;

       bbaarr ccooddee rreeaaddeerr     (read/write, yes/no)
              This attribute indicates whether  NetWorker  should
              use  the bar code label from the media if the juke-
              box has a bar code label reader.  This should  only
              be  enabled  if  the  jukebox  has a bar code label
              reader.
              _E_x_a_m_p_l_e_: bar code reader: No;

       mmaattcchh bbaarr ccooddee llaabbeellss    (read/write, yes/no)
              This attribute indicates whether  NetWorker  should
              use  the bar code label instead of a label template
              when labeling media volumes.  This should  only  be
              enabled  if the jukebox has a bar code label reader



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3





NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


              and the attribute "bar code reader" is enabled.
              _E_x_a_m_p_l_e_: match bar code labels: No;

       vvoolluummee eexxppiirraattiioonn   (read/write, single string, hidden)
              This attribute specifies the expiration time  of  a
              volume  that  is  currently  being  labeled, or for
              jukeboxes for interaction with external media  man-
              agement  services,  the minimum expiration time for
              the volume to be loaded.  This attribute is used to
              pass  information  between  NetWorker programs, and
              should not be changed manually by  the  administra-
              tor.

       aavvaaiillaabbllee sslloottss     (read/write, list of numbers)
              This  attribute specifies the slots containing vol-
              umes available to automatically  satisfy  NetWorker
              requests  for writable volumes.  When automatically
              selecting a writable  volume,  nnssrrjjbb(8)  will  only
              consider  volumes from the list of available slots.
              The slots are specified as a list  of  ranges,  one
              range per attribute value.  A range may be a single
              slot number or a pair of slot numbers separated  by
              a  dash.   The  first number of a pair must be less
              than or equal to the second.

              For Silo Tape Libraries this attribute is automati-
              cally  updated  when  adding  or  removing volumes,
              nnssrrjjbb(8) --aa or --xx..

              When satisfying requests to mount a particular vol-
              ume  (i.e., by its volume name) or slot, all of the
              volumes in the slots listed in _p_h_y_s_i_c_a_l  _s_l_o_t_s  can
              be  used.   This  allows  the  jukebox to be parti-
              tioned, with saves restricted to a group of volumes
              while all of the volumes contained within the juke-
              box are accessible for recovers.
              _E_x_a_m_p_l_e_: available slots: 1-10;

       eennaabblleerr ccooddee   (read-only, single string, hidden)
              This attribute lists the enabler code for  the  NNSSRR
              lliicceennssee resource (see nnssrr__lliicceennssee(5)) corresponding
              to this jukebox resource.  A jukebox cannot be used
              until  a license enabler has been loaded to control
              that jukebox.
              _E_x_a_m_p_l_e_: enabler code: 123456-123456-123456;

       eennaabblleedd sslloottss  (read-only, single string, hidden)
              The value of this attribute is the number of  slots
              enabled  for  this jukebox.  This attribute's value
              is set by the server when an enabler code is loaded
              to the jukebox.
              _E_x_a_m_p_l_e_: enabled slots: 8;





NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        4





NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


       ooppeerraattiioonn (read/write, choice list, hidden)
              This  attribute shows the operation currently being
              performed on the jukebox.  This attribute  is  used
              to pass information between NetWorker programs, and
              should not be changed manually by  the  administra-
              tor.
              _E_x_a_m_p_l_e_: operation: Load;

       ooppeerraattiioonn mmeessssaaggee   (read-only, single string, hidden)
              This  displays  an  error  message  after a jukebox
              operation fails.
              _E_x_a_m_p_l_e_: operation message: ;

       ooppeerraattiioonn ddeevviiccee    (read/write, single string, hidden)
              This attribute is used to  pass  the  name  of  the
              device to which the current operation refers.  This
              attribute is used to pass information between  Net-
              Worker programs, and should not be changed manually
              by the administrator.
              _E_x_a_m_p_l_e_: operation device: /dev/rmt/0mbn;

       ooppeerraattiioonn sslloottss     (read/write, single string, hidden)
              This attribute is used to pass  the  the  slots  on
              which  the  current  operation  will  be performed.
              This attribute is used to pass information  between
              NetWorker programs, and should not be changed manu-
              ally by the administrator.
              _E_x_a_m_p_l_e_: operation slots: 1-10;

       ooppeerraattiioonn ooppttiioonnss   (read/write, single string, hidden)
              This attribute is used to pass the mode of the vol-
              ume  used  when  the current operation will be per-
              formed, nnssrrjjbb(5) --oo option.  This attribute is used
              to pass information between NetWorker programs, and
              should not be changed manually by  the  administra-
              tor.
              _E_x_a_m_p_l_e_: operation options: manual;

       ooppeerraattiioonn bbaarrccooddeess  (read/write, list of strings, hidden)
              This  attribute is used to pass the the volume tags
              or barcodes on which the current operation will  be
              performed.  This attribute is used to pass informa-
              tion between NetWorker programs, and should not  be
              changed   manually   by  the  administrator.   This
              attribute is only used for Silo Tape Libraries  and
              is  only defined on platforms which provide support
              for Silo Tape Libraries.
              _E_x_a_m_p_l_e_: operation barcodes: A01B, A0/3-5/B;

       ooppeerraattiioonn rreessppoonnssee  (read/write, choice list, hidden)
              This attribute designates  a  default  response  to
              questions  that  may  be asked while performing the
              operation.  This attribute is used to pass informa-
              tion  between NetWorker programs, and should not be



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        5





NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


              changed manually by the administrator.
              _E_x_a_m_p_l_e_: operation response: Yes;

       ooppeerraattiioonn rreeppoorrtt mmooddee    (read/write, choice list, hidden)
              This attribute designates the amount of output gen-
              erated during the execution of the operation.  This
              attribute  is used to pass information between Net-
              Worker programs, and should not be changed manually
              by the administrator.
              _E_x_a_m_p_l_e_: operation report mode: verbose;

       ooppeerraattiioonn llaabbeell ssttaattee    (read/write, choice list, hidden)
              This attribute designates whether  a  volume  being
              labeled  is  to  be  recycled  or is expected to be
              unlabeled. If a volume is to be  recycled  it  must
              already  have a NetWorker label. Also used to recy-
              cle a volume  while  it  is  being  mounted.   This
              attribute  is used to pass information between Net-
              Worker programs, and should not be changed manually
              by the administrator.
              _E_x_a_m_p_l_e_: operation label state: recycle;

       ooppeerraattiioonn vvoolluummee ccaappaacciittyy     (read/write, single string,
       hidden)
              This  attribute  specifies the capacity of a volume
              being labeled.  This  attribute  is  used  to  pass
              information  between NetWorker programs, and should
              not be changed manually by the administrator.
              _E_x_a_m_p_l_e_: operation volume capacity: 10G;

       ooppeerraattiioonn vvoolluummee ttyyppee    (read/write, choice list, hidden)
              This  attribute specifies types of volumes that may
              be considered when allocating a volume.  Only  used
              when  interacting with an external media management
              service.  This attribute is used to  pass  informa-
              tion  between NetWorker programs, and should not be
              changed manually by the administrator.
              _E_x_a_m_p_l_e_: operation volume type: 8mm, dlt;

       ooppeerraattiioonn iinneelliiggiibbllee     (read/write, hidden)
              This attribute specifies volumes which are ineligi-
              ble  for  the  current  operation.  Only  used when
              interacting with an external media management  ser-
              vice.   This  attribute is used to pass information
              between  NetWorker  programs,  and  should  not  be
              changed manually by the administrator.
              _E_x_a_m_p_l_e_: operation ineligible: ;

       ooppeerraattiioonn ttaasskk (read/write, choice list, hidden)
              This attribute designates a secondary task or oper-
              ation to be performed with the  current  operation.
              For  example,  choosing the mmoouunntt aafftteerr llaabbeell task,
              will cause the volume to be mounted  after  it  has
              been labeled.  Currently only used when interacting



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        6





NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


              with an external media  management  service.   This
              attribute  is used to pass information between Net-
              Worker programs, and should not be changed manually
              by the administrator.
              _E_x_a_m_p_l_e_: operation task: mount after label;

       ooppeerraattiioonn rreessuulltt    (read only, hidden)
              Some  jukebox  support multiple simultaneous opera-
              tions. This attribute is similar to  the  ooppeerraattiioonn
              mmeessssaaggee attribute.  The difference being, that this
              attribute reports error messages for multiple oper-
              ations.   It  maintains error messages for the last
              32 simultaneous operations for this  jukebox,  that
              failed.   The instance of the operation that failed
              is stored with any error message generated  by  the
              operation.  This attribute is used to pass informa-
              tion between NetWorker programs, and should not  be
              changed manually by the administrator.

       ooppeerraattiioonn iinnssttaannccee  (read/write, single string, hidden)
              This  attribute designates an instance number to be
              associated with the operation. The instance must be
              unique  for all current operations.  The value used
              must be obtained from the ooppeerraattiioonn  nneexxtt  iinnssttaannccee
              attribute.  This attribute is used to pass informa-
              tion between NetWorker programs, and should not  be
              changed manually by the administrator.
              _E_x_a_m_p_l_e_: operation instance: 3;

       ooppeerraattiioonn nneexxtt iinnssttaannccee  (read only, single string, hid-
       den)
              This attribute designates an instance number to  be
              associated  with  the  next simultaneous operation.
              The value of this attribute should  be  applied  to
              next  simultaneous operation request for this juke-
              box.  This attribute is used  to  pass  information
              between  NetWorker  programs,  and  should  not  be
              changed manually by the administrator.
              _E_x_a_m_p_l_e_: operation next instance: 3;

       ooppeerraattiioonn iinnssttaanncceess (read only, hidden)
              This attribute reports the instance number  for  of
              every  simultaneous  operation currently executing.
              This attribute is used to pass information  between
              NetWorker programs, and should not be changed manu-
              ally by the administrator.
              _E_x_a_m_p_l_e_: operation instances: 1, 2;

       ooppeerraattiioonn hhoossttnnaammee  (read only, single string, hidden)
              This attribute designates the name of  the  machine
              on  which  the  operation is to executed. Only used
              for those jukeboxes which support devices, attached
              to multiple hosts. The host machine may be inferred
              from other attributes for the  operation,  such  as



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        7





NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


              ooppeerraattiioonn  ddeevviiccee..   If  a  device is specified the
              operation will be executed  on  the  host  for  the
              device.  Otherwise  the  host will be inferred from
              the name of the jukebox, unless a value  is  speci-
              fied for this attribute.  This attribute is used to
              pass information between  NetWorker  programs,  and
              should  not  be changed manually by the administra-
              tor.
              _E_x_a_m_p_l_e_: operation hostname: host1;

       ooppeerraattiioonn ddeevv hhoossttnnaammee   (read only, single string, hid-
       den)
              This  attribute  designates the name of the machine
              from which a device is to be selected for the oper-
              ation.   It  applies to shared jukeboxes, which can
              have  drives  attached  to  multiple  hosts.   This
              attribute  is used to pass information between Net-
              Worker programs, and should not be changed manually
              by the administrator.
              _E_x_a_m_p_l_e_: operation dev hostname: host1;

       ooppeerraattiioonn tteemmppllaattee  (read/write, single string, hidden)
              This  attribute  shows  the template that the label
              operation will use.  The verify operation sets this
              to  the  the volume name found on a piece of media.
              This attribute is used to pass information  between
              NetWorker programs, and should not be changed manu-
              ally by the administrator.
              _E_x_a_m_p_l_e_: operation template: Default;

       ooppeerraattiioonn vvoolluummee ppooooll    (read/write, choice list, hidden)
              This attribute specifies the default volume pool to
              use when labeling.  This attribute is used to  pass
              information  between NetWorker programs, and should
              not be changed manually by the administrator.
              _E_x_a_m_p_l_e_: operation volume pool: NonFull;

       ooppeerraattiioonn ssoouurrccee ppooooll    (read/write, choice list, hidden)
              This attribute specifies the pool from which a vol-
              ume may be selected when recycling a  volume.  Only
              supported on jukeboxes for volumes being managed by
              an  external  media   management   package.    This
              attribute  is used to pass information between Net-
              Worker programs, and should not be changed manually
              by the administrator.
              _E_x_a_m_p_l_e_: operation source pool: Default;

       ooppeerraattiioonn uusseess lleefftt (read/write, single string, hidden)
              This  attribute sets the number of times a cleaning
              cartridge may be used.  This attribute is  used  to
              pass  information  between  NetWorker programs, and
              should not be changed manually by  the  administra-
              tor.
              _E_x_a_m_p_l_e_: operation uses left: 12;



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        8





NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


       vvoolluummeess        (read/write, list of strings, hidden)
              This  attribute  contains a list of resident volume
              names.  The order corresponds to the  slot  number.
              This  attribute is used to pass information between
              NetWorker programs, and should not be changed manu-
              ally by the administrator.
              _E_x_a_m_p_l_e_:  volumes:  mars.001,  mars.002,  mars.003,
              mars.004;

       vvoolluummee iiddss          (read/write, list of strings, hidden)
              Every volume labeled by NetWorker is assigned  vol-
              ume identifier, often referred to as a volid.  This
              attribute contains a list of volume identifiers for
              the resident volumes.  The order corresponds to the
              slot number.  This attribute is used to pass infor-
              mation  between  NetWorker programs, and should not
              be changed manually by the administrator.
              _E_x_a_m_p_l_e_: volumes: 24198, 24199, 24200, 24197;

       vvoolluummee ccaarrttrriiddggee iiddss     (read/write, list of strings,
       hidden)
              Some jukeboxes track volumes that are managed by an
              external media management services.  There  may  be
              multiple  volumes  on the same media, e.g. a volume
              on each side of an optical disk. This attribute  is
              used  to track the identifier for each cartridge on
              which a volume resides.  The order  corresponds  to
              the  slot  number.   This attribute is used to pass
              information between NetWorker programs, and  should
              not be changed manually by the administrator.

       llooaaddeedd vvoolluummeess (read/write, list of strings, hidden)
              This  attribute  contains  the names of the volumes
              currently loaded on the jukebox devices.  The order
              is  with  respect  to  the _d_e_v_i_c_e_s attribute.  This
              attribute is used to pass information between  Net-
              Worker programs, and should not be changed manually
              by the administrator.
              _E_x_a_m_p_l_e_: loaded volumes: mars.089, mars.003;

              Using the names specified in the  previous  _d_e_v_i_c_e_s
              attribute,  _m_a_r_s_._0_8_9  is  loaded in `/dev/rmt/0mbn'
              and _m_a_r_s_._0_0_3 is loaded in `/dev/rmt/1mbn'.

       llooaaddeedd bbaarr ccooddeess    (read/write, list of strings, hidden)
              This attribute contains the bar codes of the loaded
              volumes, if the use of bar codes is enabled for the
              jukebox.  The order is with respect to the  _d_e_v_i_c_e_s
              attribute.  This attribute is used to pass informa-
              tion between NetWorker programs, and should not  be
              changed manually by the administrator.
              _E_x_a_m_p_l_e_: loaded bar codes: 12345, 67890;

              Using  the  names specified in the previous _d_e_v_i_c_e_s



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        9





NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


              attribute, the volume with bar code 12345 is loaded
              in  `/dev/rmt/0mbn'  and  the  volume with bar code
              67890 is loaded in `/dev/rmt/1mbn'.

       llooaaddeedd sslloottss   (read/write, list of numbers, hidden)
              This attribute contains the  slot  numbers  of  the
              loaded  volumes.   The order is with respect to the
              _d_e_v_i_c_e_s attribute.  This attribute is used to  pass
              information  between NetWorker programs, and should
              not be changed manually by the administrator.
              _E_x_a_m_p_l_e_: loaded slots: 48, 3;

              Using the names specified in the  previous  _d_e_v_i_c_e_s
              attribute,  the  volume  in  slot  48  is loaded in
              `/dev/rmt/0mbn' and the volume in slot 3 is  loaded
              in `/dev/rmt/1mbn'.

       eevveenntt ttaagg (read/write, single number, hidden)
              This attribute contains the tag (unique identifier)
              of the last notification event sent to the  nnssrrdd(8)
              daemon.   The  tag is used by nnssrrjjbb(8) to clear the
              previous event.  This attribute  is  used  to  pass
              information  between NetWorker programs, and should
              not be changed manually by the administrator.
              _E_x_a_m_p_l_e_: event tag: 6319962287;

       eevveenntt mmeessssaaggee  (read/write, single string, hidden)
              This attribute contains the text of the last  noti-
              fication  event  sent  to  the nnssrrdd(8) daemon.  The
              nnssrrjjbb(8) command will send a notification event  to
              nnssrrdd  when  operator  intervention is needed before
              nnssrrjjbb can proceed.  This attribute is used to  pass
              information  between NetWorker programs, and should
              not be changed manually by the administrator.
              _E_x_a_m_p_l_e_: event message:  could  not  unload  device
              /dev/rmt/1mbn into slot 4;

       mmeessssaaggeess  (read/write, list of strings, hidden)
              This  attribute contains a log of messages reflect-
              ing previous operations nnssrrjjbb(8) has done.   Gener-
              ally,  an  entry is made each time nnssrrjjbb is invoked
              and for each mechanical operation.  Each  entry  is
              time  stamped.   This  attribute  is  used  to pass
              information between NetWorker programs, and  should
              not be changed manually by the administrator.
              _E_x_a_m_p_l_e_:  messages: 04/01/91 01:15:08 loaded slot 4
              into drive a;

       mmiinniimmuumm ssppaaccee  (read/write, single string, hidden)
              This attribute contains  the  low  water  mark  for
              remaining  space.   When the remaining space on the
              volumes contained in the available  slots  is  less
              than  the  minimum space, a notification is sent to
              nsrd.  _T_h_i_s _h_i_d_d_e_n _a_t_t_r_i_b_u_t_e _c_a_n _b_e _m_o_d_i_f_i_e_d  _b_y  _a



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                       10





NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


              _u_s_e_r_.

              The  minimum  space may be specified as a number of
              gigabytes or megabytes.  Either `G' or `g'  may  be
              used for gigabytes, `M' or `m' for megabytes.
              _E_x_a_m_p_l_e_: minimum space: 7g;

       jjuukkeebbooxx ooppttiioonnss     (read-only, list of strings, hidden)
              This  attribute  contains a list of the options for
              this jukebox.  This  option  is  automatically  set
              after jukebox creation.
              _E_x_a_m_p_l_e_: jukebox options: two_sided;

       aauuttoo cclleeaann     (read/write, yes/no)
              This attribute specifies whether automatic cleaning
              of devices in the the jukebox is enabled.
              _E_x_a_m_p_l_e_: auto clean: Yes;

       cclleeaanniinngg sslloottss (read/write, list of numbers)
              This attribute designates a range of slots  in  the
              jukebox  that have been set aside for cleaning car-
              tridges. A range may be a single slot number  or  a
              pair  of  slot  numbers  separated by a dash.  If a
              pair of slot numbers is given the first  number  of
              the  pair must be less than or equal to the second.
              Only one range of slots may be set aside for clean-
              ing  cartridges.   If  aauuttoo  cclleeaann is set to nnoo the
              value of cleaning slots is ignored and these  slots
              may  contain  regular  volumes.  When aauuttoo cclleeaann is
              set to yyeess the range of slots  specified  for  this
              attribute  are  assumed  to  contain  cleaning car-
              tridges, and the range of slots specified by aavvaaiill--
              aabbllee  sslloottss  and  this  attribute must not overlap,
              they must be mutually exclusive.

              For Silo Tape Libraries this attribute  should  not
              be  changed  directly.  This attribute is automati-
              cally updated, when  adding  (  nnssrrjjbb(8)  --UU  )  or
              removing ( nnssrrjjbb(8) --xx ) cleaning cartridges.

              _E_x_a_m_p_l_e_: cleaning slots: 9-10;

       ddeeffaauulltt cclleeaanniinnggss   (read/write, single number)
              This   attribute  designates  the  number  of  uses
              assigned to a  new  cleaning  cartridge  during  an
              inventory  of  a  jukebox  by nnssrrjjbb(8).  A cleaning
              cartridge is considered to be new when a  slot  set
              aside  for  cleaning  cartridges  that was empty is
              discovered to be full  during  an  inventory  of  a
              jukebox.
              _E_x_a_m_p_l_e_: default cleanings: 12;

       aauuttoo mmeeddiiaa mmaannaaggeemmeenntt    (read-write)
              This  attribute  indicates  whether automated media



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                       11





NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


              management for the jukebox is enabled.   The  value
              can be yyeess or nnoo.  If the value is set to yyeess, then
              unlabeled volumes in the jukebox may  be  automati-
              cally  labeled  by  NetWorker.   NetWorker verifies
              that the volume is unlabeled  before  labeling  the
              volume.   A volume is considered to be unlabeled if
              the volume does not contain a  label  that  may  be
              read  by  the  device in the jukebox into which the
              volume is loaded.  Note that if the volume contains
              a label, but the label is written at a density that
              can not be read by the device the volume is consid-
              ered  to be unlabeled.  If the volume contains data
              written by an application other than  NetWorker  it
              most  likely  does not have a label recognizable by
              NetWorker and the volume is considered to be  unla-
              beled.   With this attribute enabled care should be
              taken when loading  any  volume  considered  to  be
              unlabeled  into the jukebox.  The volume may be re-
              labeled and the data previously on the volume over-
              written by NetWorker.  For devices in a jukebox the
              value of their aauuttoo mmeeddiiaa mmaannaaggeemmeenntt  attribute  is
              always nnoo.
              _E_x_a_m_p_l_e_: auto media management: yes;

       SSTTLL ddeevviiccee nnaammeess    (read/write, list of strings)
              The  device  names,  as  they are known by the Silo
              Tape Library.  This attribute lists the correspond-
              ing  silo device names of the devices listed in the
              ddeevviicceess attribute.  This attribute is only used for
              Silo  Tape  Libraries  and is only defined on plat-
              forms  which  provide   support   for   Silo   Tape
              Libraries.

       SSTTLL iinntteerrffaaccee lliibb   (read/write, single string)
              The  path  name of the dynamically linked interface
              library.  This attribute is only used for Silo Tape
              Libraries  and  is  only defined on platforms which
              provide support for Silo Tape Libraries.
              _E_x_a_m_p_l_e_: STL interface lib: /usr/lib/libstl.so.1;

       SSTTLL ddeevviiccee sshhaarriinngg  (read/write, single string)
              This attribute  specifies,  how  to  handle  device
              sharing.   Device  sharing  means  automatic,  load
              dependent, device switching of devices  in  a  Silo
              Tape  Library  between different hosts connected to
              the library.  This feature can only be used, if  it
              is  supported  by  the SSTTLL iinntteerrffaaccee lliibb.  Possible
              values for  this  attribute  are  an  empty  string
              (device sharing disabled) or "perm-max", where perm
              and max are numbers with perm < max.  perm  is  the
              number  of  devices,  which  can be reserved perma-
              nently, i.e. do not have to be released,  when  not
              in  use.   max is the maximum of devices, which can
              be reserved.  This attribute is only used for  Silo



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                       12





NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


              Tape  Libraries  and  is  only defined on platforms
              which provide support for Silo Tape Libraries.
              _E_x_a_m_p_l_e_: STL device sharing: 2-4;

       SSTTLL bbaarrccooddeess   (read-only, list of strings, hidden)
              The barcodes of the volumes in the  library,  which
              are  available for NetWorker.  This attribute main-
              tains the  volume  names  used  by  the  Silo  Tape
              Libraries for the corresponding volumes in the vvooll--
              uummeess attribute.  This attribute is  only  used  for
              Silo  Tape  Libraries  and  OpenVault virtual juke-
              boxes. The attribute is only defined  on  platforms
              which  provide  support  for Silo Tape Libraries or
              OpenVault.

       SSTTLL ddeevviiccee rreesseerrvvaattiioonn   (read-only, list of strings, hid-
       den)
              This  list contains the reservation state of shared
              devices in a tape library.  The possible states are
              "Yes"  (device  is  reserved),  "No" (device is not
              reserved) and "Error"  (an  error  occurred  during
              release of this device).  The order of the reserva-
              tion state matches the `devices'  attribute.   This
              attribute is only used for Silo Tape Libraries with
              device sharing enabled and is only defined on plat-
              forms   which   provide   support   for  Silo  Tape
              Libraries.

       aallllooccaatteedd ddeevviicceess   (list of strings, hidden)
              This attribute is only used for  jukeboxes  managed
              by  RLM.  Periodically  RLM needs a device to carry
              out a task. When RLM needs a  device  it  will  ask
              NetWorker  to  allocate  a device for its use. Net-
              Worker will not attempt to use a  device  that  has
              been  allocated  to RLM.  This attribute is used to
              pass information between  NetWorker  programs,  and
              should  not  be changed manually by the administra-
              tor.
              _E_x_a_m_p_l_e_: allocated devices: no, yes;

       aapppplliiccaattiioonn nnaammee (read/write, encrypted, hidden)
              This attribute is only  used  for  OpenVault  juke-
              boxes.  OpenVault requires any application to iden-
              tify itself when submitting a request.  This is the
              name  used  by  this  server  to identify itself to
              OpenVault  when  submitting  a  request  to  access
              resources listed in this jukebox.

       aapppplliiccaattiioonn kkeeyy     (read/write, encrypted, hidden)
              This  attribute  is  only  used for OpenVault juke-
              boxes. OpenVault requires any application to  iden-
              tify itself when submitting a request.  This is the
              key used by this server to identify itself to Open-
              Vault when submitting a request to access resources



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                       13





NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


              listed in this jukebox.

       rreeaadd hhoossttnnaammee  (read/write, single string)
              The hostname that is used in  selecting  a  storage
              node for recover and read-side clone requests.  For
              recover requests, if the  required  volume  is  not
              mounted, and the client's "storage nodes" attribute
              does not match one of the owning hosts in the juke-
              box,  then  this  attribute  is  used.   For  clone
              requests, if the required volume  is  not  mounted,
              then this attribute is used.

       jjuukkeebbooxx lloocckk   (read only, single string, hidden)
              This   attribute   is   to  synchronize  access  to
              resources  in  a  jukebox  that  supports  multiple
              simultaneous  operations. This attribute is used to
              lock the entire jukebox. When locked  this  is  the
              only  operation that has access to the jukebox. The
              value is equal to the instance number  assigned  to
              the  simultaneous operation holding the lock.  This
              attribute is used to pass information between  Net-
              Worker programs, and should not be changed manually
              by the administrator.
              _E_x_a_m_p_l_e_: jukebox lock: 10;

       ddeevviiccee lloocckkss   (read only, hidden)
              This attribute is to synchronize access  to  device
              resources  in  a  jukebox  that  supports  multiple
              simultaneous  operations.  Each  value   for   this
              attribute  is  a list of three numbers separated by
              "-". The first two  numbers  identify  a  range  of
              devices  locked. Each number identifies a device by
              the corresponding order the devices are  listed  in
              the  ddeevviicceess  attribute.   The  third number is the
              instance number assigned to the simultaneous opera-
              tion  which holds the lock.  This attribute is used
              to pass information between NetWorker programs, and
              should  not  be changed manually by the administra-
              tor.
              _E_x_a_m_p_l_e_: device locks: 1-1-10;

       vvoolluummee//sslloott lloocckkss   (read only, hidden)
              This attribute is to synchronize access  to  volume
              and slot resources in a jukebox which supports mul-
              tiple simultaneous operations. Each value for  this
              attribute  is  a list of three numbers separated by
              "-". The first two numbers identify  the  range  of
              volumes/slots  locked.   The  third  number  is the
              instance number assigned to the simultaneous opera-
              tion  which holds the lock.  Holding a lock, grants
              access to the slot and any volume  associated  with
              the  slot.  This attribute is used to pass informa-
              tion between NetWorker programs, and should not  be
              changed manually by the administrator.



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                       14





NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


              _E_x_a_m_p_l_e_: volume/slot locks: 1-5-10;

EEXXAAMMPPLLEE
       A  resource  defining a jukebox named _H_u_n_t_i_n_g_t_o_n is shown.
       The _m_o_d_e_l attribute specifies  a  `Exabyte  210'  jukebox.
       The  _c_o_n_t_r_o_l _p_o_r_t attribute specifies the bus, target, and
       lun id  for  the  robotics  device  `scsidev@0.6.0'.   The
       _d_e_v_i_c_e  attribute  lists  the  pathnames  of  the two tape
       devices    in    the    jukebox,    `/dev/rmt/0mbn'    and
       `/dev/rmt/1mbn'.  Since the jukebox has a bar code reader,
       the two bar code yes/no attributes are both set to  `Yes'.
       The  _a_v_a_i_l_a_b_l_e _s_l_o_t_s attribute lists the slots to consider
       when automatically selecting a volume to load for writing.
       The   available  slots  are  2  through  11.   The  hidden
       attributes are displayed.  _a_u_t_o _c_l_e_a_n is yes so  automatic
       cleaning of devices is enabled for this jukebox.  _c_l_e_a_n_i_n_g
       _s_l_o_t_s is set to slot 1. This slot is reserved for a clean-
       ing cartridge.


                               type: NSR jukebox;
                               name: Huntington;
                              model: EXB-210;
                     physical slots: 1-11;
                       control port: scsidev@0.6.0;
                            devices: /dev/rmt/0mbn, /dev/rmt/1mbn;
                      number device: 2;
            idle device timeout: 10;
     SmartMedia update interval: 12;
                      write enabled: Yes;
                    bar code reader: Yes;
              match bar code labels: Yes;
                  volume expiration: ;
                    available slots: 2-11;
                       enabler code: 012345-6789ab-cdef00;
                          operation: ;
                  operation message: ;
                   operation device: ;
                    operation slots: ;
                    operation ports: ;
                  operation options: ;
                 operation barcodes: ;
                 operation response: ;
              operation report mode: ;
              operation label state: ;
          operation volume capacity: ;
              operation volume type: ;
               operation ineligible: ;
                     operation task: ;
                   operation result: ;
                 operation instance: ;
            operation next instance: 2;
                 operation hostname: ;
             operation dev hostname: ;



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                       15





NSR_JUKEBOX(5)                                     NSR_JUKEBOX(5)


                 operation template: ;
              operation number uses: ;
              operation volume pool: ;
              operation source pool: ;
                            volumes: -, -, -, -, -, -, -, -, -, -, -;
                         volume ids: "", "", "", "", "", "", "", "", "", "", "";
                       STL barcodes: ;
                 STL device sharing: ;
             STL device reservation: ;
                  STL interface lib: ;
                          event tag: ;
                      event message: ;
                           messages: "09/12/97 11:50:56 CREATED";
                      minimum space: 7g;
                    jukebox options: ;
                         auto clean: Yes;
                     cleaning slots: 1;
                  default cleanings: 12;
              auto media management: Yes;
                        reset class: initialize unload;
                   application name: ;
                    application key: ;
                      read hostname: hostname;
                       jukebox lock: ;
                       device locks: ;
                  volume/slot locks: ;


SSEEEE AALLSSOO
       nnssrr(5), nnssrr__ddeevviiccee(5), nnssrr__ssttoorraaggee__nnooddee(5), nnssrraaddmmiinn(8),
       nnssrrdd(8), nnssrrjjbb(8), nnwwaaddmmiinn(8).


























NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                       16


