


NSR_DEVICE(5)                                       NSR_DEVICE(5)


NNAAMMEE
       nsr_device - NetWorker resource type ``NSR device''

SSYYNNOOPPSSIISS
       ttyyppee:: NNSSRR ddeevviiccee

DDEESSCCRRIIPPTTIIOONN
       Each   storage  device  used  by  a  NetWorker  server  is
       described by a single resource of type  NNSSRR  ddeevviiccee.   See
       nnssrr__rreessoouurrccee(5)  for  information  on NetWorker resources.
       To edit the NNSSRR ddeevviiccee resources run:
              nsradmin -c "type:NSR device"
       Be careful to include the quotes  and  the  space  between
       ``NSR''  and  ``device''.  See nnssrraaddmmiinn(8) for information
       on using the NetWorker administration  program.   Mounting
       and  unmounting  individual  volumes  (tapes or disks), is
       done through the nnssrrmmmm(8), nnssrrjjbb(8), and  nnwwaaddmmiinn(8)  pro-
       grams.

AATTTTRRIIBBUUTTEESS
       The following attributes are defined for resource type NNSSRR
       ddeevviiccee.  The information in parentheses describes how  the
       attribute  values  are accessed.  RReeaadd--oonnllyy indicates that
       the  value  cannot  be  changed   by   an   administrator.
       RReeaadd//wwrriittee  means  the  value  can be set as well as read.
       HHiiddddeenn means it is an attribute of interest only  to  pro-
       grams  or  experts,  and these attributes can only be seen
       when the hidden option is turned on in nnssrraaddmmiinn(8)  or  if
       the  _D_e_t_a_i_l_s  _V_i_e_w option is selected in the _M_e_d_i_a _D_e_v_i_c_e_s
       window in nnwwaaddmmiinn(8).   SSttaattiicc  attributes  change  values
       rarely,  if  ever.   DDyynnaammiicc  attributes have values which
       change rapidly.  For example, an attribute  marked  ((rreeaadd--
       oonnllyy,,  ssttaattiicc)) has a value which is set when the attribute
       is created and never changes.

       nnaammee                        (read-only, static)
              The name attribute specifies the path name  of  the
              device.   Tape  devices must be no-rewind.  On sys-
              tems that  optionally  support  ``Berkeley  style''
              tape  positioning  on  close,  the  BSD  style tape
              device name should be used.  Optical disks are usu-
              ally  the  `c'  partition  of  the  raw device.  To
              facilitate interaction with an external media  man-
              agement  service  the  concept  of a logical device
              type has been defined.  When interacting with  such
              services,  the device into which a volume is loaded
              may be determined by the media management  service.
              The  logical  device  is used to define a NetWorker
              device resource.  The number of such resources is a
              limit  on the number of volumes managed by the ser-
              vice, that NetWorker may access simultaneously.  At
              the  time  of definition the name of this device is
              not related to any specific device, it just has  to
              be  a  unique  name for a device.  For such devices



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





NSR_DEVICE(5)                                       NSR_DEVICE(5)


              both the media type and the family are set to llooggii--
              ccaall..   The  name,  type,  and family are determined
              after the media management  service  has  loaded  a
              volume  into a device in response to a request made
              by NetWorker.  The name, type, and  family  of  the
              actual  device  are  then  stored in the attributes
              llooggiiccaall nnaammee ,, llooggiiccaall ttyyppee ,, and llooggiiccaall ffaammiillyy  ,,
              respectively.   The association between the logical
              device and the actual device last only as long as a
              volume  is loaded into the device and allocated for
              use by NetWorker.  When defining a remote device on
              a storage node, prefix the path name with `rd=host-
              name:', where hostname is the system to  which  the
              device  is  directly  attached  (the storage node).
              See nnssrr__ssttoorraaggee__nnooddee(5) for additional detail.
              _E_x_a_m_p_l_e_: name: /dev/rmt/0hbn;

       mmeeddiiaa ttyyppee                  (read-only, static)
              The type of media this  device  uses.   The  actual
              list  varies  depending  on  the OS platform.  Some
              potential  legal  values  and  their  meaning   and
              default  capacities  are:  44mmmm  - 4mm digital audio
              tape (1 GB); 88mmmm - 8mm video tape (2 GB); 88mmmm 55GGBB -
              8mm  video  tape  (5 GB); ddlltt - digital linear tape
              cartridge (10 GB); vvhhss - VHS data grade video  tape
              (14 GB); 33448800 - high-speed cartridge tape (200 MB);
              qqiicc - quarter inch data cartridge (150 MB); hhiimmtt  -
              half  inch  magnetic tape (100 MB); ttkk5500 - DEC TK50
              cartridge tape (94 MB); ttkk7700 - DEC  TK70  cartridge
              tape  (296 MB); ooppttiiccaall - optical disks, Write Once
              Read Many (WORM), Erasable Optical Disks (EOD),  or
              standard  UNIX  files  are  supported;  ffiillee - file
              device type, standard  UNIX  file  system  is  sup-
              ported;  llooggiiccaall  -  used  when interacting with an
              external media management service.
              _E_x_a_m_p_l_e_: media type: 8mm 5GB;

       eennaabblleedd                     (read-write)
              This attribute  indicates  whether  the  device  is
              available for use.  The value can be yyeess or nnoo.  If
              the value is set to no, no volumes may  be  mounted
              on  the  device.   The value cannot be changed if a
              volume is mounted.
              _E_x_a_m_p_l_e_: enabled: yes;

       rreeaadd oonnllyy                   (read-write)
              This attribute  indicates  whether  the  device  is
              reserved  for read only operations, such as recover
              or retrieve.  The value can be yyeess or nnoo.   If  the
              value  is set to yes, only read operations are per-
              mitted on the device.  The value cannot be  changed
              if a volume is mounted.
              _E_x_a_m_p_l_e_: read only: yes;




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





NSR_DEVICE(5)                                       NSR_DEVICE(5)


       ttaarrggeett sseessssiioonnss             (read/write)
              This attribute gives the target number of saves for
              this device.  Saves are allocated to each device in
              order,  until this many are assigned, then the next
              device is used.   Once  all  devices  have  reached
              their  corresponding target number, additional ses-
              sions are allocated  equally  across  all  devices.
              The  value  can  be  set  by an administrator.  Use
              higher values to multiplex many clients  onto  each
              tape.   There may be value in spreading the clients
              over as many devices as possible.   This  attribute
              is  not  a maximum number for a device, but is used
              for load-balancing.
              _E_x_a_m_p_l_e_: target sessions: 3;

       mmeeddiiaa ffaammiillyy                (read-only, static, hidden)
              The media family describes  the  class  of  storage
              media,  as determined from the media type. The only
              legal values are: ttaappee - tape storage device;  ddiisskk
              -  disk  storage device; llooggiiccaall - used when inter-
              acting with an external media management service.
              _E_x_a_m_p_l_e_: media family: tape;

       mmeessssaaggee                     (read-only, dynamic, hidden)
              The last message of any  kind  from  the  NetWorker
              server  regarding  this  device.   The  values  may
              include information on the progress or rate of  the
              operation.
              _E_x_a_m_p_l_e_: message: "Tape full, mount volume mars.017
              on /dev/nrst8";

       vvoolluummee nnaammee                 (read-only, dynamic, hidden)
              This is used to monitor the mounting and unmounting
              of  volumes  for  this  device.  When  a  volume is
              mounted, the value is the  volume  name,  otherwise
              there is no value.
              _E_x_a_m_p_l_e_: volume name: mars.017;

       wwrriittee eennaabblleedd               (read/write, dynamic, hidden)
              This  is used to indicate if writing on the current
              volume is allowed.  The value can  be  yyeess  or  nnoo.
              This can only be set when no volume is mounted.
              _E_x_a_m_p_l_e_: write enabled: no;

       vvoolluummee ooppeerraattiioonn            (read/write, dynamic, hidden)
              The  volume  operation manipulates the media volume
              currently in the device.  It may be one of the fol-
              lowing values: UUnnmmoouunntt, MMoouunntt, VVeerriiffyy llaabbeell, VVeerriiffyy
              wwrriittee ttiimmee, LLaabbeell, LLaabbeell wwiitthhoouutt mmoouunntt,  EEjjeecctt,  or
              MMoonniittoorr  ddeevviiccee.   Each  of  these  operations  may
              require parameters in or set  attributes  described
              below.    When  the  value  is  UUnnmmoouunntt,  NetWorker
              releases the  device.   The  UUnnmmoouunntt  operation  is
              asynchronous.   When  the value is MMoouunntt, NetWorker



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3





NSR_DEVICE(5)                                       NSR_DEVICE(5)


              mounts the loaded volume on the device.  The  MMoouunntt
              operation  is asynchronous.  When the value is VVeerr--
              iiffyy llaabbeell, the  volume's  label  is  read  and  the
              attributes  vvoolluummee llaabbeell, and vvoolluummee eexxppiirraattiioonn are
              set.  The VVeerriiffyy llaabbeell operation is synchronous and
              therefore  may take a long time.  VVeerriiffyy wwrriittee ttiimmee
              is similar to VVeerriiffyy llaabbeell, but it  also  sets  the
              vvoolluummee  wwrriittee  ttiimmee  attribute.   When the value is
              LLaabbeell or LLaabbeell wwiitthhoouutt mmoouunntt, the volume receives a
              new  label  as  determined by the attributes below.
              When the value is LLaabbeell the volume is then mounted.
              These  operations are asynchronous.  When the value
              is EEjjeecctt, NetWorker  ejects  the  volume  from  the
              device.  The EEjjeecctt operation is asynchronous.  When
              the value is MMoonniittoorr ddeevviiccee and the device is  idle
              (no  volume loaded into the device) NetWorker peri-
              odically checks the device to determine  whether  a
              volume  has  been  loaded  into the device.  When a
              volume containing a  readable  NetWorker  label  is
              loaded,   the   volume   is  in  NetWorker's  media
              database, and the volume may is writable the volume
              is  mounted  with  write  permission. Otherwise the
              volume is mounted read only.  When a volume without
              a  readable  NetWorker  label  is  loaded  into the
              device,  the  device's  uunnllaabbeelleedd   vvoolluummee   llooaaddeedd
              attribute  is  set  to  yyeess,  and the volume may be
              labeled at a later date.  NetWorker  only  monitors
              non-jukebox  devices.  The MMoonniittoorr ddeevviiccee operation
              is never performed on jukebox devices.

       vvoolluummee llaabbeell                (read/write, dynamic, hidden)
              This attribute is set by the VVeerriiffyy llaabbeell operation
              and  may  be  an  input to the LLaabbeell operation.  If
              this attribute is blank during  labeling  then  the
              volume's current label is reused.

       vvoolluummee ddeeffaauulltt ccaappaacciittyy     (read/write, static, hidden)
              This  attribute is used by the LLaabbeell operation, but
              only if the vvoolluummee ccuurrrreenntt  ccaappaacciittyy  attribute  is
              blank.   A  non-blank value is used to override the
              the default  capacity  associated  with  the  media
              type.  The value of this attribute must end with K,
              M, or G signifying Kilobytes, Megabytes,  or  Giga-
              bytes.   _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
              _u_s_e_r_.  This is useful for overriding default  sizes
              when  using  devices  (and/or tapes) with different
              capacities than  the  defaults.   For  example,  to
              override the default capacity of a tape drive to 10
              Gb for all future volume label operations, set  the
              value as follows:
              volume default capacity: 10G;

       vvoolluummee ccuurrrreenntt ccaappaacciittyy     (read/write, dynamic, hidden)
              If   the   attribute's   value   is  non-blank,  it



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        4





NSR_DEVICE(5)                                       NSR_DEVICE(5)


              determines the capacity  of  a  volume  during  the
              LLaabbeell  operation.  Its format is the same as vvoolluummee
              ddeeffaauulltt ccaappaacciittyy..
              _E_x_a_m_p_l_e_: volume current capacity: 5G;

       vvoolluummee eexxppiirraattiioonn           (read/write, dynamic, hidden)
              This attribute is set by the VVeerriiffyy llaabbeell operation
              and  may  also be used by the LLaabbeell operation.  The
              value is in nnssrr__ggeettddaattee(3) format.  A  blank  value
              causes  the  default  expiration  to be used during
              labeling.
              _E_x_a_m_p_l_e_: volume expiration: next year;

       vvoolluummee ppooooll                 (read/write, hidden)
              If a volume is mounted, this attribute reflects the
              pool  the  volume belongs to.  If this attribute is
              set during a LLaabbeell or LLaabbeell  wwiitthhoouutt  mmoouunntt  opera-
              tion,  this value represents the pool the volume is
              being assigned to.  See nnssrr__ppooooll(5) for more infor-
              mation on volume pools.
              _E_x_a_m_p_l_e_: volume pool: Default;

       NNSSRR ooppeerraattiioonn               (read-only, dynamic, hidden)
              This attribute reflects the current operation being
              performed by the  device.   The  values  are  IIddllee,
              WWrriittee, RReeaadd, EEjjeecctt, VVeerriiffyy llaabbeell, or LLaabbeell.
              _E_x_a_m_p_l_e_: NSR operation: Write;

       mmiinnoorr mmooddee                  (read-only, dynamic, hidden)
              This  attribute  reports  the  current  state  of a
              device.  The NNSSRR ooppeerraattiioonn attribute is  the  major
              mode.   The  values  are  iiddllee,  rreeaaddiinngg,  wwrriittiinngg,
              rreewwiinnddiinngg, mmoovviinngg ffoorrwwaarrdd, mmoovviinngg bbaacckkwwaarrdd,  eerrrroorr,
              ddoonnee, wwrriittiinngg eeooff, or ffiinnddiinngg eeoomm.
              _E_x_a_m_p_l_e_: minor mode: moving forward;

       ssttaattiissttiiccss                  (read-only, dynamic, hidden)
              This attribute reports the statistics for the oper-
              ation of this  device.   The  statistics  currently
              include the time of operation ("eellaappsseedd"), the num-
              ber of errors ("eerrrroorrss"),  the  last  writing  rate
              ("llaasstt rraattee"), the max number of concurrent clients
              ("mmaaxx cclliieennttss"), the number of file  marks  written
              ("ffiillee  mmaarrkkss"), the number of rewinds ("rreewwiinnddss"),
              the number of files skipped ("ffiilleess sskkiippppeedd"),  the
              number  of records skipped ("rreeccoorrddss sskkiippppeedd"), the
              current file number ("ccuurrrreenntt ffiillee"),  the  current
              record  number  ("ccuurrrreenntt  rreeccoorrdd"),  the  relative
              nhumber of files being spaced over ("sseeeekk  ffiilleess"),
              the  relative  number  of records being spaced over
              ("sseeeekk  rreeccoorrddss"),  the  total   estimated   amount
              read/written  on the volume, in kb ("eessttiimmaatteedd kkbb",
              to be implemented in a future release),  the  total
              amount  read/written  on the volume, in kb ("aammoouunntt



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        5





NSR_DEVICE(5)                                       NSR_DEVICE(5)


              kkbb"), the current amount read/written on this file,
              in kb ("ffiillee aammoouunntt kkbb"), and the current number of
              sessions assigned to this device ("sseessssiioonnss").

       cclleeaanniinngg rreeqquuiirreedd           (read/write)
              This attribute indicates whether the  device  needs
              to  cleaned.  The  value  may  be yyeess or nnoo. If the
              value of this attribute changes from yes to no  and
              the  value of ddaattee llaasstt cclleeaanneedd is not updated then
              ddaattee llaasstt cclleeaanneedd is set to the current time.  Net-
              Worker may set this attribute to yes if at the time
              the device is next scheduled to be cleaned it can't
              be  cleaned.  In this case a notice is sent via the
              notification ddeevviiccee  cclleeaanniinngg  rreeqquuiirreedd  indicating
              that   the   device  needs  to  be  cleaned.   This
              attribute may only be used for a device whose mmeeddiiaa
              ffaammiillyy  is ttaappee and jjuukkeebbooxx ddeevviiccee is yyeess.  For all
              other devices the value of this attribute is always
              nnoo.

       cclleeaanniinngg iinntteerrvvaall           (read/write)
              This  attribute  specifies  the amount of time from
              ddaattee llaasstt cclleeaanneedd until the next scheduled cleaning
              for the device. The value may be specified in ddaayyss,
              wweeeekkss, or  mmoonntthhss.  One  day,  week,  or  month  is
              implied  if  a  number  is  not  specified. If this
              attribute is set and ddaattee llaasstt  cclleeaanneedd  is  blank,
              ddaattee llaasstt cclleeaanneedd is set to the current time.  This
              attribute may only be used for a device whose mmeeddiiaa
              ffaammiillyy is ttaappee and jjuukkeebbooxx ddeevviiccee is yyeess.
              _E_x_a_m_p_l_e_: cleaning interval: 2 weeks;

       ddaattee llaasstt cclleeaanneedd           (read/write)
              This  attribute records the time and day the device
              was  last  cleaned.   Input  maybe  in  any  format
              acceptable  to nnssrr__ggeettddaattee((33))..  Some values accept-
              able to nnssrr__ggeettddaattee((33)) are relative, e.g. nnooww.  For
              that  reason  all  input is converted into ccttiimmee((33))
              format, weekday, month, day, time, year.  As  noted
              in  the description of cclleeaanniinngg rreeqquuiirreedd and cclleeaann--
              iinngg iinntteerrvvaall the value of  this  attribute  may  be
              automatically set by NetWorker.  This attribute may
              only be used for a device  whose  mmeeddiiaa  ffaammiillyy  is
              ttaappee and jjuukkeebbooxx ddeevviiccee is yyeess.

       vvoolluummee bblloocckk ssiizzee           (read-only, dynamic, hidden)
              This  attribute  gives  the block size for the cur-
              rently mounted volume.

       vvoolluummee iidd                   (read-only, dynamic, hidden)
              This attribute gives the volume  id  for  the  cur-
              rently mounted volume.





NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        6





NSR_DEVICE(5)                                       NSR_DEVICE(5)


       aacccceessss ccoouunntt                (read-only, dynamic, hidden)
              This  attribute gives the number of operations per-
              formed on the device since it's first configured as
              a NetWorker device.

       aacccceessss wweeiigghhtt               (read-only, dynamic, hidden)
              This  attribute gives the weight of a single opera-
              tion performed on the device.  The  `access  count'
              attribute  will  be  incremented by `access weight'
              for every operation performed on the  device.   The
              higher  the  weight, the less often the device will
              be selected for new operations.

       ccoonnsseeccuuttiivvee eerrrroorrss          (read-only, dynamic, hidden)
              This attribute gives the current number of consecu-
              tive errors on device.

       mmaaxx oonnsseeccuuttiivvee eerrrroorrss       read-only, hidden)
              This attribute gives the maximum number of consecu-
              tive errors allowed before disabling the device.

       ooppeerraattiioonn aarrgg               (read-only, dynamic, hidden)
              This attribute used for extra parameters for device
              operation.   Parameters  are packed in a string and
              parsed by the operation function.

       vvoolluummee mmeessssaaggee              (read-only, dynamic, hidden)
              This attribute reflects the result of the last vol-
              ume operation.

       vvoolluummee wwrriittee ttiimmee           (read-only, dynamic, hidden)
              This  attribute  gives the time that a save set was
              first written to the volume.

       vvoolluummee ffllaaggss                (read/write, hidden)
              This attribute displays the new flags for the  vol-
              ume being operated on.  This attribute is used dur-
              ing a "Label" or "Label without mount" operation.

       jjuukkeebbooxx ddeevviiccee              (read/write, dynamic, hidden)
              This attribute indicates the media device  is  part
              of a jukebox device.  The value can be yyeess or nnoo.

       uunnllaabbeelleedd vvoolluummee llooaaddeedd     (read only, dynamic, hidden)
              This  attribute  indicates  whether a volume loaded
              into the device has  a  readable  NetWorker  volume
              label.  The  value can be yyeess or nnoo.  The attribute
              is set to yyeess  when  NetWorker  is  monitoring  the
              device,  a volume is loaded into the device and the
              volume does not have a valid NetWorker  label  that
              can  be  read by this device.  The attribute is set
              to nnoo when the volume in the device is  labeled  or
              ejected from the device.




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        7





NSR_DEVICE(5)                                       NSR_DEVICE(5)


       aauuttoo mmeeddiiaa mmaannaaggeemmeenntt       (read-write)
              This  attribute  indicates  whether automated media
              management for the device is enabled.  For  jukebox
              devices the value is always nnoo.  See nnssrr__jjuukkeebbooxx(5)
              for a description of aauuttoo mmeeddiiaa  mmaannaaggeemmeenntt  for  a
              jukebox.   For non-jukebox devices the value may be
              yyeess or nnoo.  If the value is set to yyeess  then  recy-
              clable volumes loaded into the device may automati-
              cally be re-labeled by  NetWorker  for  re-use  and
              unlabeled  volumes  loaded  into  the device may be
              automatically labeled.  When NetWorker is  labeling
              a  volume that is not expected to have a valid Net-
              Worker label, it verifies that the volume is  unla-
              beled before labeling the volume.  A volume is con-
              sidered to be unlabeled if the volume does not con-
              tain a label that may be read by this device.  Note
              that if the volume contains a label, but the  label
              is  written  at  a  density that can not be read by
              this device the volume is considered  to  be  unla-
              beled.   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  unlabeled.   With
              this  attribute  enabled  care should be taken when
              loading any volume considered to  be  unlabeled  or
              recyclable  into the device.  The volume may be re-
              labeled and the data previously on the volume over-
              written  by  NetWorker.  When this attribute is set
              to yyeess for a device and the device is idle (no tape
              loaded  into  the  device), then NetWorker monitors
              the device waiting for a volume to be  loaded  into
              the  device.  See the description of MMoonniittoorr ddeevviiccee
              in  the  discussion   of   the   vvoolluummee   ooppeerraattiioonn
              attribute.
              _E_x_a_m_p_l_e_: auto media management: yes;

       llooggiiccaall nnaammee                (read-only, hidden, no create)
              Only used for logical devices. It is  the  name  of
              the  actual  device  currently  associated with the
              logical    device.     _E_x_a_m_p_l_e_:    logical    name:
              /dev/rmt/0hbn;

       llooggiiccaall ttyyppee                (read-only, hidden, no create)
              Only used for logical devices. It is  the  type  of
              the  actual  device  currently  associated with the
              logical device. The values which may be  associated
              with  this  attribute are the values that are valid
              for the attribute mmeeddiiaa ttyyppee ..  The lone  exception
              is  that the value of this attribute may not be set
              to llooggiiccaall..
              _E_x_a_m_p_l_e_: logical type: 8mm 5GB;

       llooggiiccaall ffaammiillyy              (read-only, hidden, no create)
              Only  used for logical devices. It is the family of



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        8





NSR_DEVICE(5)                                       NSR_DEVICE(5)


              the actual device  currently  associated  with  the
              logical  device. The values which may be associated
              with this attribute are the values that  are  valid
              for  the  attribute mmeeddiiaa ffaammiillyy ..  The lone excep-
              tion is that the value of this attribute may not be
              set to llooggiiccaall..
              _E_x_a_m_p_l_e_: logical family: tape;

       ccoonnnneeccttiioonn pprroocceessss iidd       (read only, hidden, no create)
              External media management services often require  a
              connection to be maintained while an application is
              using allocated resources. If the connection is not
              maintained  the  service may attempt to reclaim any
              resources allocated to  an  application.  This  may
              include  unloading  a  volume  mounted in a device.
              Therefore, while NetWorker has a volume mounted  in
              a device being managed by such a service, a process
              must maintain an open  connection  with  the  media
              management  service.   This  attribute  records the
              process identifier maintaining the connection while
              a volume is mounted in this device.

       ccoonnnneeccttiioonn mmeessssaaggee          (read only, hidden, no create)
              This attribute records any error  message  reported
              on  exit  by process maintaining connection with an
              external media management service.

       ccoonnnneeccttiioonn ssttaattuuss           (read only, hidden, no create)
              This attributes records the exit status reported by
              process maintaining a connection with  an  external
              media management service. Status of zero means pro-
              cess exited normally. A non-zero  status  indicates
              an error on exit.

       ssaavvee mmoouunntt ttiimmeeoouutt          (read/write, hidden, no cre-
       ate)
              This attribute describes the timeout  value  of  an
              initial  save mount request for the storage node on
              which this device resides.  If the request  is  not
              satisfied  within this number of minutes, the stor-
              age node will be locked from receiving save assign-
              ments,  for  "save lockout" minutes.  See nnssrr__ssttoorr--
              aaggee__nnooddee(5) for a  description  of  storage  nodes.
              This  attribute  can  be  used for local devices as
              well, but "save lockout" cannot be changed from its
              default value of zero.  Hence, local devices cannot
              be locked out from save requests.

       ssaavvee lloocckkoouutt                (read/write, hidden, no cre-
       ate)
              This attribute describes how many minutes a storage
              node will be locked  from  receiving  save  assign-
              ments,  after it reaches ssaavvee mmoouunntt ttiimmeeoouutt minutes
              during a save mount request.  A value of zero means



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        9





NSR_DEVICE(5)                                       NSR_DEVICE(5)


              that  the  node will not be locked.  This attribute
              cannot be changed for local devices.

EEXXAAMMPPLLEE
       A complete example follows:


                            type:  NSR device;
                            name:  /dev/nrst8;
                         message:  writing, done
                     volume name:  mars.017;
                    media family:  tape;
                      media type:  8mm 5GB;
                         enabled:  Yes;
                   write enabled:  Yes;
                       read only:  No;
                 target sessions:  4;
                    volume label:  mars.017;
         volume default capacity:  ;
         volume current capacity:  5000 MB;
               volume expiration:  "Thu Sep 21 17:23:37 1996";
                     volume pool:  Default;
                    volume flags:  ;
                volume operation:  ;
               volume write time:  ;
               volume block size:  32 KB;
                       volume id:  32449;
                        accesses:  199;
                   access weight:  1;
              consecutive errors:  0;
          max consecutive errors:  20;
                   operation arg:  ;
                  volume message:  ;
                   NSR operation:  ;
                      minor mode:  idle;
                  jukebox device:  Yes;
                      statistics:  elapsed = 257572, errors = 0, last rate = 397,
                                   max clients = 3, file marks = 22, rewinds = 4,
                                   files skipped = 1976, records skipped = 0,
                                   current file = 2389, current record = 162,
                                   seek files = 0, seek records = 0,
                                   estimated kb = 0, amount kb = 6273,
                                   file amount kb = 6273, sessions = 1;
               cleaning required:  No;
               cleaning interval:  2 weeks;
               date last cleaned:  "Tue Apr 11 15:10:32 1995";
           auto media management:  No;
         unlabeled volume loaded:  No;
                    logical name:  ;
                    logical type:  ;
                  logical family:  ;
           connection process id:  ;
              connection message:  ;
               connection status:  ;



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                       10





NSR_DEVICE(5)                                       NSR_DEVICE(5)


              save mount timeout:  30;
                    save lockout:  0;


FFIILLEESS
       //nnssrr//rreess//nnssrr..rreess  -  this  file  should  never  be  edited
       directly. Use nnssrrmmmm(8), nnssrraaddmmiinn(8) or nnwwaaddmmiinn(8) instead.

SSEEEE AALLSSOO
       nnssrr__ggeettddaattee(3), ccttiimmee(3), nnssrr__rreessoouurrccee(5), nnssrr__ppooooll(5),
       nnssrr__sscchheedduullee(5), nnssrr__sseerrvviiccee(5), nnssrr__ssttoorraaggee__nnooddee(5),
       nnssrr(8), nnssrrmmmmdd(8), nnssrrmmmm(8), nnssrraaddmmiinn(8), nnwwaaddmmiinn(8).













































NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                       11


