Administration Functions and Tools › Events, Rules, and Actions › Post a Logical Event

Post a Logical Event

You can post a logical event either through HTTP Post or from one of the postEvent Administration web service methods.

To specify an HTTP URL to post an event to the system, use the following syntax:

http://hostname:port/usm/wpf?Node=icguinode.postevent&username=userid&pass=password&domain=businessunit&Args=eventsource&Args=nsppath&Args=transactionname&Args=eventtypename&Args=transactiontype&Args=eventdescription&Args=associatedobjectid&Args=false&Args=param1|oldvalue1!param#|oldvalue#!&Args=param1|newvalue1!param#|newvalue#!

The following parameters require explanation:

userid

Specifies a valid user ID for authentication.

password

Specifies the password for the user ID.

businessunit

Specifies the business unit for the role of the user ID.

eventsource

Specifies whether the source is logical or physical.

nsppath

Specifies the namespace path, a placeholder value only. The Catalog system does not use the actual value but requires a placeholder value.

transactionname

Specifies the transaction name for the event.

eventtypename

Specifies the name of the event type.

transactiontype

Specifies the transaction type for the event.

eventdescription

(Optional) Specifies a description for the event.

associatedobjectid

Specifies the ID of an object to associate with this event.

You can optionally specify one of the event parameters for this value.

param#|oldvalue#

Specifies the parameter name and the old value. Delimit the name and value with a vertical bar. Separate each name and value pair with an exclamation point.

param#|newvalue#

Specifies the parameter name and new value. Delimit the name and value with a vertical bar. Separate each name and value pair with an exclamation point.

Note: The Catalog system uses old and new values when evaluating any rule filters associated with event rules.

Example: Post a Custom Logical Event

The following sample URL posts a custom logical event to the Service View server on Server B:

http://serverB:8080/usm/wpf?Node=icguinode.postevent&username=spadmin&pass=spadmin&domain=ca.com&Args=LOGICAL&Args=nsppath&Args=StorageLimitHandler&Args=EXCEEDED_STORAGE_LIMIT&Args=LOGICAL&Args=Storagelimitexceeded&Args=$uid$&Args=false&Args=storageLimit|10!&Args=storageLimit|20!

The event for this post contains the following name and value pairs:

username=spadmin

Specifies the name of user posting this event.

pass=spadmin

Specifies the password of this user.

domain=ca.com

Specifies the name of domain in question.

Args=LOGICAL

Specifies the type of event.

Args=nsppath

Specifies the namespace path (any value).

Args=StorageLimitHandler

Specifies the transaction name.

Args=EXCEEDED_STORAGE_LIMIT

Specifies the transaction event type.

Args=LOGICAL

Specifies the transaction type.

Args=Storagelimitexceeded

Specifies the description.

Args=$uid$

Specifies the object ID of this event. The $uid$ event parameter is used here.

Args=false

Indicates whether this event is a partial event. The value is always false.

Args=storageLimit|10!

Specifies the parameter name and the old value.

Args=storageLimit|20!

Specifies the parameter name and the new value.

Note: You can enter such a URL as an action for a rule of an event, or from a URL from a Java program. In both cases, replace the symbol & with %26.

More information:

Using Web Services