NIO CommKit Host Interface Installation and System Administration Manual

DKSERVER(1M) DKSERVER(1M)
E-33 CommKit Host Interface, Release 4.0
-l logfile Use logfile instead of the default file /var/opt/dk/log/dksrvlog . The full pathname for
logfile must be specified or the logfile will be created in the current working directory of
dkserver (/etc/opt/dk/srvtab for multiple srvtab(4) files format or ’/’ for a single srvtab(4)
file format). [See dksrvlog(4).]
–C channel Specify the logical channel number desired to be used as the dkserver channel. The
channel selected has to be within the channel range of the hunt group configured in the data
switch controller database for the servername specified through the –s option of this
command. (For more information about the multiple groups per CPM feature provided by
the AT&T data switches—Datakit II VCS R3.1.1 and later—read the data switch
documentation on the "enter cpm" command.) If this option is not used, an arbitrary
channel will be selected.
The default channel number used if you do not specify dkserver -C is 2. If you do not
specify dkserver -C and if channel 2 is already in use, the Datakit server selects the next
higher channel until it finds an available channel. If channel 2 is in use, the server selects
channel 3. If channel 3 is in use, the server selects channel 4, and so on. During the channel
selection process, the server continues running.
-r This option will prevent dkserver from running in background mode. This option is not
needed if dkserver is spawned by init(1M).
-t Gracefully terminate dkserver. No new incoming calls are accepted, and when all existing
calls are completed, dkserver exits. This ensures proper cleanup of accounting files and
should be invoked in system shutdown procedures. The -i and -s options may be used to
specify the interface and dkserver name to terminate. If neither -i or –s is specified, the
default dkserver (that is, dkserver for interface 0 with name nodename) will be
terminated.
If you have more than one CommKit interface board installed in a server, you must use both
the -s servername and -i interface options to specify the server name and interface board
number you want to terminate. If you do not specify both -s and -i, CommKit displays an
error message indicating a lock failure.
ENVIRONMENT VARIABLES
A base set of environment variables is always passed as the initial environment of all commands invoked by
dkserver. These variables are always set by the rules given below and will never be overwritten or duplicated
by use of the –e argument or by environment variables passed as part of a user service request. If the –e
argument is used, DKINTF will be added to the base set, any other environment variables will be merged with
the base set and this expanded environment will be passed to the invoked command. Environment variables
that would overwrite an existing variable from the base set will be ignored. If an incoming user service request
passes environment variables they will also be merged into the environment variables passed to the invoked
command. User requested variables that would overwrite an existing variable from the base set or from the -
e argument will be ignored.
BASE SET
LOGNAME The LOGNAME environment variable is always passed to the invoked command. It is
always set from the value found in the /etc/passwd file for the user selected using the user
field of the srvtab(4) entry.
HOME The HOME environment variable is always passed to the invoked command. It is always
set from the value found in the /etc/passwd file for the user selected using the user field of
the srvtab(4) entry.
SHELL The SHELL environment variable is always passed to the invoked command. It is always
set from the value found in the /etc/passwd file for the user selected using the user field of
the srvtab(4) entry.
PATH The PATH environment variable is always passed to the invoked command. If PATH is set
in the dkserver environment, then that value is used. If PATH is not set in the dkserver