# @(#)98 1.2  src/ssa/usr/lib/methods/ssa_encl/README.ssaencl, ssacmds, ssa43N 9/2/99 10:42:52
#
# ORIGINS: 27
#
# (C) COPYRIGHT International Business Machines Corp. 1998
# All Rights Reserved
# Licensed Materials - Propery of IBM
#
# US Government Users Restricted Rights - Use, duplication or
# disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
#

README for ssaencl command line tool.

-----------------------------------------------------------------

Command Line Tools: ssaencl Command

Purpose

To allow the monitoring and changing of the status for SSA SES disk
enclosures (subsystems).

Syntax

To display enclosure component settings:

 ssaencl -l name   [-s]
                   [-v]
                   [-i]
                   [-b[card ...]]
                   [-t[threshold ...]]
                   [-a]
                   [-f[fan ...]]
                   [-d[drive_bay ...]]
                   [-p[PSU ...]]
                   [-o]
                   [-c]

To modify enclosure component settings:

 ssaencl -l name   [-I ID [-U]]
                   [-B mode | card=mode ...]
                   [-S {d[drive_bay ...] | b[card ...] | p[PSU ...] | r |
                   c | o }]
                   [-T threshold=value ...]

For help, type: ssaencl -? or ssaencl -h

Description

The ssaencl command can be used to observe the existing settings of an SSA
SES disk enclosure (subsystem), or to modify the settings of that
enclosure. The command can be used only to observe or modify settings; it
cannot be used to observe and modify settings at the same time. When the
command displays enclosure settings, it displays them in tables that the
user can read easily. If the -s flag is specified, however, the command
displays the settings in colon-separated format, as used by commands such
as the SMIT commands.

Flags

 -l name             name Specifies the name of an SSA SES enclosure or
                     pdisk. If a pdisk name is used, that pdisk must be in
                     an SSA SES enclosure.

 -s                  Displays output in colon-separated format.

 -v                  Displays also VPD information.

 -i                  Displays the enclosure identifier (as shown in the
                     operator panel, if present).

 -b [card]           Displays the status of the bypass cards. If no
                     parameters are given, the status for all the bypass
                     cards is displayed. Valid values for the [card]
                     parameter are: 1, 4, 5, 8, 9, 12, 13, 16.

 -t [threshold]      Displays all the temperature thresholds, or only the
                     specified temperature thresholds. The valid values for
                     the [threshold] parameter are:

                      lowarn  The low-temperature warning threshold.
                      locrit  The low-temperature critical threshold.
                      hiwarn  The high-temperature warning threshold.
                      hicrit  The high-temperature critical threshold.

 -a                  Displays the ambient temperature of the enclosure and
                     temperature threshold statuses.

 -f [fan]            Displays the status of all the fans, or of only the
                     specified fans. Valid values for the [fan] parameter
                     are: 1, 2, 3, and so on.

 -d [drive_bay]      Displays the status of all the disk drive bays (slots),
                     or of only the specified disk drive bays. Valid values
                     for the [drive_bay] parameter are: 1, 2, 3, and so on.

 -p [PSU]            Displays the status of all the power supply assemblies,
                     or of only the specified power supply assemblies. Valid
                     values for the [PSU] parameter are 1, 2.

 -o                  Displays the status of the operator panel.

 -c                  Displays the status of the controller card.

 -I ID[-U]           Modifies the enclosure ID. The ID must be a
                     four-character alphanumeric string. The optional -U
                     flag causes the object data manager (ODM) to be updated
                     to show the change.

 -B mode             Modifies all bypass cards to the given mode.

 -B card=mode        Modifies the specified bypass cards to be in the given
                     modes. The valid values for the mode parameter are:

                      * Automatic
                      * Bypass
                      * Inline
                      * Open

                     Valid values for the card parameter are: 1, 4, 5, 8, 9,
                     12, 13, 16.

 -S                  Resets the "exchanged" flag of the selected FRU.

                      d[drive_bay ...]  Resets the flag for the selected drive
                                        bay. Valid values for drive_bay are 1,
                                        2, 3, and so on.
                      b[card ...]       Resets the flag for the bypass card.
                                        Valid values for card are 1, 4, 5, 8,
                                        9, 12, 13, 16.
                      p[PSU ...]        Resets the flag for the selected PSU.
                                        Valid values for PSU are 1, 2.
                      r                 Resets the flag for the RPO.
                      c                 Resets the flag for the controller
                                        card.
                      o                 Resets the flag for the operator
                                        panel.

 -T threshold=value  Modifies the specified temperature thresholds to the
                     given values. The valid values for the [threshold]
                     parameter are:

                       lowarn  The low-temperature warning threshold.
                       hiwarn  The high-temperature warning threshold.

                     The value parameter is a temperature in degrees C.

Examples

   * To display the status of all bypass cards on enclosure0, give the
     command:

     ssaencl -l enclosure0 -b

   * To display the status and VPD of the controller card in enclosure0,
     give the command:

     ssaencl -l enclosure0 -c -v

   * To modify the ID for enclosure0 to R2D2, give the command:

     ssaencl -l enclosure0 -I R2D2

   * To display the contents of disk bay (slot) 8 in enclosure0, give the
     command:

     ssaencl -l enclosure0 -d 8