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

The eventcatalog.jacl script

You can use a command line interface to access the event catalog.

Purpose

Lists event definitions or source categories in the event catalog and imports and exports event definitions.
wsadmin -f eventcatalog.jacl [-listdefinitions | -listcategories | -exportdefinitions | -importdefinitions] [-file filename] [-name event_def_name] [-pattern] [-resolve] [-replace]

Description

The eventcatalog.jacl script provides command-line access to the contents of the event catalog. It also provides support for importing and exporting event definitions.

Parameters

-listdefinitions
Lists the specified event definitions in a readable format, sorted by name in ascending order. The listing is written to the file specified by the -file parameter. If this parameter is not specified, the listing is written to the standard output.
-listcategories
Lists all of the defined event source categories and the event classes they contain, sorted by source category in ascending order. The listing is written to the file specified by the -file parameter. If this parameter is not specified, the listing is written to the standard output.
-exportdefinitions
Lists the specified event definitions in a format that is suitable for importing. The listing is written as an XML document conforming to the eventdefinition5_0_1.xsd XSD schema, which is packaged in the events-client.jar file. The listing is written to the file specified by the -file parameter. If this parameter is not specified, the listing is written to the standard output.
-importdefinitions
Reads a listing of event definitions from a file and adds the event definitions to the event catalog. The listing of event definitions to import must be written as an XML document that conforms to the eventdefinition.xsd XSD schema.
-file filename
For a list or export operation, the name of the file to which the output is written. For an import operation, the file that contains the event definitions to be imported. This parameter is required for import operations and optional for list and export operations. If this parameter is not specified for a list or export operation, the output is written to the standard output.
-name event_def_name
A name that identifies the event definitions to be listed or exported. If the -pattern parameter is not specified, the -name parameter identifies a single specific event definition. If -pattern is specified, -name specifies a pattern against which event definition names are compared. In this pattern, a percent character (%) matches any sequence of zero or more characters, and an underscore (_) matches any single character. All other characters are treated literally.

This parameter is valid only with the -listdefinitions and -exportdefinitions options. It is not valid with the -listcategories or -importdefinitions options.

-pattern
Specifies that the value specified with the -name parameter is to be treated as a pattern. This parameter is valid only with the -listdefinitions and -exportdefinitions options. It is not valid with the -listcategories or -importdefinitions options.
-resolve
Specifies that the event definitions to be listed or exported are resolved. A resolved event definition includes the property and extended data element descriptions that are inherited from its ancestors in the inheritance hierarchy. If this parameter is not specified, the event definition listing contains only the raw event definitions.

This parameter is valid only with the -listdefinitions and -exportdefinitions options. It is not valid with the -listcategories or -importdefinitions options.

-replace
Specifies that the event definitions to be imported replace existing event definitions with the same names. If this parameter is not specified, a name collision between an existing event definition and an imported event definition results in an error, and no event definitions are imported.

This parameter is valid only with the -importdefinitions option. It is not valid with the -listdefinitions, -listcategories, or -exportdefinitions options.

Examples

This example displays the contents of a single, resolved event definition named insurance_claim_start and writes the result to standard output:
wsadmin -f eventcatalog.jacl -listdefinitions -name insurance_claim_start -resolve
This example exports a set of event definitions, the names of which begin with the string insurance_claim_start and writes the result to an XML file:
wsadmin -f eventcatalog.jacl -exportdefinitions -file d:\myexport.xml 
  -name insurance_claim_start% -pattern
This example imports a set of event definitions from the file myimport.xmland replaces existing definitions with the same names:
wsadmin -f eventcatalog.jacl -importdefinitions -file d:\myimport.xml -replace
This example displays a listing of all defined event source categories and the events they contain. The result is written to standard output:
wsadmin -f eventcatalog.jacl -listcategories

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

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