


NSR_NOTIFICATION(5)                           NSR_NOTIFICATION(5)


NNAAMMEE
       nsr_notification - NetWorker resource type ``NSR notifica-
       tion''

SSYYNNOOPPSSIISS
       ttyyppee:: NNSSRR nnoottiiffiiccaattiioonn

DDEESSCCRRIIPPTTIIOONN
       A resource of type NNSSRR nnoottiiffiiccaattiioonn is used for each  com-
       bination  of an event, priority, and action handled by the
       NetWorker notification system.  A  NetWorker  notification
       consists  of a single event type, a single priority, and a
       message.  The notification system posts  each  message  to
       the action of each NNSSRR nnoottiiffiiccaattiioonn resource (by executing
       the command listed in the  action,  with  the  message  on
       standard  input)  that includes that event type and prior-
       ity.  See nnssrr__rreessoouurrccee(5) for  more  information  on  Net-
       Worker  resources.  To edit the NSR notification resources
       type:
              nsradmin -c "type:NSR notification"
       or use the  nnwwaaddmmiinn(8)  GUI.   See  nnssrraaddmmiinn(8)  for  more
       information on using the NetWorker administration program.

AATTTTRRIIBBUUTTEESS
       The following attributes are defined for resource type NNSSRR
       nnoottiiffiiccaattiioonn.   The  information  in parentheses describes
       how the attribute values are accessed.  CCrreeaattee--oonnllyy  indi-
       cates  that  the value cannot be changed by an administra-
       tor, except when  the  resource  is  created.   RReeaadd//wwrriittee
       means  the  value can be changed at any time by authorized
       administrators.  CChhooiiccee lliisstt means that any number of val-
       ues  can  be  chosen  from  the given list.  SSiinnggllee ssttrriinngg
       means  that  only  a  single  value  is  allowed.   SSttaattiicc
       attributes change values rarely, if ever.  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 expert mode (--xx)  in
       nnwwaaddmmiinn(8).   For  example,  an  attribute marked ((ccrreeaattee--
       oonnllyy,, ssttaattiicc)) has a value which is set when the  attribute
       is   created   and   never  changes.   Several  additional
       attributes  (e.g.  administrator)  are   common   to   all
       resources, and are described in nnssrr__rreessoouurrccee(5).

       nnaammee           (create-only, static)
              This  attribute  holds the name of the notification
              resource.

       eevveenntt          (create-only, choice list, hidden)
              Each value is a class of events that  will  trigger
              the given notification.  More than one class may be
              selected.   Valid  values  are:  MMeeddiiaa  for  events
              related  to  the media multiplexor subsystem, SSaavvee--
              ggrroouupp for events generated by the ssaavveeggrroouupp(8) com-
              mand (usually the nightly automatic backups), IInnddeexx



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





NSR_NOTIFICATION(5)                           NSR_NOTIFICATION(5)


              for events related to the on-line file  index  sub-
              system,  RReeggiissttrraattiioonn  for events caused by changes
              in  the  product's  registration  status  (e.g.   a
              license  that  will  soon time out), and SSeerrvveerr for
              other NetWorker server events, such as  restarting.
              _E_x_a_m_p_l_e_: event: Media;

       pprriioorriittyy       (create-only, choice list, hidden)
              Each  value is a priority at which the notification
              will be triggered.  More than one priority  may  be
              selected.   The valid values in increasing priority
              order are IInnffoo -  supplies  information  about  the
              current  state of the server; NNoottiiccee - an important
              piece of information; WWaarrnniinngg - information about a
              non-fatal  error;  WWaaiittiinngg  - the server is waiting
              for an operator to perform a routine task, such  as
              mounting  a tape; CCrriittiiccaall - the server detected an
              error condition that should be fixed by a qualified
              operator;  AAlleerrtt  -  a  severe error condition that
              demands immediate attention; EEmmeerrggeennccyy -  a  condi-
              tion  that  may cause NetWorker to fail unless cor-
              rected immediately.
              _E_x_a_m_p_l_e_: priority: Notice;

       aaccttiioonn         (read/write, single string)
              The value is a command line to be executed when the
              given  event  occurs.  The command line is run (see
              ppooppeenn(3s)) with the event information connected  to
              standard  input.   Typical  actions  are to log the
              message with the ssyysslloogg(3) package, or  send  elec-
              tronic mail to a system operator.
              _E_x_a_m_p_l_e_:  action:  /usr/ucb/mail -s "savegroup com-
              pletion" root;

EEXXAAMMPPLLEE
       A complete example follows with  two  resources,  one  for
       mail and one using the syslog mechanism:

                       type: NSR notification;
                       name: savegroup completion;
              administrator: root;
                     action: \
               /usr/ucb/mail -s \"savegroup completion\" root;
                      event: Savegroup;
                   priority: Notice;

                       type: NSR notification;
                       name: log default;
              administrator: root;
                     action: /usr/ucb/logger -p daemon.notice -f -;
                      event: Media, Savegroup, Index, Server, Registration;
                   priority: Info, Notice, Warning, Waiting,
                             Critical, Alert, Emergency;




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





NSR_NOTIFICATION(5)                           NSR_NOTIFICATION(5)


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

SSEEEE AALLSSOO
       nnssrr__rreessoouurrccee(5), nnssrr__sseerrvviiccee(5), nnssrr__ddeevviiccee(5), nnssrr(8),
       nnssrrmmmm(8), ssyysslloogg..ccoonnff(5), ssyysslloogg(3), nnssrraaddmmiinn(8),
       nnssrrmmmmdd(8), nnwwaaddmmiinn(8).

















































NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3


