WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

The emitevent.jacl script

You can use a command line interface to submit events to the event server.

Purpose

Sends an event to the event server.

wsadmin -f emitevent.jacl [-xml url] [-msg message] [-severity severity] [-extensionname extension_name] [-emitter profile_name] [-synchronous | -asynchronous]

Description

The emitevent.jacl script provides a command-line interface for submitting events to the event server. You can provide the event content by providing a source XML file or by specifying property values on the command line.

Events generated by this script have the following default content:
<CommonBaseEvent creationTime=current_system_time 
version="1.0.1"> <sourceComponentId component="emitevent.jacl" 
componentIdType="Application" location=local_hostname
locationType="Hostname"
subComponent="com.ibm.events.cli.util.EmitEventCliHelper"
componentType="http://www.ibm.com/namespaces/autonomic/Tivoli
/EventInfrastructure"/> <situation categoryName="ReportSituation">
  <situationType xsi:type="ReportSituation" reasoningScope="EXTERNAL"
   reportCategory="CLI"/>
 </situation>
</CommonBaseEvent>

The current_system_time parameter is the system time at which the event is generated, specified as an XML dateTime string.

Parameters

-xml url
A uniform resource locator (URL) that specifies the location of an XML document that contains the event to be submitted. This XML document must conform to the Common Base Event version 1.0.1 XSD schema. If no URL scheme (such as http://) is specified, a local file is assumed. This parameter is optional.

Two sample XML files, eventsample1.xml and eventsample2.xml, are available in the install_root/events/samples directory.

-msg message
The value to use for the message property of the event. If the message contains spaces, enclose this value in quotation marks. This parameter is optional. If you specify this parameter in addition to an XML file, the value of the -msg parameter overrides any value specified in the XML file for the msg property.
-severity severity
The value to use for the severity property of the event. This parameter is optional. If you specify this parameter in addition to an XML file, the value of the -severity parameter overrides any value specified in the XML file for the severity property.
-extensionname extension_name
The value to use for the extensionName property of the event. If the extension name contains spaces, enclose this value in quotation marks. This parameter is optional. If you specify this parameter in addition to an XML file, the value of the -extensionname parameter overrides any value specified in the XML file for the extensionName property.
-emitter profile_name
The Java Naming and Directory Interface (JNDI) name of the emitter factory profile to use when obtaining an emitter. This parameter is optional. If this parameter is not specified, the default emitter factory profile (/com/ibm/events/configuration/emitter/Default) is used.
-synchronous | -asynchronous
The synchronization mode to use for event transmission. This parameter is optional. If it is not specified, the preferred synchronization mode configured for the emitter is used.

Examples

The following example sends an event to the event server with a severity of 30 and the extension name test_event (all other properties have the default values):
wsadmin -f emitevent.jacl -severity 30 -extensionname test_event
The following example sends an event using the properties specified in eventsample1.xml:
wsadmin -f emitevent.jacl -xml ../samples/eventsample1.xml

Reference topic

Terms of Use | Rate this page

Timestamp iconLast updated: 13 Dec 2005
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc\doc\rcei_admin_CLIEmitEvent.html

(C) Copyright IBM Corporation 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)