dsstate

PURPOSE

     Sets the state of the Distributed Services kernel logic.

SYNOPSIS
     dsstate [ [ -c ] [ s e ] ] [ [ -a ] [ b a ] ] [ [ -s ] [ s e ] ]
             [ [ -s ] [ b a ] ] [ [ -k [ -p number ] ]

DESCRIPTION

     The dsstate command changes  the state of the Distributed
     Services  kernel logic,  including the  number of  kernel
     processes  allocated  for Distributed  Services,  whether
     incoming and  outgoing remote  requests are  allowed, and
     where temporary storage takes place.  Only members of the
     system group or users  operating with superuser authority
     can use  dsstate to change  the state of  the Distributed
     Services kernel  logic (see  "su").  Other users  can use
     dsstate with no flags to write to the standard output the
     current state of the Distributed Services kernel logic.

FLAGS

     -c s      Starts client sync, which  forces all files for
               which  this node  is the  client to  be written
               directly  to  the  server,  preventing  caching
               (temporary storage) of the file contents at the
               client.  Starting client sync often affects the
               performance  of file  operations,  and is  used
               primarily for certain  system startup and shut-
               down routines.
     -c e      Ends  client sync  and allows  some data  to be
               stored at the local node.
     -a b      Breaks  all connections  with remote  nodes and
               blocks new requests for remote file services.
     -a a      Allows  requests  from  this  client  node  for
               remote file services.
     -s s      Starts server sync, which  forces all files for
               which  this node  is the  server to  be written
               directly  to  the  server,  preventing  caching
               (temporary storage) of the file contents at the
               client  node.    Starting  server   sync  often
               affects the performance of file operations, and
               is  used primarily  for certain  system startup
               and shutdown routines.
     -s e      Ends  server sync  and allows  some data  to be
               stored at the client node.
     -s b      Blocks  all  requests  for file  services  from
               other  nodes, including  both new  requests and
               requests for files already in use.
     -s a      Allows this server to  accept requests for file
               services from other nodes.

     -k        Starts  the Distributed  Services kernel  proc-
               esses.
     -p number Sets the number  of active Distributed Services
               kernel  processes  to  number.   If  number  is
               greater  than the  number  of kernel  processes
               allocated for Distributed  Services, then those
               that are available are activated.  If number is
               0  or a  negative value,  the number  of kernel
               processes is not changed.

               By adjusting  the number of  active Distributed
               Services  kernel processes,  the rate  at which
               services are  provided to  remote nodes  can be
               varied.  Lowering the number of active Distrib-
               uted  Services kernel  processes lowers  remote
               use  of  this  node's processor,  leaving  more
               system resources for local use.

               Note:   The Distributed  Services kernel  proc-
               esses must have been started  with a -k flag on
               either  this  dsstate  command  or  an  earlier
               dsstate command.

RELATED INFORMATION

     The dsstate system call in AIX Operating System Technical
     Reference.

     "Using Distributed  Services" in  Managing the  AIX Oper-
     ating System.