NAME

       omniEvents - CORBA Event Service daemon

SYNOPSIS

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

DESCRIPTION

       omniEvents is a CORBA Event Service server program. It is designed to  be  run  as  a  standalone  daemon
       process.

       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.

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
              /var/lib/omniEvents

       -P pidfile
              Keep track of the currently running  omniEvents  process  in  pidfile,  which  should  usually  be
              /var/run/omniEvents.pid.  If pidfile already exists, then the server refuses to start. The default
              is to not write a PID file.

       -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

       -f     Run the server in the foreground (do not daemonize).

       -t file
              Send trace messages to file instead of syslog.

       -v     Output  the CORBA IOR of the EventChannelFactory CORBA object when the server starts. This will go
              either to syslog or to the current trace file.

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

SIGNALS

       SIGTERM, SIGINT
              Shuts down the server.

       SIGUSR1
              You  can  change  the traceLevel while the application is running. Send the server SIGUSR1 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 SIGUSR1.

              Example: kill -USR1 `cat /var/run/omniEvents.pid`

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.

                                                                                                   OMNIEVENTS(8)