doc/html/AdminReference/auarf149.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf148.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf150.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <P>
  18 <H2><A NAME="HDRFS_LISTCELLS" HREF="auarf002.htm#ToC_163">fs listcells</A></H2>
  19 <A NAME="IDX4860"></A>
  20 <A NAME="IDX4861"></A>
  21 <A NAME="IDX4862"></A>
  22 <A NAME="IDX4863"></A>
  23 <A NAME="IDX4864"></A>
  24 <A NAME="IDX4865"></A>
  25 <A NAME="IDX4866"></A>
  26 <A NAME="IDX4867"></A>
  27 <A NAME="IDX4868"></A>
  28 <P><STRONG>Purpose</STRONG>
  29 <P>Displays the database server machines in each cell known to the Cache
  30 Manager
  31 <P><STRONG>Synopsis</STRONG>
  32 <PRE><B>fs listcells</B> [<B>-numeric</B>]  [<B>-help</B>]
  33
  34 <B>fs listc</B> [<B>-n</B>]  [<B>-h</B>]
  35 </PRE>
  36 <P><STRONG>Description</STRONG>
  37 <P>The <B>fs listcells</B> command formats and displays the list of the
  38 database server machines that the Cache Manager stores in kernel memory for
  39 its home cell and foreign cells.
  40 <P>At each reboot of the client machine, the Cache Manager copies the contents
  41 of <B>/usr/vice/etc/CellServDB</B> into kernel memory. To modify
  42 the list between reboots, use the <B>fs newcell</B> command.
  43 <P><STRONG>Options</STRONG>
  44 <DL>
  45 <P><DT><B>-numeric
  46 </B><DD>Displays each database server machine's IP address rather than
  47 hostname.
  48 <P><DT><B>-help
  49 </B><DD>Prints the online help for this command. All other valid options
  50 are ignored.
  51 </DL>
  52 <P><STRONG>Output</STRONG>
  53 <P>The output includes a line for each cell included in the Cache
  54 Manager's kernel memory list, in the following format:
  55 <PRE>   Cell <VAR>cell</VAR> on hosts <VAR>database server machines</VAR>
  56
  57 </PRE>
  58 <P>The Cache Manager stores IP addresses, but by default has them translated
  59 to hostnames before reporting them, by passing them to the cell's name
  60 service (such as the Domain Name Service or a local host table). The
  61 name service sometimes returns hostnames in uppercase letters, or an IP
  62 address if it cannot resolve a name.
  63 <P>Using the <B>-numeric</B> flag bypasses the translation to hostnames,
  64 which can result in significantly faster production of output. The
  65 output includes IP addresses only.
  66 <P><STRONG>Examples</STRONG>
  67 <P>The following example shows output for several cells as illustrations of
  68 the different formats for machine names:
  69 <PRE>   % <B>fs listcells</B>
  70    Cell abc.com on hosts fs1.abc.com fs2.abc.com fs3.abc.com
  71    Cell stateu.edu on hosts DB1.FS.STATEU.EDU
  72       DB2.FS.STATEU.EDU DB3.FS.STATEU.EDU
  73    Cell def.gov on hosts 138.255.0.2 sv3.def.gov
  74
  75 </PRE>
  76 <P><STRONG>Privilege Required</STRONG>
  77 <P>None
  78 <P><STRONG>Related Information</STRONG>
  79 <P><A HREF="auarf019.htm#HDRCLI_CSDB">CellServDB (client version)</A>
  80 <P><A HREF="auarf154.htm#HDRFS_NEWCELL">fs newcell</A>
  81 <P>
  82 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf148.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf150.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  83 <!-- Begin Footer Records  ========================================== -->
  84 <P><HR><B>
  85 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
  86 </B>
  87 <!-- End Footer Records  ============================================ -->
  88 <A NAME="Bot_Of_Page"></A>
  89 </BODY></HTML>