Name

omniEvents-win32 — CORBA Event Service for Windows

Synopsis

Command:

omniEvents [-p port] [-a endpoint] [-l directory] [-N factory-name] [-t file] [-vVh]
[-ORBparameter value]

Windows service control:

omniEvents [ install [OPTIONS] | uninstall | setoptions [OPTIONS] | getoptions ]

Description

omniEvents is a CORBA Event Service server program. It is designed to be run as a Windows service.

The server continuously saves its state to a file. Event channels are re-created from this file each time the server restarts. The options -p and -a affect the identity of the server's event channels, so these options can only be set the first time the server is run.

Servers may be configured to operate in pairs - if one fails then clients automatically switch over to the alternate.

Service Control

omniEvents itself has four service set-up commands. The command name must immediately follow the omniEvents. Any normal command-line options which follow the command are stored in the Windows registry. They will be used when the service starts up.

omniEvents install OPTIONS

Install the service with the specified options. The only option that will usually be useful is -t, which instructs omniEvents to send trace logs to a file.

Example: omniEvents install -t "C:\omniEvents\trace.out"

omniEvents uninstall

Uninstalls the service.

omniEvents setoptions OPTIONS

Changes the service's stored options.

omniEvents getoptions

Outputs the service's stored option to standard output.

Once the omniEvents is installed, you can control it from the command line, or from scripts with the Sc.exe command. Sc.exe is distributed with the “Microsoft SDK”.

sc start omniEvents

Starts the server.

sc stop omniEvents

Shuts down the server.

sc control omniEvents 128

You can change the traceLevel while the application is running. Send control signal 128 to the server to bump its traceLevel up by 5. The traceLevel is wrapped at 45, so you can always get it back to where it started by repeatedly sending signal 128.

Options

-p port

Sets the TCP port on which a new server will listen. The default is 11169

This value is stored in the new server's persistent state. There is no need to supply this option when a server is restarted, since the value is read from the file. If the option is supplied then it is simply compared with the stored value - if the two do not match then the program exits with an error.

-a endpoint

Sets an alternate endPoint for a new server. All CORBA object references generated by the server include the alternate address. When clients cannot contact the server, they automatically fall back to trying the alternate address.

This option is exactly equivalent to the ORB parameter endPointNoListen, except that the value is saved in the server's persistency file, so that it is remembered whenever omniEvents is restarted.

The format for a TCP endpoint is giop:tcp:HOST:PORT, for example: -a giop:tcp:secondary.host:11169

This value is stored in the server's persistent state. There is no need to supply this option when a server is restarted, since the value is read from the file. If the option is supplied then it is simply compared with the stored value - if the two do not match then the program exits with an error.

-l directory

Full path to data directory, where omniEvents stores its persistent state. The default is C:\omniEvents

-N factory-name

Sets the CORBA Name Service name for the EventChannelFactory CORBA object. Each time the server starts, it registers its channel factory object with factory-name in the Name Service.

Format for name: [CONTEXT-ID[.CONTEXT-KIND]/]*OBJECT-ID[.OBJECT-KIND]

Examples: foo, foo.bar, foo.bar/baz/qux, foo/bar/baz.qux.

The default is EventChannelFactory

-t file

Send trace messages to file.

-v

Output the CORBA IOR of the EventChannelFactory CORBA object when the server starts.

-V

Display version.

-h

Display a short summary of command-line options.

-ORBparameter value

Standard omniORB options. see omniORB documentation for details. Do NOT use this option to set the endPoint or alternateEndPoint. This option is commonly used to set the omniORB traceLevel, in order to get more detailed output.

Example: -ORBtraceLevel 5

Event Channel Parameters

The omniEvents::EventChannelFactory object implements the standard CosLifeCycle::GenericFactory interface. An EventChannel object is created by a call to the create_object(key,the_criteria) operation.

The “key” parameter must be set to EventChannel”.“object interface. The “the_criteria” parameter is a sequence of various service parameters. Supported parameters are listed below.

CyclePeriod_ns (long)

Sets the cycle period of the channel (nanoseconds). This is the time that the channel waits before transferring messages from the incoming queue to the outgoing queue. While messages are being transferred, incoming calls are queued. The default is 0.1 seconds.

FilterId (string)

Only types whose RepositoryId matches the parameter are permitted to pass through the channel. Other events are silently ignored.

InsName (string)

Sets the name by which the EventChannel is known in omniEvents' INSPOA. You can refer to the channel with a corbaloc string like this: corbaloc::HOST:11169/NAME

MaxNumProxies (long)

The maximum number of ProxyPullSuppliers per channel.

MaxQueueLength (long)

How many events are buffered by the ConsumerAdmin object. The discard policy is FIFO, meaning that the oldest events are discarded first in case of overflow.

PullRetryPeriod_ms (long)

Period (milliseconds) between polls when in Pull Supplier - Push Consumer mode.

Environment Variables

OMNIEVENTS_LOGDIR

Sets the directory where data files are kept by default. An alternative to the -l option.

OMNIORB_CONFIG

The location of the omniORB configuration file.

Copyright

Copyright © 2003-2005 Alex Tingle, 1999 Paul Nader.

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.