MAK RTIspy API Documentation for HLA 1.3
List of all members | Public Member Functions | Static Public Member Functions | Protected Member Functions
DtChangeLatencyTestModeMsg Class Reference

The DtChangeLatencyTestModeMsg defines a wrapper for the change latency test message used to command an LRC to initiate a latency test, stop a test, or inform it that the we want to observe the test results. More...

+ Inheritance diagram for DtChangeLatencyTestModeMsg:
+ Collaboration diagram for DtChangeLatencyTestModeMsg:

Public Member Functions

 DtChangeLatencyTestModeMsg (DtBufferPtr buffer=DtUSE_INTERNAL_BUFFER)
 Constructors.
 DtChangeLatencyTestModeMsg (const DtNetChangeLatencyTestModeMsg *netRepMsg, DtBufferPtr buffer=DtUSE_INTERNAL_BUFFER)
 DtChangeLatencyTestModeMsg (bool continuous, bool shouldHalt, DtBufferPtr buffer=DtUSE_INTERNAL_BUFFER)
 constructor specifying netHeader variables.
virtual ~DtChangeLatencyTestModeMsg ()
 Destructor.
virtual DtRtiMsgclone (bool copy=true) const
 Return a copy/empty object of the same type as this.
virtual void printData (DtLogicalTimeFactory *logicalTimeFactory) const
 Print the data section.
virtual bool runTest () const
 Set/Get Is this a request to start a new test?
virtual void setRunTest (bool yesNo)
virtual DtFederateHandle initiator () const
 Set/Get handle of the federate to initiate the test.
virtual void setInitiator (DtFederateHandle handle)
virtual bool continuousUpdate () const
 Set/Get Is this request start/stop a continuous test?
virtual void setContinuousUpdate (bool yesNo)
virtual bool shouldHaltContinuous () const
 Set / Get is this halt Continuous msg? Irrelevant if continuousUpdate returns false.
virtual void setShouldHaltContinuous (bool yesNo)
virtual bool observingResults () const
 Set / Get are we observing test results?
virtual void setObservingResults (bool yesNo)
virtual unsigned int interactionPeriod () const
 Set / Get the period between interactions (in ms).
virtual void setInteractionPeriod (unsigned int period)
virtual unsigned int numInteractions () const
 Set / Get the number of interactions to send in this test.
virtual void setNumInteractions (unsigned int num)
virtual unsigned int payloadBytes () const
 Set / Get the number of bytes in the interaction payload.
virtual void setPayloadBytes (unsigned int bytes)
- Public Member Functions inherited from DtRtiMsg
virtual ~DtRtiMsg ()
 Destructor.
virtual DtRtiMsgcloneWithTransport (bool copy=true) const
 Return a copy/empty object of the same type as this using clone and set the transport type from the host message.
virtual DtNetMsgHeadernetHeader () const
 Get header of network representation.
virtual int version () const
 Return the message version.
virtual bool isValidVersion () const
 Returns bool: message version is valid?
virtual void setFedEx (const MAKRti::DtString &name)
 All RTI messages contain information to identify which federation execution the message applies to.
virtual void setFedEx (int handle)
 Set federation execution identifier as a handle.
virtual bool isForExec (const MAKRti::DtString &execName, int execHandle) const
 Returns true if the current message belongs to the indicated federation execution, false otherwise.
virtual DtRtiMsgKind msgKind () const
 Get the message kind.
virtual const char * kindString () const
 Returns the message kind string name.
virtual bool isConstrained () const
 Return boolean: message type can be time constrained?
virtual bool isAllowedDuringSave () const
 Return boolean: message type can be processed during save?
virtual void setTime (const RTI::FedTime &time)
 Set/Get time Used in timestamped messages.
virtual RTI::FedTime const * time (DtLogicalTimeFactory *fedTimeFactory) const
virtual bool hasTime () const
 Returns true if time field is valid.
virtual void setSerialNumber (unsigned long serialNumberValue)
 Set/Get event retraction serial number Used in timestamped messages.
virtual unsigned long serialNumber () const
virtual void setTransportType (DtTransportHandle type)
 Set/Get transport type.
virtual DtTransportHandle transportType () const
virtual DtOrderHandle orderType () const
 This base implementation always returns recieve order.
virtual bool isMetadataPresent () const
 Test if metadata has been added to a DtRtiMsg object.
virtual bool addMetadata (caddr_t *mtdAddr, unsigned int size, unsigned int *alignPad, unsigned int *headerPad=NULL)
 Allocate space for next block of metadata.
virtual void removeMetadata (unsigned int size)
 Update the size of the message when metadata has been removed.
bool isInteractionMsgType () const
 Utility functions, check the message type against known interaciton/update message types.
bool isUpdateMsgType () const
virtual void print (DtLogicalTimeFactory *logicalTimeFactory) const
 Printing functions.
virtual void printHeader (DtLogicalTimeFactory *logicalTimeFactory) const
virtual void printTime (const char *label, RTI::FedTime const *timeValue) const
 Print the given time.
virtual void printInterval (const char *label, RTI::FedTime const *intervalValue) const
 Print the interval.
virtual int status () const
 Returns MSG_STATUS_OK if OK, a reason enumeration otherwise.
virtual const MAKRti::DtString fedExName () const
 These two functions should be avoided in favor of isForExec().
virtual int fedExHandle () const
 Get the federation execution identifier as a handle Returns 0 if the identifier is being represented as a name.
virtual void setFederateHandle (DtFederateHandle handle)
 Set/Get federate handle.
virtual DtFederateHandle federateHandle () const
 Set/Get federate handle.
virtual void setSequenceNumber (unsigned long value)
 Set/Get message sequence number.
virtual unsigned long sequenceNumber () const
 Set/Get message sequence number.
virtual void setServiceCallNumber (unsigned long value)
 Set/Get service call number.
virtual unsigned long serviceCallNumber () const
 Set/Get service call number.
virtual void setTriggerMessageNumber (unsigned long value)
 Set/Get trigger message sequence number (i.e., the message being processed that triggered this message being sent).
virtual unsigned long triggerMessageNumber () const
 Set/Get trigger message sequence number (i.e., the message being processed that triggered this message being sent).

Static Public Member Functions

static DtRtiMsgcreate (const DtNetMsgHeader *initial, DtBufferPtr buffer=DtUSE_INTERNAL_BUFFER)
 Creators.
static DtRtiMsgcreate (DtBufferPtr buffer=DtUSE_INTERNAL_BUFFER)
static void addCallback (DtConnectionMgr *conn, DtChangeLatencyTestModeCb cb, void *usr)
 Adds or removes a callback with the given connection manager for this message type.
static void removeCallback (DtConnectionMgr *conn, DtChangeLatencyTestModeCb cb, void *usr)
- Static Public Member Functions inherited from DtRtiMsg
static const char * kindToString (DtRtiMsgKind kind)
 Returns the name of the message, by kind enumeration.
static const char * kindString (const void *buffer)
 Extracts the message kind from the given buffer and returns its string name.
static void setDefaultRegionSet (unsigned long defaultRegionSet)
 Set the default region set handle.
static void setUse32BitsForValueSize (bool use32BitsForValueSizeEnabled)
 Set/Get flag to enable use of 32 bit size field for attribute/parameter values.
static bool use32BitsForValueSize ()
static void setSmartForwardingEnabled (bool enabled)
 Set/Get is SmartForwarding enabled?
static bool smartForwardingEnabled ()

Protected Member Functions

virtual
DtNetChangeLatencyTestModeMsg
netChangeLatencyTestModeMsg ()
 The network representation for the notify message.
virtual const
DtNetChangeLatencyTestModeMsg
netChangeLatencyTestModeMsg () const
virtual DtRtiMsgKind internalDtRtiMsgKind ()
 Returns the kind of a DtChangeLatencyTestModeMsg message.
virtual int minSize () const
 Returns minimum size of a message, including header.
- Protected Member Functions inherited from DtRtiMsg
 DtRtiMsg ()
 Constructor.
virtual void sizeChanged (int size)
 Called whenever size is changed using changeSize, or insert/deleteBytes.
void initDtRtiMsg (int size, DtRtiMsgKind msgKindVal, DtBufferPtr buffer)
 Called by ctor, so not virtual.
void initDtRtiMsg (const void *initial, int size, DtBufferPtr buffer)
void initDtRtiMsg (const DtNetMsgHeader *header, DtBufferPtr buffer)
virtual void adjustBytes (int offset, int numBytes)
 Adjust numBytes bytes at the indicated offset in the net rep.
virtual void adjustBytes (void *address, int numBytes)
 Adjust the numBytes starting at the indicated addres.

Additional Inherited Members

- Static Public Attributes inherited from DtRtiMsg
static unsigned long theDefaultRegionSetHandle = 0
static const char * theDefaultTag = NULL
- Protected Attributes inherited from DtRtiMsg
DtTransportHandle myTransportType
DtOrderHandle myOrderType
RTI::FedTimemyFedTime
bool myTimeIsValid
bool myConstrained
bool myAllowedDuringSave
unsigned long mySerialNumber
unsigned long myServiceCallNumber
unsigned long myTriggerMessage
- Static Protected Attributes inherited from DtRtiMsg
static bool theUse32BitsForValueSize = false
static bool theSmartForwardingEnabled = false

Detailed Description

The DtChangeLatencyTestModeMsg defines a wrapper for the change latency test message used to command an LRC to initiate a latency test, stop a test, or inform it that the we want to observe the test results.

Constructor & Destructor Documentation

DtChangeLatencyTestModeMsg::DtChangeLatencyTestModeMsg ( DtBufferPtr  buffer = DtUSE_INTERNAL_BUFFER)

Constructors.

References DtRtiMsg::initDtRtiMsg(), internalDtRtiMsgKind(), and minSize().

Referenced by clone(), and create().

DtChangeLatencyTestModeMsg::DtChangeLatencyTestModeMsg ( const DtNetChangeLatencyTestModeMsg netRepMsg,
DtBufferPtr  buffer = DtUSE_INTERNAL_BUFFER 
)
DtChangeLatencyTestModeMsg::DtChangeLatencyTestModeMsg ( bool  continuous,
bool  shouldHalt,
DtBufferPtr  buffer = DtUSE_INTERNAL_BUFFER 
)

constructor specifying netHeader variables.

References DtRtiMsg::initDtRtiMsg(), internalDtRtiMsgKind(), minSize(), setContinuousUpdate(), and setShouldHaltContinuous().

DtChangeLatencyTestModeMsg::~DtChangeLatencyTestModeMsg ( )
virtual

Destructor.

Member Function Documentation

void DtChangeLatencyTestModeMsg::addCallback ( DtConnectionMgr conn,
DtChangeLatencyTestModeCb  cb,
void *  usr 
)
static

Adds or removes a callback with the given connection manager for this message type.

References DtConnectionMgr::addMsgCallback(), and DtChangeLatencyTestModeMsgKind.

Referenced by DtTestManager::postJoinInit().

DtRtiMsg * DtChangeLatencyTestModeMsg::clone ( bool  copy = true) const
virtual

Return a copy/empty object of the same type as this.

Implements DtRtiMsg.

References DtChangeLatencyTestModeMsg(), and netChangeLatencyTestModeMsg().

bool DtChangeLatencyTestModeMsg::continuousUpdate ( ) const
virtual

Set/Get Is this request start/stop a continuous test?

References netChangeLatencyTestModeMsg().

Referenced by printData(), and DtTestManager::processChangeLatencyTestStatus().

DtRtiMsg * DtChangeLatencyTestModeMsg::create ( const DtNetMsgHeader initial,
DtBufferPtr  buffer = DtUSE_INTERNAL_BUFFER 
)
static

Creators.

References DtChangeLatencyTestModeMsg().

DtRtiMsg * DtChangeLatencyTestModeMsg::create ( DtBufferPtr  buffer = DtUSE_INTERNAL_BUFFER)
static
DtFederateHandle DtChangeLatencyTestModeMsg::initiator ( ) const
virtual

Set/Get handle of the federate to initiate the test.

References DtNetChangeLatencyTestModeMsg::initiator, and netChangeLatencyTestModeMsg().

Referenced by printData(), and DtTestManager::processChangeLatencyTestStatus().

unsigned int DtChangeLatencyTestModeMsg::interactionPeriod ( ) const
virtual

Set / Get the period between interactions (in ms).

References DtNetChangeLatencyTestModeMsg::interactionPeriod, and netChangeLatencyTestModeMsg().

Referenced by printData(), and DtTestManager::processChangeLatencyTestStatus().

DtRtiMsgKind DtChangeLatencyTestModeMsg::internalDtRtiMsgKind ( )
protectedvirtual

Returns the kind of a DtChangeLatencyTestModeMsg message.

Implements DtRtiMsg.

References DtChangeLatencyTestModeMsgKind.

Referenced by DtChangeLatencyTestModeMsg().

int DtChangeLatencyTestModeMsg::minSize ( ) const
protectedvirtual

Returns minimum size of a message, including header.

Referenced by DtChangeLatencyTestModeMsg().

DtNetChangeLatencyTestModeMsg * DtChangeLatencyTestModeMsg::netChangeLatencyTestModeMsg ( )
protectedvirtual
const DtNetChangeLatencyTestModeMsg * DtChangeLatencyTestModeMsg::netChangeLatencyTestModeMsg ( ) const
protectedvirtual
unsigned int DtChangeLatencyTestModeMsg::numInteractions ( ) const
virtual

Set / Get the number of interactions to send in this test.

References netChangeLatencyTestModeMsg(), and DtNetChangeLatencyTestModeMsg::numInteractions.

Referenced by printData(), and DtTestManager::processChangeLatencyTestStatus().

bool DtChangeLatencyTestModeMsg::observingResults ( ) const
virtual

Set / Get are we observing test results?

References netChangeLatencyTestModeMsg().

Referenced by printData(), and DtTestManager::processChangeLatencyTestStatus().

unsigned int DtChangeLatencyTestModeMsg::payloadBytes ( ) const
virtual

Set / Get the number of bytes in the interaction payload.

References netChangeLatencyTestModeMsg(), and DtNetChangeLatencyTestModeMsg::payloadBytes.

Referenced by printData(), and DtTestManager::processChangeLatencyTestStatus().

void DtChangeLatencyTestModeMsg::printData ( DtLogicalTimeFactory logicalTimeFactory) const
virtual
void DtChangeLatencyTestModeMsg::removeCallback ( DtConnectionMgr conn,
DtChangeLatencyTestModeCb  cb,
void *  usr 
)
static
bool DtChangeLatencyTestModeMsg::runTest ( ) const
virtual

Set/Get Is this a request to start a new test?

References netChangeLatencyTestModeMsg().

Referenced by printData(), and DtTestManager::processChangeLatencyTestStatus().

void DtChangeLatencyTestModeMsg::setContinuousUpdate ( bool  yesNo)
virtual
void DtChangeLatencyTestModeMsg::setInitiator ( DtFederateHandle  handle)
virtual
void DtChangeLatencyTestModeMsg::setInteractionPeriod ( unsigned int  period)
virtual
void DtChangeLatencyTestModeMsg::setNumInteractions ( unsigned int  num)
virtual
void DtChangeLatencyTestModeMsg::setObservingResults ( bool  yesNo)
virtual
void DtChangeLatencyTestModeMsg::setPayloadBytes ( unsigned int  bytes)
virtual
void DtChangeLatencyTestModeMsg::setRunTest ( bool  yesNo)
virtual
void DtChangeLatencyTestModeMsg::setShouldHaltContinuous ( bool  yesNo)
virtual
bool DtChangeLatencyTestModeMsg::shouldHaltContinuous ( ) const
virtual

Set / Get is this halt Continuous msg? Irrelevant if continuousUpdate returns false.

References netChangeLatencyTestModeMsg().

Referenced by printData(), and DtTestManager::processChangeLatencyTestStatus().


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

Document ID: Generated on Fri Mar 14 19:08:55 EDT 2014 from SVN revision 137085
Copyright © 2005-2014 VT MÄK Inc. All Rights Reserved (www.mak.com)