SYSTem:COMMunicate:LAN:KEEPalive
Syntax
SYSTem:COMMunicate:LAN:KEEPalive {<seconds>|MIN|MAX}
SYSTem:COMMunicate:LAN:KEEPalive? [{MIN|MAX}]
Description
This command sets the LAN keepalive timeout which specifies a number of seconds to keep a LAN socket active. If there has been no activity on the connection after the specified timeout, the instrument will send keepalive probes to the client to determine if it is still available. After the specified timeout, the connection will be marked as "down" or "dropped".
If you specify a timeout value, it is recommended that you use the largest value that still meets the application's need for unreachable client detection. Smaller timeout values will generate more keepalive probes thus using more of the available network bandwidth. |
Parameters
Name |
Type |
Range of Values |
Default Value |
<seconds> |
Numeric |
Desired timeout in seconds between 600 seconds and 32,000,000 seconds, or 0 (no timeout). MIN = 600 seconds |
1,800 seconds (30 minutes) |
Remarks
If you specify a value of "0", no timeout is set; the instrument will wait indefinitely and will not send any keepalive probes to the client.
For the <seconds> parameter, you can substitute MIN or MAX for a numeric value. MIN selects the smallest value accepted; MAX selects the largest value accepted.
The timeout is stored in non-volatile memory, and does not change when power has been off, after a Factory Reset (*RST command), or after an Instrument Preset (SYSTem:PRESet command).
Return Format
The query command returns the current timeout in seconds.
Examples
The following command sets the timeout to 2,700 seconds (45 minutes).
SYST:COMM:LAN:KEEP 2.7E+03
The following query returns the timeout currently being used.
SYST:COMM:LAN:KEEP?
Typical Response: +2.70000000E+03