isCOBOL WebClient : WebClient commands : Windows services and Unix daemons : Unix daemon
Unix daemon
On Linux systems, WebClient tools can be installed as daemon processes and maintained using the following commands: webclient-admin, webclient-and-admin, webclient-cluster, webclient-session and webclient
Each command provides the following options:
Option
Action
restart
Stop and start again the daemon in background mode.
run
Run the daemon in foreground mode.
start
Run the daemon in background mode.
status
Show the daemon status.
stop
Stop the daemon.
Daemon configuration
WebClient tools on Linux look for two files located in the bin directory:
• default_java.conf includes the paths to the WebClient and Java installations:
Variable
Description
ISCOBOL
WebClient installation directory
ISCOBOL_JDK_ROOT
JDK installation directory
ISCOBOL_JRE_ROOT
JRE installation directory
• <command>.options includes environment variables that can alter the command behavior:
Variable
Description
PREFIX_HOME
Home directory of the command
PREFIX_OPTS
Command line options for the command.
Use a space to separate multiple options.
When the options string includes spaces, delimit it with quotes, for example:
WEBCLIENT_OPTS="-p 1234 -c mywebc.config"
PREFIX_JAVA_EXE
Alternative JVM for the command
PREFIX_JAVA_OPTS
Java options for the command.
Use a space to separate multiple options.
When the options string includes spaces, delimit it with quotes, for example:
WEBCLIENT_JAVA_OPTS="XX:+HeapDumpOnOutOfMemoryError -Xmx4G".
PREFIX_LOG_FILE
File where the command output is redirected
PREFIX_PID_FILE
Semaphore file to inform if the command is running or not.
This file contains the process ID.
Depending on the <command>.options file, PREFIX can be:
• WEBCLIENT for webclient
• WEBCLIENT_ADMIN for webclient-admin
• WEBCLIENT_CL for webclient-cluster
• WEBCLIENT_SP for webclient-session
These files are generated by the setup process.
In these files, comments are prefixed by a hash and each entry is on a separate line.
Environment variables in <command>.options can alternatively be set also in the external environment through the export command. The external environment has priority over the content of <command>.options.