site, sitechar, sitelocal, sitenam, sitenum, ptn(1,C)                 site(1,C)



-------------------------------------------------------------------------------
site, sitechar, sitelocal, sitename, sitenum, ptn



PURPOSE

Display information about cluster sites.

SYNTAX


one of       +----------------+
site --------| +------------+ |---|
sitechar     +-| sitenumber |-+
sitelocal     ^| sitename   ||
sitename      || -a         ||
sitenum       || -pcputype  ||
ptn           || -t         ||
              || -n         ||
              || -c         ||
              || -l         ||
              || -#         ||
              || -f         ||
              || -m         ||
              |+------------+|
              +--------------+


Warning: See restrictions, Chapter 18, AIX Programming Tools and Interfaces.

DESCRIPTION

The /etc/site command is used to report on information about sites within the
cluster.  This information is obtained from the cluster site data base file,
/etc/site.  The command line options and arguments control which sites are
reported and what information about them is displayed.

OPTIONS

The command line arguments and options for site are of two major types.  The
first type are those that select the specific sites about which information is
printed.  If none of these options are specified, the cluster site where site
is running is selected.

sitename  Displays information about the specific cluster site whose name is
          sitename.  The sitename argument is not prefixed by the - symbol.

sitenumber
          Displays information about the specific cluster site whose site
          number is sitenumber.  The sitenumber argument is not prefixed by the
          - symbol.



Processed 11/8/90    site, sitechar, sitelocal, sitename, sitenum, ptn(1,C)   1

site, sitechar, sitelocal, sitenam, sitenum, ptn(1,C)                 site(1,C)




-a        Displays information about all cluster sites.

-pcputype Displays information on all sites of a particular cpu type.  This
          option may appear more than once on the command line with different
          cpu type arguments.

-t        Displays information of all sites in the cluster that are currently
          active.  The -t option overrides all sitename and sitenumber
          arguments, as well as the -a option.  If used with the -p option,
          then information is displayed for all sites in the cluster of the
          specified cpu types that are currently active.

The second type of arguments select what information from the cluster site data
base is displayed.  If more than one of these options appear on the command
line, the rightmost one is used.  If none of these options are specified, the
cluster site name is displayed.

-n     Display the name of the cluster site of each site selected.

-c     Display the first character of the name of each cluster site selected.

-l     Display the name of the <LOCAL> file system of each cluster site
       selected.

-#     Display the cluster site number of each cluster site selected.

-f     Display all information from the site file data base for each cluster
       site selected.

-m     Display the cpu type of each cluster site selected, in addition to
       either the cluster site name, the name of the <LOCAL> filesystem of the
       cluster site, the number of the cluster site, or the first character of
       the name of the cluster site, as selected by other options.  If
       specified with the -f option, the -m option has no effect.

ALTERNATE INVOCATIONS

The site command can be invoked using alternate names to produce different
outputs or output formats.

   sitechar is equivalent to site -c

   sitelocal is equivalent to site -l

   sitenum is equivalent to site -#

   sitename is equivalent to site -n

   ptn is equivalent to site -t





Processed 11/8/90    site, sitechar, sitelocal, sitename, sitenum, ptn(1,C)   2

site, sitechar, sitelocal, sitenam, sitenum, ptn(1,C)                 site(1,C)



EXAMPLES

  1. To display the names of all cluster sites

    site -a

    This lists the name of each cluster site, regardless whether it is
    currently active in the cluster.

  2. To display the names of all the cluster sites that are currently active

    site -t (or ptn)

  3. To list all currently active cluster sites that are AIX PS/2 CPU sites

    site -t -pi386

  4. To list all information about cluster site number 6

    site -f 6

    If there is no cluster site number 6 in the site file, an error message is
    displayed.

FILES

/etc/site

RELATED INFORMATION

See the site file format in the AIX Operating System Technical Reference.
























Processed 11/8/90    site, sitechar, sitelocal, sitename, sitenum, ptn(1,C)   3