Pulse Operation - Notification Settings Edit Tab
- Updated2025-07-21
- 2 minute(s) read
Pulse Operation - Notification Settings Edit Tab
Pulse Operation
Use the Pulse operation to notify one or all currently waiting threads. This operation differs from the Set operation because it notifies only the threads already waiting when the Pulse operation occurs. Threads that wait on the notification after a Pulse operation occurs block until you Set or Pulse the notification again. A Pulse operation places the notification in a Cleared state, even if the notification was in a Set state before the Pulse operation. Enable the Pulse option on the left of the Notification Settings panel.
The Pulse operation contains the following options:
- Notification Name or Reference Expression —The notification on which to perform the operation. You can specify the notification by name or by the object reference you receive when you create the notification using the Use Object Reference for the Notification Reference Lifetime option.
- Data Value (optional) —An optional data element to send with the pulse notification. The data can be of any type (number, string, Boolean, object reference, structured type (container), or arrays of these types). When you later wait on the notification, you must store the element into a location of an appropriate type. By default, the notification stores a copy of the data value you specify. However, when you enable the Store Data by Reference Instead of by Value option, the operation stores an ActiveX reference to the value instead. If you later store this reference into an object reference variable in the Wait operation, you can access the data using the TestStand API PropertyObject interface and the ActiveX/COM Adapter.
- Store Data by Reference Instead of by Value —Specifies how to store the data you specify in the Data Value control. Enable the option to store an ActiveX reference to the property. Leave the option disabled to store a copy of the data.
- Notify First Waiting Thread (If Any) and Notify All Waiting Threads (If Any) —Specify whether to notify all currently waiting threads or just the first waiting thread.