VRF Message Dump (vrfMsgDump)

vrfMsgDump is a utility that works much like the "netdump" example from VR-Link.

The difference is that it also parses VR-Forces messages and prints out the formatted output. This utility can be very useful in debugging VR-Forces applications. You can register your own custom messages using the DtVrfMsgPrinter class (see vrfMsgPrinter.h).

Note

The vrfMsgDump binary distributed with VR-Forces is not license managed to allow simultaneous usage with VR-Forces. If you recompile, it will require a VR-Link license. So be sure to make a backup of the original before you recompile.

The source for vrfMsgDump is in .\appsrc\vrfMsgDumpUser. The executables are in ./bin64. There is an executable for each protocol.

The VRF Data Interaction example demonstrates the following:

• How to register to listen for VRF data interactions.
• How to unpack and print information contained within those interactions.
• How to work with VRF interaction factories.

To run the application:

1. Start VR-Forces.
2. Start vrfMsgDump. vrfMsgDump has command-line options that allow you to set protocol-specific arguments. You can also filter the types of messages that get dumped. For a list of command-line options and descriptions, run vrfMsgDump with the -h command line option.

The contents of all VR-Forces-specific interface messages (such as tasks and set data requests) will be displayed in the vrfMsgDump console window.

DtVrfMsgPrinter

vrfmsgprinter This subclass of DtVrfMessageInterface creates and registers with the various factories to be able to create and print interactions.