NSR_NOTIFICATION(5)        Legato NetWorker 4.1.1        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.  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 NSR notification resource (by executing
       the command listed in the action, with the message on standard input)
       that includes that event type and priority.  See nsrresource(5) for
       more information on NetWorker resources.  To edit the NSR
       notification resources type:
              nsradmin -c "type:NSR notification"
       or use the networker(8) GUI.  See nsradmin(8) for more information on
       using the NetWorker administration program.

ATTRIBUTES
       The following attributes are defined for resource type NSR
       notification.  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.  Static attributes change values
       rarely, if ever.  Hidden 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 nsradmin(8) or expert mode (-x) in
       networker(8).  For example, an attribute marked (create-only, static)
       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 nsrresource(5).

       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.  Valid
              values are: Media for events related to the media multiplexor
              subsystem, Savegroup for events generated by the savegroup(8)
              command (usually the nightly automatic backups), Index for
              events related to the on-line file index subsystem,
              Registration for events caused by changes in the product's
              registration status (e.g.  a license that will soon time out),
              and Server for other NetWorker server events, such as
              restarting.
              Example: event: Media;





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





NSR_NOTIFICATION(5)        Legato NetWorker 4.1.1        NSR_NOTIFICATION(5)


       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 valid
              values in increasing priority order 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 perform 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)
              The value is a command line to be executed when the given
              event occurs.  The command line is run (see popen(3s)) with
              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, Registration;
                   priority: Info, Notice, Warning, Waiting,
                             Critical, Alert, Emergency;

FILES
       /nsr/res/nsr.res - this file should never be edited directly. Use
       nsradmin(8) instead.

SEE ALSO
       nsrresource(5), nsrservice(5), nsrdevice(5), nsr(8), nsrmm(8),
       syslog.conf(5), syslog(3), nsradmin(8), nsrmmd(8).







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