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.