bkoper(1M)        MISC. REFERENCE MANUAL PAGES         bkoper(1M)



NAME
     bkoper - interact with backup operations  to  service  media
     insertion prompts

SYNOPSIS
     bkoper [-u users]

DESCRIPTION
     Backup operations may require an operator  to  insert  media
     and  to  confirm  proper  volume labels.  The bkoper command
     provides a mailx-like interface for these operator  interac-
     tions.   It  begins  by  printing  a  list of headers.  Each
     header describes a backup operation  requiring  interaction,
     the  device requiring attention including the media type and
     label of the volume to be inserted (see EXAMPLE).  The  sys-
     tem  displays  prompts  and  the operator issues commands to
     resolve the backup  operation.   Typing  a  carriage  return
     invokes  the  current  header.  If no headers have been ser-
     viced, the current header is the first header on  the  list.
     If  a  header  has  been  selected and serviced, the current
     header is the next one following.  bkoper  may  be  executed
     only  by  a  user with superuser privilege.  By default, the
     operator may interact only with backup operations that  were
     started  by  the  same  user  ID . If the -u users option is
     given, the operator interacts only  with  backup  operations
     started by the specified user(s).

  Commands
     !shell-command
               Escapes to the shell.  The remainder of  the  line
               after  the ! is sent to the UNIX system shell (sh)
               to be interpreted as a command.

     =         Prints the current backup operation number.

     ?         Prints this summary of commands.

     [p|t] [n] Both the p and t options operate in the same  way.
               Either option will interact with the backup opera-
               tion described by the n'th header.  n defaults  to
               the current header number.

     h         Prints the list of backup operations.

     q         Quits from bkoper.

DIAGNOSTICS
     The exit codes for bkoper are the following:

     0 = successful completion of the task
     1 = one or more parameters to bkoper are invalid.
     2 = an error has occurred which caused bkoper to fail to



          Last change: System Administration Utilities          1

bkoper(1M)        MISC. REFERENCE MANUAL PAGES         bkoper(1M)



           complete all portions of its task.

EXAMPLE
     A sample header is shown  below.   Items  appearing  in  the
     header  are  listed  in the following order:  header number,
     job-ID, tag, originating device, destination group, destina-
     tion  device, destination volume labels.  [See bkreg(1M) for
     descriptions of items.]  Not every  header  contains  values
     for  all  these fields; if a destination group is not speci-
     fied in /etc/bkup/bkreg.tab, then no value for ``destination
     group'' appears in the header.
       1 back-111 usrsun /dev/dsk/c1d0s1  disk /dev/dsk/c2d1s9 usrsave
       2 back-112 fs2daily /dev/dsk/c1d0s8 ctape /dev/ctape/c4d0s2 -
Backup headers are numbered on the basis of arrival;  the  oldest
header has the lowest number.  If the destination device does not
have a volume label, a dash is displayed in the header.

SEE ALSO
     bkreg(1M), bkstatus(1M), getvol(1M), mailx(1).




































          Last change: System Administration Utilities          2