Installation Guide : EMSRV Startup options
EMSRV Startup options
 
Platform
Operating Systems Included
UNIX
Linux
Win
Windows
All Platforms
All operating systems listed above
The following table lists and describes EMSRV startup parameters.
Parameter
Platform
Description
-A<0,1>
All platforms
The file system requires read locks. The default setting is 0, which indicates the file system does not need read locks.
-a<seconds>
All platforms
Sets the number of seconds before a connection holding a lock is deemed inactive. The default is 30 seconds.
-b<Kilobytes>
All platforms
Sets the low-volume threshold warning in kilobytes. The default is 10,000 kilobytes. If the available disk space is less than the low-volume threshold, EMSRV will log warning messages to the log file.
-f
UNIX
Sets EMSRV to run in the foreground.
-h
All platforms
Displays the help text that lists the valid options.
-i<q,t>
UNIX
Ignores signals. <q> = ignore SIGQUIT; <t> = ignore SIGTERM. By default, either of these signals cause EMSRV to terminate.
-install
Win
Installs EMSRV as a service.
-lc
All platforms
Logs messages to the console. By default, messages are not written to the console.
-lf<name>
All platforms
Writes the log to file <name>. By default, the log is written to emsrv.log. The file <name> must specify a valid path for which the EMSRV account has sufficient access rights.
-ls
UNIX
Logs messages to stdout instead of a log file. EMSRV must be run in the foreground using the -f option if -ls is used.
-M<number of connections>
All platforms
Specifies the maximum number of connections that can be established with EMSRV. The default is 512.
To start EMSRV with a maximum of 80 client connections, use the following parameter:
load EMSRV -M80
-P<port number>
All platforms
Specifies the port number that the EMSRV process uses. The default is 4800.
To start EMSRV using port number 4899, use the following parameter:
load EMSRV -P4899
To configure a client to connect to this port, add the port number at the end of the server name (separated with a colon) in the ini file or the connection dialog. For example, in the ini file specify ServerAddress=vastemsrv:4899.
-p <password>
Win
Specifies the password for the EMSRV user account and restricts library file access. This password is used for EMADMIN functions, such as shutting down EMSRV remotely. Refer to the section "The EMADMIN utility" for information on EMADMIN functions.
-R<0,1>
All platforms
The file system releases locks on file close. The default setting is 1, which indicates the file system releases locks when files close.
-remove
Win
Uninstalls the EMSRV service.
-rn
All platforms
Rejects users who do not supply a valid EMSRV user name and password. The default grants access to users without an EMSRV user name and password.
-rp
All platforms
Rejects users who are not in the passwd.dat file. The default grants access to users who are not in the password file.
-s<0, 1, 2>
All platforms
Sets the reporting level to the specified severity level (0, 1, or 2). See the section following, "EMSRV messages and reporting," for a description of severity levels. The default is 2 (log error messages only).
-t
All platforms
Protects existing files from truncation. By default, files are created over existing ones; that is, the existing file is truncated to 0 length.
-u <user name>
Win
Specifies the EMSRV account name to be used.
-W <path>
Win
Specifies the EMSRV working directory. The directory <path> must be a valid path for which the EMSRV account has sufficient access rights to read, write, or both.
 
Last modified date: 02/18/2021