Application class/Connection Responsiveness.Information method

From LabVIEW Wiki
Jump to: navigation, search
VI Server Method Information
Method ID 7F8
Scope Basic Development Environment
Data Name Conn Responsive.Info
Short Name* Conn Responsive.Info
Long Name* Connection Responsiveness:Information
* Displayed here in English. Short and Long names appear in the language of the LabVIEW IDE.
Owning Class ID 1
Owning Class Name Application Class
Return Data Type No return value
Invoke Node Connection Responsiveness:Information
Available in Real-Time Operating SystemYes
Available in Run-Time EngineYes (Read/Write)
Remote access allowedYes

Gets and sets how often LabVIEW checks if a VI Server connection is responsive.

Set the PingDelay and PingTimeout parameters of this method to configure how LabVIEW checks the connection. If LabVIEW does not receive a message in the time you specify in PingDelay, LabVIEW sends a query to prompt the VI Server network connection for a message. After sending the query, if LabVIEW does not receive a message in the time you specified in PingTimeout, LabVIEW considers the connection unresponsive. Then, all VIs and functions waiting on the connection return network connection error code 1130.

For example, if you set PingDelay to 3000 and PingTimeout to 1000, LabVIEW sends a query to verify the status of the VI Server network connection every time 3 seconds elapse without LabVIEW receiving a message over the connection. If LabVIEW does not receive a reply from the network, LabVIEW waits 1 second before all VIs and functions waiting on the connection return network connection error 1130, which you can handle on the block diagram.

Default for PingDelay and PingTimeout is 10,000 ms, which means LabVIEW checks the connection every 10 seconds and waits up to 10 seconds for the connection to respond.

Note If a network operation times out according to the timeout value you specify in PingTimeout, LabVIEW considers the connection unresponsive but does not close the connection. All current and future calls waiting on the connection return a connection error. LabVIEW does not send another message to query the connection status until LabVIEW considers the connection responsive again. A connection becomes responsive again when LabVIEW receives a message over the connection.

Parameters

Data type Name Required Description
I32 Ping Delay No
I32 Previous Ping Delay No
I32 Ping Timeout No
I32 Previous Ping Timeout No

Uses

History

Version Change(s)
LabVIEW 2018 More info to come.

See Also

External Links