


NSR_ARCHIVE_REQUEST(5)                     NSR_ARCHIVE_REQUEST(5)


NNAAMMEE
       nsr_archive_request   -   NetWorker  resource  type  ``NSR
       archive request''

SSYYNNOOPPSSIISS
       ttyyppee:: NNSSRR aarrcchhiivvee rreeqquueesstt

DDEESSCCRRIIPPTTIIOONN
       Each NSR archive request is described by a single resource
       of  type  NNSSRR  aarrcchhiivvee  rreeqquueesstt (see nnssrr__rreessoouurrccee(5)).  To
       edit the NSR archive request  resources  for  a  NetWorker
       server type:

              nsradmin -c "type:NSR archive request"

       See  the  nnssrraaddmmiinn(8)  manual page for more information on
       using the NetWorker administration program.   The  archive
       request  resource  may  also  be  edited using the command
       nnwwaaddmmiinn(8).

       This resource allows administrators to set up  an  archive
       to  occur later or to set up frequent archives of a set of
       data.  The administrator can run an archive on a specified
       client  within the next 24 hours.  The archive is executed
       via the nnssrraalliisstt(8)) command.

AATTTTRRIIBBUUTTEESS
       The following attributes are defined for resource type NNSSRR
       aarrcchhiivvee rreeqquueesstt.  The information in parentheses describes
       how the attribute values are  accessed.   RReeaadd--oonnllyy  indi-
       cates  that  the value cannot be changed by an administra-
       tor.  RReeaadd//wwrriittee means the value can be  set  as  well  as
       read.  HHiiddddeenn means it is an attribute of interest only to
       programs or experts, and these attributes can only be seen
       when  the  hidden option is turned on in nnssrraaddmmiinn(8) or by
       selecting the details Menu Item in the  View  Menu  for  a
       particular  window in nnwwaaddmmiinn(8).  DDyynnaammiicc attributes have
       values which change rapidly.  EEnnccrryypptteedd attributes contain
       data  that  is  not  displayed  in its original form.  The
       assumption is that the data is  sensitive  in  nature  and
       needs to be protected from accidental disclosure.  Several
       additional attributes (e.g. administrator) are  common  to
       all resources, and are described in nnssrr__rreessoouurrccee(5).

       nnaammee      (read/write)
              This attribute specifies the name of this NetWorker
              archive request.
              _E_x_a_m_p_l_e_: name: Product Source Tree;

       aannnnoottaattiioonn     (read/write)
              This attribute contains the annotation text associ-
              ated  with the archive save set generated from this
              archive request.
              _E_x_a_m_p_l_e_: annotation: Product Release 4.1;



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





NSR_ARCHIVE_REQUEST(5)                     NSR_ARCHIVE_REQUEST(5)


       ssttaattuuss         (read/write, choice)
              This attribute determines  if  an  archive  request
              should  be  run.   No  value  implies  the  archive
              request is  not  scheduled.   Selecting  _s_t_a_r_t  _n_o_w
              causes  the  archive request to be run immediately.
              Selecting _s_t_a_r_t _l_a_t_e_r causes the archive request to
              be  run  at  the  time  specified by the ssttaarrtt ttiimmee
              attribute (see below).
              _E_x_a_m_p_l_e_: status:;

       ssttaarrtt ttiimmee     (read/write)
              This attribute determines when the archive  request
              will be run.  The ssttaattuuss attribute (see above) must
              be set to _s_t_a_r_t _l_a_t_e_r for the archive request to be
              scheduled.  The 24 hour clock format is "hours:min-
              utes".
              _E_x_a_m_p_l_e_: start time: 3:33;

       ccoommpplleettiioonn ttiimmee     (read/write, hidden)
              This attribute indicates when the  archive  request
              completed.   The  format  is "day-of-week month day
              hours:minutes:seconds year".
              _E_x_a_m_p_l_e_: "Thu Oct 22 17:00:37 1994";;

       cclliieenntt         (read/write)
              This attribute  indicates  what  NetWorker  archive
              client the archive request is to be executed on.
              _E_x_a_m_p_l_e_: client: neptune;

       ssaavvee sseett  (read/write)
              The  _s_a_v_e  _s_e_t attribute lists the path names to be
              archived on the archive client.  The  names  should
              be separated by a comma and a space (", ").
              _E_x_a_m_p_l_e_: save set: /product/src, /accounting/db;

       ddiirreeccttiivvee (read/write)
              This  attribute specifies the directive to use when
              running the archive.  The default value is  nothing
              selected.   The  valid  choices  for  the directive
              resource are names of the  currently  defined  `NSR
              directive' resources, see nnssrr__ddiirreeccttiivvee(5).
              _E_x_a_m_p_l_e_: directive: Default with compression;

       aarrcchhiivvee ppooooll   (read/write)
              This  attribute  can be used to override the normal
              media pool selection applied to  the  archive  save
              set  generated from the archive request.  Selecting
              a pool will direct the archive to that media  pool.
              _E_x_a_m_p_l_e_: archive pool: Archive;

       vveerriiffyy         (read/write, choice)
              This attribute indicates the archive request should
              verify the archive.  See  nnssrr__aarrcchhiivvee(5)  for  more
              information on archiving.  Selecting the _Y_e_s choice



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





NSR_ARCHIVE_REQUEST(5)                     NSR_ARCHIVE_REQUEST(5)


              causes the verification to occur.  Selecting the _N_o
              choice  will  not  cause  any verification.  If the
              user also requests that the  archive  save  set  be
              cloned, the verification is done on the clone since
              the cloning operation will have verified the origi-
              nal archive save set.
              _E_x_a_m_p_l_e_: verify: Yes;

       vveerriiffiieedd  (read/write, hidden)
              This attribute is unused.
              _E_x_a_m_p_l_e_: verified: No;

       cclloonnee          (read/write)
              This  attribute  controls  whether the archive save
              set generated by  the  archive  request  is  to  be
              cloned.   A  value  of _Y_e_s implies the archive save
              set should be cloned.  A value of _N_o does not imply
              cloning.
              _E_x_a_m_p_l_e_: clone: No;

       cclloonneedd         (read/write, hidden)
              This attribute is unsed.
              _E_x_a_m_p_l_e_: cloned: No;

       aarrcchhiivvee cclloonnee ppooooll  (read/write)
              This  attribute  indicates  the archive clone media
              pool the archive request should  use  when  cloning
              the  archive  save  set  generated  by this archive
              request.
              _E_x_a_m_p_l_e_: archive clone pool: Archive clone;

       ggrroooommiinngg  (read/write)
              This attribute indicates any grooming actions to be
              taken  once  the  archive save set generated by the
              archive request has  been  created,  verified,  and
              cloned.   A  value  of  _n_o_n_e  implies no action.  A
              value of _r_e_m_o_v_e implies the files  and  directories
              specified in the ssaavvee sseett attribute will be removed
              via the rrmmddiirr(2) and uunnlliinnkk(2) system calls.
              _E_x_a_m_p_l_e_: grooming: none;

       aarrcchhiivvee ccoommpplleettiioonn  (read/write)
              A notification action to be executed to send status
              of the archive request to.
              _E_x_a_m_p_l_e_:   archive   completion:  /usr/ucb/mail  -s
              "Product Archive" systemadmin;

       lloogg       (read/write, hidden)
              This attribute contains any information  pertaining
              to the execution of the nnssrraalliisstt command.
              _E_x_a_m_p_l_e_: log:;

EEXXAAMMPPLLEE
       Note:  the hidden options are not shown in this example.



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3





NSR_ARCHIVE_REQUEST(5)                     NSR_ARCHIVE_REQUEST(5)


       A resource to define an archive request, called Product:


                       type:  NSR archive request;
                       name:  Product Source;
                 annotation:  Product Release 3.0;
                     status:  Start later;
                 start time:  "2:00";
                     client:  space;
                   save set:  /product/source;
                  directive:  Default with compression;
               archive pool:  Archive;
                     verify:  Yes;
                      clone:  Yes;
         archive clone pool:  Archive Clone;
                   grooming:  none;
         archive completion:  mail -s Product Source Archive productteam;


SSEEEE AALLSSOO
       nnssrr(5), nnssrr__ddiirreeccttiivvee(5), nnssrr__rreessoouurrccee(5), nnssrraaddmmiinn(8),
       nnwwaaddmmiinn(8), rrmmddiirr(2), uunnlliinnkk(2).



































NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        4


