Converting an Existing DQMH Event

To convert an existing event:

Go to Tools  DQMH Consortium  DQMH  Event  Convert DQMH Event….

Image

  1. Select the DQMH Module containing the event you wish to convert. This drop down menu will only list valid DQMH modules found within the project.

  2. Specify the event you wish to convert. This drop down menu will let you select between all the request events in the module.

Several requests are considered part of the DQMH core, and cannot be converted:

  • Show Module Panel.vi

  • Hide Module Panel.vi

  • Get Module Execution Status.vi

  • Stop Module.vi

  1. Specify the new type of event (Request and Wait for Reply or Round Trip).

Any custom code within the Event VI will be overwritten. Ensure you have copied any custom code from this VI before clicking OK. The Event VI is the VI named after the request event that you chose to convert.
A new frame will be added to the Message Handling Loop of the module Main VI for the specified event. The Module Main VI will be broken until you remove the old frame. This is done so you can copy any code you want to preserve from the old frame to the new frame.

  1. Click OK and the specified event will be converted to the new type.

Image

  1. If you specify a Request and Wait for Reply event, your only choice is to convert it to a Round Trip event. For Round Trip events, you must provide the name for the new Broadcast event that will be created as part of the new Round Trip event.

    • In the DQMH Module Main.vi:

      • Open the block diagram and find the event frame configured for this request.

      • Verify that the request event is now a request and wait for reply event and has a Wait for Notifier and a Wait for Reply node and they are both wired to the bundle message data.

      • There are now two cases associated with <request name> in the MHL case structure, one will have a #Code_Review_Todo tag indicating that the Delacor tools converted this request into a request and wait for reply or Round trip and that you need to copy any custom code from this case to the new case. Once you have moved any custom case, right-click on the case structure, and select Delete This Case.

      • Go to the new case associated with <request name> in the MHL case structure and verify that the error argument is wired and that the code behaves as expected.

      • Right click on the reply argument cluster and open the associated typedef. Edit the <request name>(Reply Payload)–cluster.ctl to include the arguments you want the request and wait for reply to return.

      • Save the reply payload cluster and complete the code within the MHL case.

    • In the Tester VI:

      • Open the block diagram and find the event frame configured to test calling this request.

      • Decide how you want to display the new reply and whether you want to wire the new wait for reply (T) input.