arm4::QArmMessageEventGroup Class Reference
[ARM 4.1]

Is a container for an array of QArmMessageEvent instances. More...

Inheritance diagram for arm4::QArmMessageEventGroup:
arm4::QArmInterface

List of all members.

Public Member Functions

 QArmMessageEventGroup (bool endOfFlow=false)
 Constructs a message event group instance.
virtual ~QArmMessageEventGroup ()
 dtor
int clearAllEvents ()
const QArmMessageEventgetEvent (int index) const
bool isEndOfFlow () const
int setEndOfFlow (bool b)
int setEvent (int index, const QArmMessageEvent &event)

Detailed Description

Is a container for an array of QArmMessageEvent instances.

Is a container for an array of QArmMessageEvent instances, plus an End of Flow indicator. It provides a convenient aggregation for providing the set of events to QArmTransaction.

The events are represented as an array of a maximum of 64 QArmMessageEvent instances. There is a further constraint that there can be no more than 32 send events and 32 receive events. For example, there could be 32 send events plus 10 receive events for a total of 42 events, but not 33 send events plus 10 receive events, even though the total number of events (43) is less than 64.

Author:
ARM Working Group of The Open Group, MyARM GmbH
Since:
ARM 4.1

Constructor & Destructor Documentation

arm4::QArmMessageEventGroup::QArmMessageEventGroup ( bool  endOfFlow = false  ) 

Constructs a message event group instance.

Since:
ARM 4.1

Member Function Documentation

int arm4::QArmMessageEventGroup::clearAllEvents (  ) 

is equivalent to executing setEvent(index, null) for all possible index positions.

Returns:
0 on success; otherwise, a non-zero error code is returned
Since:
ARM 4.1
const QArmMessageEvent& arm4::QArmMessageEventGroup::getEvent ( int  index  )  const

retrieves an event at the index.

Parameters:
index index of the event to get.
Since:
ARM 4.1
bool arm4::QArmMessageEventGroup::isEndOfFlow (  )  const
Returns:
the current value.
Since:
ARM 4.1
int arm4::QArmMessageEventGroup::setEndOfFlow ( bool  b  ) 

indicates that the currently executing transaction represents the last processing step in a compound transaction that started in another process. In this case, the stop time of the currently executing transaction can be considered the stop time for the entire compound transaction. The default value is False for each transaction unless it is set to True with this method. It serves no purpose to set this flag to True and pass it to QArmTransaction more than once for a given transaction. setEndOfFlow(false) indicates that this condition does not exist, or at least is not known to exist.

Parameters:
b end of flow status
Since:
ARM 4.1
int arm4::QArmMessageEventGroup::setEvent ( int  index,
const QArmMessageEvent event 
)

inserts an event in the array at the specified index. setEvent(index, QArmMessageEvent::Null) clears the event at that index.

Parameters:
index index to set or clear.
event event to set or clear.
Returns:
0 on success; otherwise, a non-zero error code is returned
Since:
ARM 4.1

The documentation for this class was generated from the following file: