NSR_NOTIFICATION(5)         Legato NetWorker 3.0         NSR_NOTIFICATION(5)


NAME
       NSR notification - NetWorker resource type ``NSR notification''

SYNOPSIS
       type: NSR notification

DESCRIPTION
       A resource of type NSR notification is used for each combination of
       an event, priority, and action handled by the NetWorker notification
       system.  See nsrresource(5) for more information on NetWorker
       resources.  To edit the NSR notification resources type:
              nsradmin -c "type:NSR notification"
       See nsradmin(8) for more information on using the NetWorker adminis­
       tration program.

ATTRIBUTES
       The following attributes are defined for resource type NSR notifica­
       tion.  The information in parentheses describes how the attribute
       values are accessed.  Create-only indicates that the value cannot be
       changed by an administrator, except when the resource is created.
       Read/write means the value can be changed at any time by authorized
       administrators.  Choice list means that any number of values can be
       chosen from the given list.  Single string means that only a single
       value is allowed.

       name      (create-only, static)
              This attribute holds the name of the notification resource.
              event          (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.  Legal values are: Media
              for events related to the media multiplexor subsystem, Save­
              group for events generated by the savegroup(8) command (usu­
              ally the nightly automatic backups), Index for events related
              to the on-line file index subsystem, and Server for other Net­
              Worker server events, such as restarting.
              Example: event: Media;

       priority       (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 legal
              values in increasing priority are: Info - supplies information
              about the current state of the server; Notice - an important
              piece of information; Warning - information about a non-fatal
              error; Waiting - the server is waiting for an operator to per­
              form a routine task, such as mounting a tape; Critical - the
              server detected an error condition that should be fixed by a
              qualified operator; Alert - a severe error condition that
              demands immediate attention; Emergency - a condition that may
              cause NetWorker to fail unless corrected immediately.
              Example: priority: Notice;

       action         (read/write, single string)
              Each value is a command line to be executed when the given
              event occurs.  The command line is run (see popen(3s)) with



Licensed material--property of copyright holder(s)                         1

NSR_NOTIFICATION(5)         Legato NetWorker 3.0         NSR_NOTIFICATION(5)


              the event information connected to standard input.  Typical
              actions are to log the message with the syslog(3) package, or
              send electronic mail to a system operator.
              Example: action: /usr/ucb/mail -s "savegroup completion" root;

EXAMPLE
       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;
                   priority: Info, Notice, Warning, Waiting,
                             Critical, Alert, Emergency;

FILES
       /etc/nsr.res - this file should never be edited directly. Use nsrad­
       min(8) instead.

SEE ALSO
       nsrresource(5), nsrservice(5), nsrdevice(5), nsr(8), mm(8), sys­
       log.conf(5), syslog(3), nsradmin(8), nsrmmd(8).


























Licensed material--property of copyright holder(s)                         2