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> UNIX Sets the number of seconds before a connection is deemed inactive. The default is 360 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 OS/2, Win, NetWare Logs messages to the console. By default, messages are not written to the console.
-lf<name> OS/2, Win, NetWare 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.
-lp<seconds> UNIX Sets the maximum number of seconds to wait for a lock. The default is 15 seconds.
-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.
-lt<seconds> UNIX Sets the maximum number of seconds to hold a lock.
-M<number of connections> All platforms Specifies the maximum number of connections that can be established with EMSRV. The default is 256.

To start EMSRV with a maximum of 80 client connections, use the following parameter:

load EMSRV -M80
-n UNIX Turns off statistics gathering.
-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.
-r UNIX Rejects users who are not in the passwd.dat file.
-rd OS/2, Win Disables password checking for clients. This is the default setting.
-remove Win Removes the EMSRV service from the Registry.
-rn Win, NetWare 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 OS/2, Win, NetWare 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.
-v UNIX Verifies password using system authentication.
-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.
-w All platforms Specifies that EMSRV should track locks for each connection.
-xd <devnum> UNIX This parameter allows EMSRV to open libraries on devices other than the default hard drive. A maximum of 15 devices may be specified. If you intend to locate libraries on a hard drive other than the boot drive, you must specify an -xd option for each other hard drive. If you do not, your client will generate the error "File resides on an unsupported device".

Warning: The -xd option can bypass checking for a remote file system. If a library is located on a remote file system (or even a local file system mounted using a remote protocol), the library can become corrupted. Make sure that devices specified with -xd are local to the machine running EMSRV and are not from mounted remote file systems like NFS.


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