Installation Guide


EMSRV Startup options


Platform Operating Systems Included
Netware Netware
OS/2 OS/2
UNIX HP, Sun, AIX, Linux
Win Windows 2000, Windows NT
All Platforms AIX, HP, Netware, Linux, OS/2, Sun, Windows 2000, Windows NT

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

If you need to change the port number on the client and do not know how, contact customer support.

-p <password> OS/2, Win, NetWare 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.

For NetWare, you must specify -p without the password parameter if the EMSRV account has no password.

-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 Removes the EMSRV service from the Registry.
-rn Win, NetWare, Unix 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).
-SC NetWare Sets the NDS context for EMSRV to <context>. Consult your NetWare documentation for information on setting NDS contexts.
-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, NetWare Specifies the EMSRV account name to be used.
-W <path> OS/2, Win, NetWare 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.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]