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 34 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.