.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "EVENTS" 1 "" "" ""
.SH NAME
events \- stream events from or to a CORBA EventChannel
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 7
\fBevents\fR [\-n\ \fIchannel\-name\fR] [\-s] [\-h] [\-ORB\fIparameter\fR\ \fIvalue\fR] [\fIchannel\-uri\fR]
.ad
.hy

.SH "DESCRIPTION"

.PP
\fBevents\fR streams events from an event channel to standard output, or (\fB\-s\fR) from standard input to an event channel\&.

.PP
Events are streamed in raw binary form, accompanied by a timestamp\&. When the stream is played back into a channel, the timestamps are used the replicate the original delays between the messages\&.

.PP
The main use for this command it to record sets of events and play them back later for testing\&.

.PP
Recording example: \fBevents corbaname::#EventChannel > test\&.dat\fR

.PP
Playback example: \fBevents \-s corbaname::#EventChannel < test\&.dat\fR

.SH "OPTIONS"

.TP
\fB\-n channel\-name\fR
The CORBA Name Service name used to look up the EventChannel CORBA object\&.

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

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

The default is EventChannel

.TP
\fB\-s\fR
Supply mode\&. Read events from standard input\&.

.TP
\fB\-h\fR
Display a short summary of command\-line options\&.

.TP
\fB\-ORBparameter value\fR
Standard omniORB options\&. see omniORB documentation for details\&. This option is commonly used to set the omniORB traceLevel, in order to get more detailed output\&.

Example: \fB\-ORBtraceLevel 5\fR

.SH "ENVIRONMENT VARIABLES"

.TP
OMNIORB_CONFIG
The location of the omniORB configuration file\&.

.SH "COPYRIGHT"

.PP
Copyright © 2004,2005 Alex Tingle\&.

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