ZCOM Tables and Data Structures

Message Header

This field will contain the ZCOM node number of the system that generated the event message. If the message type is ZCOM_MSTYPE_LSEM, this will contain the local ZCOM node number.

SETIME - Time when the event occurred

This field contains the Coordinated Universal Time (UTC) of when the event occurred. It is taken from the originating system at the time of the event.

SEDATA - Event specific data

Immediately following the header is a union that contains information specific to the type of event that occurred. There are currently two different event types that can be generated. The data structure for each is documented below.

ZCOM_SETYPE_NODE - Node status change event

The node status change event is generated whenever a node changes state or the state of the ZNODE daemon changes. The event data is referenced using sedata.node.<field name> and has the following fields:

Table 3-41

Node Status Change Event Fields (ZCOM_SETYPE_NODE)

 

 

 

 

 

Field Name

 

Field Description

Field Type

Size

 

(Bytes)

 

 

 

 

 

 

 

 

 

NODE_NUM

 

Node Number

uns.short

2

 

 

 

 

 

NSTAT

 

Node status change indicator

char

1

 

 

 

 

 

SPARE

 

Reserved, not used

char

1

 

 

 

 

 

HSTAT

 

Host link status change indicator

char [4]

4

 

 

 

 

 

 

NODE_NUM - Node number

 

 

This is the number of the node that has changed state. Note that this node is different from the SENODE field. For example, in ZCOM node 10, two remote nodes 40 and 50 are defined. In node 10, if the system detects that remote node 40 has gone down, the SEM generated will have SENODE=10, SEDATA.NODE.NODE_NUM=40.

NSTAT - Node status change indicator

120

Chapter 3