SYSTem:COMMunicate:LAN:KEEPalive

34980A

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
MAX = 32,000,000 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