Appendix B: Startup Switches

Startup switches have two main functions: (1) to specify paths to various files that the gateway reads or writes to and (2) to set operational parameters.

Using Startup Switches with the NLM Gateway
If you use multiple switches to fine-tune the gateway, you should use a startup file. The startup file is an ASCII text file that contains all the switches you want to use. The default startup file, is called OVVM.CFG

The startup file should be stored in the same directory as the OVVM.NLM. By default is this in the SYS:\OVVM41 directory. The syntax for loading the gateway with a startup file is:

load ovvm

You can include a load statement that uses a startup file in AUTOEXEC.NCF.

Using Startup Switches with the OS/2 Gateway
If you use the OS/2** icon to start the gateway, the required startup switch (/home) is automatically added to the Parameters field of the OS/2 settings window when the icon is created.

To add other startup switches to the Parameters field,

  1. Click the OVVM Gateway Icon.

  2. Right-click the to display the icon menu.

  3. Click Open  Settings.

  4. Choose the Parameters field and enter the startup switches and parameters desired.

  5. Double-click the title bar icon to close and save the settings.

Startup Switches
This section defines all the startup switches that can be used with the GroupWise* Gateway for OfficeVision/VM**. You can use the normal or shortened syntax. The /home switch is the only startup switch that is required. Items that are italicized indicate a variable the administrator supplies.

/applid
This switch tells the gateway to use a different applid than the one configured.

Syntax: /applid-new applid
Example: /applid-rscsvm5

/corr
This switch indicates the path to the correlation database directory when the default \WPGATE is not used.

Syntax: /corr-pathname
Short syntax: /pc
Example: /corr-j:\tmp\work

/help
This switch displays the startup switch Help screen. This will not start an active gateway session.

Syntax: /help
Short syntax: /h
Example: ovvm /help

/home (Required)
This switch points the server to the gateway directory.

Syntax: /home-gateway directory
Short syntax: /ph
Example: /home-j:\headq\wpgate\ovvm

If the NLM* and gateway directory reside on different file servers, create a common NetWare* user ID on both file servers that has rights to the gateway directory. Include the user ID and password in the loading syntax as follows:

Syntax: /home-server\volume:gateway directory[userID/password]
Example: /home \fs2\sys1:headq\wpgate\ovvm[ngw/delivers]

/linkid
This switch tells the gateway to use a different linkid than the one configured in Admin.

Syntax: /linkid-new linkid
Example: /linkid-ovvmnje5

/log
This switch redirects the log files to a different location.

Syntax: /log-directory
Short syntax: /pl
Example: /log-c:\log\ovvm

/logdays
This switch designates how many days log files remain on the disk. Files are deleted if they age beyond the number of days specified. The range is from 1 to 360 days. Use 0 for the maximum (360).

Syntax: /logdays-days
Short syntax: /lt
Example: /logdays-5

/loglevel
This switch overrides the logging level set in Admin. The values are:

For more information about logging levels, see Logging Level in Chapter 10: Enhance Gateway Functionality.

Syntax: /loglevel-level
Short syntax: /ll
Example: /loglevel-verbose

/logmax
This switch controls the maximum amount of disk space for all log files. When this limit is reached, the gateway overwrites the existing log files starting with the oldest one. The default is 1024KB or 1M. The range is from 256KB to unlimited size. Use 0 for unlimited disk space.

Syntax: /logmax-KB
Short syntax: /ls
Example: /logmax-512

/nodeid
This switch uses a different nodeid than the one configured in NetWare Administrator.

Syntax: /nodeid-new nodeid
Example: /nodeid-vm5

/pid
This switch is used to designate a parallel gateway. Parallel gateways are multiple instances of a single gateway. You would use parallel gateways to increase throughput and reliability. Each gateway is defined by a three-digit number, with the first gateway assigned the number 000 by default.

Syntax: /pid-gateway number
Example: /pid-001

/recv
This switch places the gateway in “receive-only” mode.

Syntax: /recv
Short syntax: /r

/send
This switch places the gateway in “send-only" mode.

Syntax: /send
Short syntax: /s

/single
This switch tells the gateway to run a single send and receive cycle, then terminate the program.

Syntax: /single
Short syntax: /sc

/work
This switch indicates the path to the GWWORK directory when the default is not used.

Syntax: /work-pathname
Short syntax: /pw
Example: /work-j:\tmp\work

* Novell trademark. ** Third-party trademark. See Trademarks for more information.