Section 5 - File Formats, Data Descriptions, MIBs, and System Processes Reference

e-docs > Tuxedo > File Formats, Data Descriptions, MIBs, and System Processes Reference > Section 5 - File Formats, Data Descriptions, MIBs, and System Processes Reference

File Formats, Data Descriptions, MIBs, and System Processes Reference

T_EVENT_SERVICE Class Definition

Overview

The T_EVENT_SERVICE class represents a set of subscriptions registered with the EventBroker for service-based notification. When an event is detected, it is compared to each T_EVENT_SERVICE object. If the event name matches the value in TA_EVENT_EXPR and the optional filter rule is TRUE, the event buffer is sent to the specified BEA Tuxedo service routine.

Attribute Table

Table 35 T_EVENT_SERVICE Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_EVENT_EXPR(r) (*) TA_EVENT_FILTER(k) TA_EVENT_FILTER_BINARY(k)	string string carray	R--R--R-- R--R--R-- R--R--R--	string[1. .255] string[1. .255] carray[1. .64000]	N/A none none
TA_STATE(r)	string	R-xR-xR-x	GET: ACT SET: {NEW \| INV}	N/A N/A
TA_SERVICENAME(r) (*)	string	R--R--R--	string[1..15]	N/A
TA_EVENT_PERSIST TA_EVENT_TRAN	short short	R-xR-xR-x R-xR-xR-x	short short	0 0
(k)—a key field for object retrieval (r)—the field is required when a new object is created (*)—GET/SET key, one or more required for SET operations

Check MIB(5) for an explanation of permissions.

Attribute Semantics

TA_EVENT_EXPR: string[1..255]

Event pattern expression. This expression, in regular expression format, controls which event names match this subscription.

TA_EVENT_FILTER: string[1..255]

Event filter expression. This expression, if present, is evaluated with respect to the posted buffer's contents. It must evaluate to TRUE or this subscription is not matched.

TA_EVENT_FILTER_BINARY: carray[1..64000]

Event filter expression, in binary (carray) format. Same as TA_EVENT_FILTER, but may contain arbitrary binary data. Only one of TA_EVENT_FILTER or TA_EVENT_FILTER_BINARY may be specified.

TA_STATE:

GET: ACTive

A GET operation will retrieve configuration information for the matching T_EVENT_SERVICE object(s).

SET: {NEW | INValid}

A SET operation will update configuration information for the T_EVENT_SERVICE object. The following states indicate the meaning of a TA_STATE set in a SET request. States not listed may not be set.

NEW	Create T_EVENT_SERVICE object. Successful return leaves the object in the ACTive state.
INValid	Delete T_EVENT_SERVICE object. Successful return leaves the object in the INValid state.

TA_SERVICENAME: string[1..15]

Call this BEA Tuxedo service when a matching event is detected.

TA_EVENT_PERSIST: short

If non-zero, do not cancel this subscription if the TA_SERVICENAME service is no longer available.

TA_EVENT_TRAN: short

If non-zero and the client's tppost() call is transactional, include the TA_SERVICENAME service call in the client's transaction.