SYSTem:COMMunicate:LAN:HOSTname

From Keysight 34970A/34972A

previous page next page

SYSTem:COMMunicate:LAN:HOSTname

This functionality is available on the 34972A only.

Syntax

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

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

Description

This command assigns a host name to the instrument. 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 execute a SYSTem:COMMunicate:LAN:UPDate command to activate the setting.

Parameters

Name Type Range of Values Default Value

<name> Quoted ASCII String A string of up to 45 characters. The first character must be a letter (A-Z), but the remaining 44 characters can be letters, numbers (0-9), or dashes ("-"). Blank spaces are not allowed.
This is a required parameter.

The LXI reset value is A-34970A-nnnnn or A-34972A-nnnnn, where nnnnn is the last 5 digits in the instrument's serial number.

Name	Type	Range of Values	Default Value
<name>	Quoted ASCII String	A string of up to 45 characters. The first character must be a letter (A-Z), but the remaining 44 characters can be letters, numbers (0-9), or dashes ("-"). Blank spaces are not allowed.	This is a required parameter. The LXI reset value is A-34970A-*nnnnn* or A-34972A-*nnnnn, where nnnnn* is the last 5 digits in the instrument's serial number.

Remarks

If Dynamic Domain Name System (DDNS) 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 assign a different name if the requested name is already in use on the network.
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 reads the host name and returns an ASCII string enclosed in double quotes. If a host name has not been assigned, the query returns a null string ("").

Note that the query version of the command has two optional parameters. Specify "CURRent" (default) to read the host name that the instrument is currently using. Specify "STATic" to read the desired host name currently stored in non-volatile memory within the instrument (which may not be the actual name currently in use on the network).

Examples

The following command defines a host name.

SYST:COMM:LAN:HOST "LAB1-34970A" SYST:COMM:LAN:UPDate

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-34970A"

SYSTem:COMMunicate:LAN:HOSTname