'\"macro stdmacro
.if n .pH g1a.rsnotify @(#)rsnotify	40.11 of 1/17/90
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} rsnotify 1M "System Administration Utilities" "\&"
.if \nX=1 .ds x} rsnotify 1M "System Administration Utilities"
.if \nX=2 .ds x} rsnotify 1M "" "\&"
.if \nX=3 .ds x} rsnotify "" "" "\&"
.TH \*(x}
.SH NAME
\f4rsnotify\f1 \- display or modify 
the information identifying the individual
in charge of restore requests
.SH SYNOPSIS
\f4rsnotify \f1[\f4\-u \f2user\f1]
.SH DESCRIPTION
\f4rsnotify\fP
without options
displays the name of the person who is to receive
\f4mail\f1(1M) notifications whenever restore requests
require operator intervention.
The display includes the date the individual was assigned.
.PP
\f4rsnotify\fP
may only be executed by a user with superuser privileges.
.SS Options
.PD 0
.TP
\f4\-u\f2 user\f1
assigns 
.I user
to be the one to receive restore notifications.
\f2user\f1 is the user's login \s-1ID\s+1.
If \f2user\f1 is null, \f4rsnotify\fP mails 
the notices to root.
\f2user\f1 must be in the \f4passwd\f1 file.
.SH DIAGNOSTICS 
The exit codes for \f4rsnotify\fP are the following:
.PP
\f40\f1 = the task completed successfully
.br
\f41\f1 = one or more parameters to \f4rsnotify\fP are invalid
.br
\f42\f1 = an error has occurred, causing \f4rsnotify\fP to fail to
      complete all portions of its task
.SH EXAMPLES
Example 1:
.PP
.in 1.0i
\f4rsnotify \-u oper3\fP
.in 0
.PP
assigns the individual with login \s-1ID\s+1 \f4oper3\f1 as
the one to be notified when a restore request
needing operator intervention is initiated.
.SH FILES
.TP 1.65i
\f4/etc/bkup/rsnotify.tab\f1
provides the 
electronic mail address
of the operator to be notified whenever restore requests
require operator intervention
.TP
\f4/etc/bkup/rsstatus.tab\f1
tracks the status of all restore
requests from users
.SH SEE ALSO
\f4getvol\fP(1M),
\f4restore\fP(1M),
\f4rsstatus\fP(1M),
\f4urestore\fP(1M).
