repair(8)                                                         repair(8)

NAME
     repair - provide error information in the case of repairs

SYNOPSIS
     repair [-o] -n component [-p physicalID] [-l logicaladdress]
            [-s location] -a author [-c customer] [-A orderno.]
            [-L LED/LCEinfo] -t "textornameoftextfile"
            [-O outputdevice] [-h]

DESCRIPTION
     The repair command prepares information that is already available in
     the system for the purpose of repairs and then provides this informa-
     tion in compressed form in $DUMPDIR/name [see dumpsave(4)].

     The repair command invokes system and component-dependent shell
     scripts which have been created by the system administrator in
     /etc/default/repair/repair.component. The name of the system-dependent
     script is defined with /etc/default/repair/repair.default, whereas the
     component script is a composite name
     (/etc/default/repair/repair.component, see -n option). Examples of
     names of component-dependent scripts include:

          /etc/default/repair/repair.CPM-168400
          /etc/default/repair/repair.MBP-29902
          /etc/default/repair/repair.DISK

     The system administrator can create or edit these shell scripts.

     If there is no component-specific shell script, the system-dependent
     shell script /etc/default/repair/repair.default is invoked.

     When this shell script is invoked, the directory name ($1) where the
     files are to be stored is specified with the repair command. All out-
     put from the script must be piped to files ($1/filename). Output to
     stderr/stdout is sent to /dev/null.

     These are some of the entries that the shell scripts can contain:

          # Invoking system commands:
          autoconf            > $1/autoconf
          showconf -l         > $1/showconf
          spbuslog            > $1/spbuslog

          # Outputting system tables:
          cat /etc/device.tab > $1/device.tab
          cat /etc/dktab      > $1/dktab
          zcat /etc/osm*.Z    > $1/osm

     The options allow you to submit information such as component name,
     physical Id, logical address, location in system, author, order
     number, customer name, LED display, and comment.




Page 1                       Reliant UNIX 5.44                Printed 11/98

repair(8)                                                         repair(8)

     Dumps that have already been generated can only be overwritten follow-
     ing interaction (see -o option).

     The return value is the directory name of the generated partial dump.

OPTIONS
     -o   No interaction if the dump is available; the old version is
          overwritten.

     -n component
          Name of defective component.

     -p physicalID
          Serial number of defective component.

     -l logicaladddress
          Logical address of component.

     -s location
          Location in system.

     -a author
          Name of the author of the messages.

     -c customer
          Name of customer.

     -A orderno.
          Order number.

     -L LED/LCEinfo
          Status of LED/LCE display.

     -t "textornameoftextfile"
          Short error description or name of text file.

     -O outputdevice
          Writes output to outputdevice (e.g. /dev/ios0/rsfdisk001ft).

     -h   Displays syntax of repair.

EXAMPLES
     Creating the repair information under $DUMPDIR:

          repair -n disk47 -a author -t "Bad SCSI disks"

FILES
     /etc/default/dumpsave

     /etc/default/repair/repair.default

     /etc/default/repair/repair.component


Page 2                       Reliant UNIX 5.44                Printed 11/98

repair(8)                                                         repair(8)

NOTES
     The generation, management, and analysis of repair information is also
     supported from the diagnostic menu.

SEE ALSO
     dumpsave(4).
















































Page 3                       Reliant UNIX 5.44                Printed 11/98