Event classes and attributes
The body of an event contains an event class and the attributes that define the event class.
An event class defines a specific type of Event Integration Facility (EIF) event that a Classic data server sends to an event server.
Event classes
The Classic data server emits EIF events to an event server based on the subscription state, the subscription apply latency, and the heartbeat event. The following table lists each event class, a description of the event class, and the event attributes that define the event class.
Event class name | Description | Attributes |
---|---|---|
AA_replication_max_latency_exceeded
AA_replication_max_average_latency_exceeded |
Emitted when the value of the averaged or non-averaged end-to-end apply latency of a subscription exceeds the specified maximum apply latency threshold time. | adapter host
apply_latency_time averaging_time cac_eventmsg cac_eventmsg_id consistency_group consistency_group_total credibility data_source job_name latency_state max_latency_time msg node origin point_in_time_consistency reserved01 - reserved05 severity source_system_id status sysplex_name system_name taskno time_stamp version workload_name workload_type |
AA_replication_constrained_latency_exceeded
AA_replication_constrained_average_ latency_exceeded |
Emitted when the value of the averaged or non-averaged end-to-end apply latency of a subscription exceeds the constrained apply latency threshold time. | adapter_host
apply_latency_time averaging_time cac_eventmsg cac_eventmsg_id consistency_group consistency_group_total constrained_latency_time credibility data_source job_name latency_state msg node origin point_in_time_consistency reserved01 - reserved05 severity source_system_id status sysplex_name system_name taskno time_stamp version workload_name workload_type |
AA_replication_critical_latency_exceeded
AA_replication_critical_average_latency_exceeded |
Emitted when the value of the averaged or non-averaged end-to-end apply latency of a subscription exceeds the critical apply latency threshold time. | adapter_host
apply_latency_time averaging_time cac_eventmsg cac_eventmsg_id consistency_group consistency_group_total credibility critical_latency_time data_source job_name latency_state msg node origin point_in_time_consistency reserved01 - reserved05 severity source_system_id status sysplex_name system_name taskno time_stamp version workload_name workload_type |
AA_replication_discrete_latency_exceeded | Emitted when the value of the non-averaged end-to-end apply latency of a subscription exceeds the discrete apply latency threshold time. | adapter_host
apply_latency_time cac_eventmsg cac_eventmsg_id consistency_group consistency_group_total credibility data_source discrete_latency_time job_name latency_state msg node origin point_in_time_consistency reserved01 - reserved05 severity source_system_id status sysplex_name system_name taskno time_stamp version workload_name workload_type |
AA_replication_heartbeat | Emitted at the frequency established by the value of the heartbeat apply latency threshold time. | adapter_host
apply_latency_time averaging_time cac_eventmsg cac_eventmsg_id commits consistency_group consistency_group_total credibility data_source heart_beat_time job_name latency_state max_latency_time msg node origin point_in_time_consistency reserved01 - reserved05 severity source_system_id status subscription_name sysplex_name system_name taskno time_stamp version workload_name workload_type |
AA_replication_reset_latency_met
AA_replication_reset_average_latency_met |
Emitted when the value of the averaged or non-averaged end-to-end apply latency of a subscription falls below the reset apply latency threshold time, after previously exceeding the maximum apply latency threshold time. | adapter host
apply_latency_time cac_eventmsg cac_eventmsg_id consistency_group consistency_group_total credibility data_source job_name latency_state msg node origin point_in_time_consistency reserved01 - reserved05 reset_latency_time severity source_system_id status sysplex_name system_name taskno time_stamp version workload_name workload_type |
AA_replication_workload_down | Emitted by the target server when a subscription transitions to the state SUB_STATE_REPL_INACTIVE | adapter host
apply_latency_time cac_eventmsg cac_eventmsg_id consistency_group consistency_group_total credibility data_source job_name latency_state msg node origin point_in_time_consistency reserved01 - reserved05 severity source_system_id status subscription_state sysplex_name system_name taskno time_stamp version workload_down_method workload_name workload_type |
AA_replication_workload_up | Emitted by the target server when a subscription transitions to the state SUB_STATE_CONTINUOUS. | adapter host
apply_latency_time cac_eventmsg cac_eventmsg_id consistency_group consistency_group_total credibility data_source job_name latency_state msg node origin point_in_time_consistency reserved01 - reserved05 severity source_system_id status subscription_state sysplex_name system_name taskno time_stamp version workload_name workload_up_method workload_type |
Event attributes
The following tables list the event attributes, a description of the attributes, and examples of attribute values.
Attribute name | Description | Value |
---|---|---|
adapter_host | The host on which the adapter, the Classic source or target data server, is running. | Adapter host |
averaging_time | The time across which apply latency times
are averaged.
|
Averaging time |
apply_latency_time | The end-to-end apply latency time. | Apply latency time |
cac_eventmsg_id | The ID of the event message that the Classic data server emits from which the EIF event was adapted. | Event message ID. For example: 0x0101008C |
commits | The number of transactions in the averaged end-to-end apply latency sample set. | Number of committed transactions |
consistency_group | The name of the subscription. Same as the subscription_name attribute. | Consistency group name |
consistency_group_total |
When a value is supplied for the GDPSWORKLOADNAME configuration parameter, the consistency_group_total identifies the number of subscriptions that are defined in the target server. By default, the value is 1. |
1 or the number of subscriptions that are defined in the CECSUB file. |
constrained_latency_time | The latency threshold to which the apply latency time is compared to determine if a constrained latency exceeded event should be emitted.. | Constrained latency threshold time |
credibility | The credibility indicates how the adapter sends the event. The value 0 indicates that the event is sent from a non-Tivoli® Management Environment (TME) adapter. | 0 |
critical_latency_time | The apply latency threshold time to which the apply latency time is compared to determine if a critical latency exceeded event should be emitted. | Critical latency threshold time |
data_source | Indicates the type of data being replicated. | VSAM |
discrete_latency_time | The apply latency threshold time to which the apply latency time is compared to determine if a discrete latency exceeded event should be emitted. | Discrete latency threshold time |
heart_beat_time | The apply latency threshold heartbeat time. | Heartbeat time |
job_name | The job name of the Classic data server where the event originated. | Job name |
latency_state | Based on where the apply latency time falls
in relation to the setting of the apply latency threshold values,
the latency state can be one of the following:
|
Latency state |
max_latency_time | The apply latency threshold time to which the apply latency time is compared. | Maximum latency threshold time |
msg | A message that describes the event in text format. | This message varies depending on the event.
Possible values:
|
node | The ASID of the Classic data server. | ASID. For example: 1300 |
origin | The IP address or host name of the source system. | IP address. For example: 10.1.1.2 |
point_in_time_consistency | The current point-in-time of the data source. | The absolute bookmark of the subscription in the format: yyyy-mm-dd-hh.mm.ss.uuuuuu. For example: 2012-02-28-13.42.53.969000. |
reserved01 | Reserved | |
reserved02 | Reserved | |
reserved03 | Reserved | |
reserver04 | Reserved | |
reserved05 | Reserved | |
reset_latency_time | The apply latency threshold time to which the apply latency time is compared to determine if a reset latency met event should be emitted. | Reset latency threshold time |
severity | The severity of the event. The value INFO indicates that the severity of the event is informational. | INFO |
source | The source of the event that defines the adapter type. | Replication engine adapter. |
source_system_id | The ID that the source server assigns to the subscription. | Source system ID |
status | The severity of the event. The value OPEN indicates that the severity of the event is open. | OPEN |
subscription_name | The name of the subscription. | Subscription name. For example: PAYROLL |
subscription_state | The state of the subscription. | SUB_STATE_REPL_CONTINUOUS or SUB_STATE_INACTIVE |
sysplex_name | The name of the sysplex on which the event occurred. | Sysplex name |
system_name | The name of the system on which the event occurred. | System name |
taskno | The task number indicates the TCB address of the service task where the event originated. | Task number. For example: 9001272 |
time_stamp | The time at which the replication engine generated the event. | Timestamp, in the format: yyyy-mm-dd-hh.mm.ss.uuuuuu. For example: 2012-02-28-13.42.53.969000 |
transaction_id | The identification of the transaction whose end-to-end apply latency time exceeded the discrete latency threshold. | Transaction ID. For example: '000000000001D730IM1A 54bc6d3f' |
version | The version of the EIF event. | Version. For example: 1. |
workload_down_method | Identifies why the AA_replication_workload_down was entered. | Operator or Failed. |
workload_name | When no value is supplied for the GDPSWORKLOADNAME configuration parameter, the workload_name is set to the subscription name. Otherwise, it contains the value supplied for the GDPSWORKLOADNAME configuration parameter. | Workload name |
workload_type | The type of workload. | Possible values:
|
For additional information about event classes and attributes, see the product information for Tivoli Enterprise Console.