SYSTem:COMMunicate:LAN:GATEway
Syntax
SYSTem:COMMunicate:LAN:GATEway <address>
SYSTem:COMMunicate:LAN:GATEway? [{CURRent|STATic}]
Description
This command assigns a Default Gateway for the 34980A. The specified IP Address sets the Default Gateway which allows the instrument to communicate with systems that are not on the local subnet. Thus, this is the Default Gateway where packets are sent which are destined for a device not on the local subnet, as determined by the Subnet Mask setting. Contact your network administrator to determine if a gateway is being used and for the correct address.
If you change the Default Gateway, you must cycle power on the 34980A to activate the new setting. |
Parameters
Name |
Type |
Range of Values |
Default Value |
<address> |
Numeric |
Specified in four-byte dot notation ("nnn.nnn.nnn.nnn"), where "nnn" in each case is a byte value in the range 0 through 255. |
0.0.0.0 (no Gateway) |
Remarks
If DHCP is enabled (see SYSTem:COMMunicate:LAN:DHCP command), the specified Default Gateway is not used. However, if the DHCP server fails to assign a valid IP address, the currently configured Default Gateway will be used.
Dot-notation addresses ("nnn.nnn.nnn.nnn" where "nnn" is a byte value) must be expressed with care, as most web software on the PC will interpret byte values with leading zeros as octal numbers. For example, "255.255.020.011" is actually equivalent to decimal "255.255.16.9" not "255.255.20.11" because ".020" is interpreted as "16" expressed in octal, and ".011" as "9". To avoid confusion, use only decimal expressions of byte values (0 to 255), with no leading zeros.
For example, the 34980A assumes that all dot-notation addresses are expressed as decimal byte values and strips all leading zeros from these byte values. Thus, attempting to set a Default Gateway of "255.255.020.011" will become "255.255.20.11" (a purely decimal expression). Be sure to enter the exact expression, "255.255.20.11", in your PC web software to address the instrument. Do not use "255.255.020.011"– the PC will interpret this address differently due to the leading zeros. A value of "0.0.0.0" indicates that subnetting is not being used.
The Default Gateway 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 Default Gateway address in the form "nnn.nnn.nnn.nnn".
Note that the query command has two optional parameters. Specify "CURRent" (default) to read the dynamic Default Gateway currently being used by the instrument. Specify "STATic" to read the Default Gateway currently stored in non-volatile memory within the instrument (may not be the actual address used by the instrument if DHCP is enabled).
Examples
The following command sets the Default Gateway address.
SYST:COMM:LAN:GATEWAY 255.255.20.11
The following query returns the Default Gateway address currently being used by the instrument (the quotes are also returned).
SYST:COMM:LAN:GATEWAY? CURR or SYST:COMM:LAN:GATEWAY?
Typical Response: "0.0.0.0"
See Also
SYSTem:COMMunicate:LAN:IPADdress