VI Server Refnums Lifetime

Introduced a "VI Refnum Lifetime" enumeration which can take values "Destroy on Exit", " Destroy on Actor Exit ", and “Destroy on Application Exit” (Feature #3). This enumeration dictates the lifetime strategy adopted for the VI Server Refnum of the Async Method. In the first case the "Async Methods Actor" destroys the reference as soon as the Async Method exits, in the second case the VI Refnums will be destroyed once the “Async Method Actor” exits, while in the last case, VI Refnums are never destroyed. “Destroy on Exit” is the default option when un-wired. The motivation for this setting is related to the required lifetimes of the refnums (e.g. notifier’s references) created within the Async Method. This lifetime is the same as the VI Refnum lifetime, hence if we want they outlive the execution of the Async Method we have to set it to either “Destroy on Actor Exit” or “Destroy on Application Exit”. This option applies only to Async Methods called with the “Call and Collect” option.

Author: AndreaV-Lsi

Async Methods Actor Example/Async Methods Actor Example Messages/VI Refnum Lifetime Test Msg/Do.vi

@@ -11,6 +11,7 @@
 		<Item Name="Async Messages" Type="Folder">
 			<Item Name="Alternative Long Execution Method Msg.lvclass" Type="LVClass" URL="../Async Methods Actor Example Messages/Alternative Long Exec Meth Msg/Alternative Long Execution Method Msg.lvclass"/>
 			<Item Name="Long Execution Method Msg.lvclass" Type="LVClass" URL="../Async Methods Actor Example Messages/Long Execution Method Msg/Long Execution Method Msg.lvclass"/>
+			<Item Name="VI Refnum Lifetime Test Msg.lvclass" Type="LVClass" URL="../Async Methods Actor Example Messages/VI Refnum Lifetime Test Msg/VI Refnum Lifetime Test Msg.lvclass"/>
 		</Item>
 		<Item Name="Ack Completion Long Exec Meth Msg.lvclass" Type="LVClass" URL="../Async Methods Actor Example Messages/Ack Completion Long Exec Meth Msg/Ack Completion Long Exec Meth Msg.lvclass"/>
 		<Item Name="Cancel Long Exec MetH Msg.lvclass" Type="LVClass" URL="../Async Methods Actor Example Messages/Cancel Long Execution Methods Msg/Cancel Long Exec MetH Msg.lvclass"/>

Async Methods Actor Example/Async Methods Actor Example Messages/VI Refnum Lifetime Test Msg/Send VI Refnum Lifetime Test.vi

@@ -1,9 +1,10 @@
 Async Methods Actor Release Notes
-
+v0.3.0
+- Introduced a "VI Refnum Lifetime" enumeration which can take values "Destroy on Exit", " Destroy on Actor Exit ", and “Destroy on Application Exit”. This enumeration dictates the lifetime strategy adopted for the VI Server Refnum of the Async Method. In the first case the "Async Methods Actor" destroys the reference as soon as the Async Method exits, in the second case the VI Refnums will be destroyed once the “Async Method Actor” exits, while in the last case, VI Refnums are never destroyed. “Destroy on Exit” is the default option when unwired. The motivation for this setting is related to the required lifetimes of the refnums (e.g. notifier’s references) created within the Async Method. This lifetime is the same as the VI Refnum lifetime, hence if we want they outlive the execution of the Async Method we have to set it to either “Destroy on Actor Exit” or “Destroy on Application Exit”. This option applies only to Async Methods called with the “Call and Collect” option.
 v0.2.0
 - Added an infrastructure that enables the caller of Async Message to be informed about the completion of "Call and Collect" Async methods
 - Now every executed Async Message is identified by a GUID
 - It is now possible to choose a communication method (notifiers or event) by which a subscriber can be informed about currently running "Call and Collect" Async methods and launched running "Call and Forget" Async methods. The communication is off by default
 - Completed and updated README.md documentation and methods/properties docstrings
 v0.1.0
-- Initial public release
+- Initial public release