# empsvadm

       EMPSVADM(1)                                           EMPSVADM(1)

       NAME
           empsvadm  -  provides  server administrative functions for
           Empress  Servers  (including  Empress  Replication  Master
           Server and Empress ODBC Server).

       SYNOPSIS
           empsvadm -help

           empsvadm SERVER_NAME COMMAND

       DESCRIPTION
           empsvadm  is the Empress Server Administration Utility. It
           provides administrative  functions  for  Empress  Servers.
           Empress  Servers are Empress Replication Master Server and
           Empress ODBC Server.

           Components of an Empress Server are a Spooler, and  Admin-
           istration  Server and one or more Service Servers. Spooler
           spawns  and  controls  other  components.   Administrative
           requests are handled by the Administration Server and ser-
           vice requests are passed by to one of the Service Servers.

           Operation  of  empsvadm  are  starting  an Empress Server,
           closing the connection of a client of an  Empress  Server,
           getting  information on the running Empress Server and its
           components, resetting maximum and minimum number  of  Ser-
           vice  Servers,  stopping  an  Empress Server, regenerating
           components of an Empress Server, interrupting  an  Empress
           Server, and changing the login password of the administra-
           tor and users of an Empress Server.

           empsvadm utility uses configuration attributes set in Net-
           work  Configuration Files. Network Configuration Files are
           either of the Network Server Configuration File pointed by
           value  of  environment  variable MSNETSERVERCONFIGFILE, or
           Network Type Configuration File pointed by value of  envi-
           ronment  variable  MSNETTYPECONFIGFILE.  Network Type Con-
           figuration File contains Network Type Configuration Blocks
           for  each type of Empress Server. Each configuration block
           contains  configuration  attributes   describing   general
           information  about  Empress  Servers. The value of most of
           these configuration attributes can be overwritten with the
           value  of  the same attribute in Network Server Configura-
           tion File, except for TYPE configuration  attribute  which
           is  the  identifier of a Network Type Configuration Block.
           The default setting for Network Configuration files are in
           $EMPRESSPATH/config/netserver.cfg   and  $EMPRESSPATH/con-
           fig/nettype.cfg

           The SERVER_NAME must be a valid Empress Server as named by
           NAME  configuration attribute and described in the Network
           Server Configuration File.

           Some of the functions  of  empsvadm  explained  below  are
           indicated   as   "Administrative".  This  means  that  the
           requestor of the function must be indicated by the of con-
           figuration attribute "ADMINISTRATOR" in network configura-
           tion files.

       COMMAND

           start [START_OPTION]
                  (Administrative)  Starts  a  new Empress server.  A
                  logfile to keep the history of the operations  per-
                  formed  by  a server and requests being made to the
                  server    will    be    created     with  the  name
                  SERVER_NAME.log   if  not specified  differently by
                  LOGFILE configuration attribute of Network Configu-
                  ration  File.  For  Replication  Master  Server and
                  Empress Connectivity (ODBC) Server, START_OPTION is
                  [-f  SERVER_START_CONFIG_FILE].   SERVER_START_CON-
                  FIG_FILE is a configuration file that specifies the
                  tables that will be handled by SERVER_NAME.

           close CLIENT_ID
                 (Administrative) Closes the client connection spec-
                  ified by CLIENT_ID.

           info   Provides information about the Empress Server. This
                  information  includes  type of the server, adminis-
                  tration port and service port numbers,  Server  IDs
                  assigned by Empress Server SERVER_NAME, Process IDs
                  assigned by Operating system,  number  of   clients
                  currently   being   serviced by each server.  Mini-
                  mum, Maximum and  currently   running   number   of
                  service  servers,   as  well as  information  about
                  all the active clients of each server   are   shown
                  by this command.

           servers MIN_SERVERS [MAX_SERVERS]
                  (Administrative)  Changes  the  minimum  number  of
                  service    servers    that should   be  started  by
                  SERVER_NAME. If  MIN_SERVERS  service servers   are
                  busy,  the  spooler  will spawn more services up to
                  MAX_SERVERS number.  The default for MAX_SERVERS is
                  MIN_SERVERS. The initial maximum and minimum number
                  of service servers are  in  Network   Configuration
                  Files,    specified   by   configuration attributes
                  NUM_SERVERS_MIN and NUM_SERVERS_MAX.

           stop [force]
                  (Administrative)    Stops   the  Empress  Server by
                  terminating   idle  service  servers,   the   admin
                  server    and  spooler.  If  used  without  [force]
                  option, the busy servers will  be  terminated  only
                  after   their   task  is completed.  Option [force]
                  causes all idle and  busy  servers  to  stop  their
                  execution immediately.

           refresh
                  (Administrative) The Empress Server  refreshes  its
                  components   by  terminating the  idle servers, and
                  creating new servers instead of them.

           interrupt SERVER_ID
                  Sends  an interrupt to the server with SERVER_ID ID
                  number.

           change_password [LOGIN_NAME]
                  (Administrative when changing  other  users'  pass-
                  word)   Changes  the password for users (and admin-
                  istrator) of the Empress  Server. If LOGIN_NAME  is
                  given,  empsvadm  will  try to change  the password
                  for the  user  with LOGIN_NAME. Only  the  adminis-
                  trator  of   an   Empress  Server  can change other
                  users' password.

       FILE
              Empress database files.

       SEE ALSO
              empsv(1)

              Empress: Database Server

       HISTORY
              Written  by  Empress  Software Inc.  All material is copy-
              righted and licensed.  Use on non-licensed CPUs is prohib-
              ited.