# 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 ]