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. |