SYSTem:COMMunicate:LAN:HOSTname

34980A

SYSTem:COMMunicate:LAN:HOSTname

Syntax

SYSTem:COMMunicate:LAN:HOSTname "<name>"

SYSTem:COMMunicate:LAN:HOSTname? [{CURRent|STATic}]

Description

This command assigns a Host Name to the 34980A. The Host Name is the host portion of the domain name, which is translated into an IP address.

If you change the Host Name, you must cycle power on the 34980A to activate the new setting.

Parameters

Name

Type

Range of Values

Default Value

<name>

Quoted ASCII String

A string of up to 15 characters. The first character must be a letter (A-Z), but the remaining 14 characters can be letters, numbers (0-9), or dashes ("-"). Blank spaces are not allowed.

A-34980A-nnn,
where nnn is the instrument's serial number representation.

Remarks

  • If Dynamic Domain Name System (DNS) is available on your network and your instrument uses DHCP, the Host Name is registered with the Dynamic DNS service at power-on.

  • If DHCP is enabled (see SYSTem:COMMunicate:LAN:DHCP command), the DHCP server can change the specified Host Name.

  • The Host Name 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 reads the Host Name and returns an ASCII string enclosed in double quotes. If a Host Name has not been assigned, a null string ( " " ) is returned.

Note that the query command has two optional parameters. Specify "CURRent" (default) to read the dynamic Host Name currently being used by the instrument. Specify "STATic" to read the Host Name currently stored in non-volatile memory within the instrument (may not be the actual name used by the instrument if DHCP is enabled).

Examples

The following command defines a Host Name.

SYST:COMM:LAN:HOST "LAB1-34980A"

The following query returns the Host Name currently being used by the instrument (the quotes are also returned).  

SYST:COMM:LAN:HOST? CURR   or   SYST:COMM:LAN:HOST?

Typical Response:  "LAB1-34980A"

See Also

SYSTem:COMMunicate:LAN:DHCP

SYSTem:COMMunicate:LAN:DOMain