SYSTem Subsystem - I/O Configuration
The SYSTem subsystem includes general instrument configuration commands, I/O locking commands, license management commands, and remote interface configuration commands (listed below).
Command Summary
SYSTem:COMMunicate:ENABle
SYSTem:COMMunicate:GPIB:ADDRess
SYSTem:COMMunicate:LAN:CONTrol?
SYSTem:COMMunicate:LAN:DHCP
SYSTem:COMMunicate:LAN:DNS[{1|2}]
SYSTem:COMMunicate:LAN:DOMain?
SYSTem:COMMunicate:LAN:GATeway
SYSTem:COMMunicate:LAN:HOSTname
SYSTem:COMMunicate:LAN:IPADdress
SYSTem:COMMunicate:LAN:MAC?
SYSTem:COMMunicate:LAN:SMASk
SYSTem:COMMunicate:LAN:TELNet:PROMpt
SYSTem:COMMunicate:LAN:TELNet:WMESsage
SYSTem:COMMunicate:LAN:UPDate
SYSTem:COMMunicate:LAN:WINS[{1|2}]
SYSTem:USB:HOST:ENABle
SYSTem:COMMunicate:ENABle {ON|1|OFF|0}, <interface>
SYSTem:COMMunicate:ENABle? <interface>
Disables or enables the GPIB, USB, or LAN remote interface. Also disables or enables available remote services such as Sockets, HiSLIP, Telnet, VXI11, and the built-in Web Interface.
| {ON|1|OFF|0}. Default: ON. for all interfaces |
0 (OFF) or 1 (ON) |
| <interface>: {GPIB|HISLip|USB|LAN|SOCKets|TELNet|VXI11|WEB|USBMtp|USBHost} |
|
Disable the USB interface:
SYST:COMM:ENAB OFF,USB
|
- After making changes, you must cycle instrument power for the changes to take effect.
- Enabling USBMtp allows you to transfer files, using media transfer protocol (MTP), from the instrument to a PC via the rear-panel USB port. See Utility Menu - I/O Configuration for more information on MTP.
- The USBHost parameter refers to the instrument's front panel USB port.
- If you disable the LAN interface, none of the associated LAN services will be started when you power on the instrument.
- SYSTem:SECurity:IMMediate enables all interfaces except USBMtp.
- For HiSLIP, LAN, SOCKets, TELNet, VXI11, or WEB on the 34460A, you must have option 34460A-LAN or option 3446LANU.
- The interface enable settings are stored in nonvolatile memory. They do not change when power has been off, after a Factory Reset (*RST) or after an Instrument Preset (SYSTem:PRESet).
SYSTem:COMMunicate:GPIB:ADDRess <address>
SYSTem:COMMunicate:GPIB:ADDRess?
Assigns instrument's GPIB (IEEE-488) address, which is displayed at power-on. Each device on the GPIB interface must have a unique address.
| 0 to 30, default 22 |
+15 |
Set GPIB address to 15:
SYST:COMM:GPIB:ADDR 15 |
- Your computer's GPIB interface card has its own address. Avoid using this address for any instrument on the GPIB bus.
- Cycle power for this command to take effect.
- GPIB is enabled or disabled by SYSTem:COMMunicate:ENABle.
- The GPIB interface is an optional feature. See Models and Options for details.
- This setting is non-volatile; it is not changed by power cycling, a Factory Reset (*RST), or an Instrument Preset (SYSTem:PRESet).
- This parameter is set to its default value when the instrument is shipped from the factory and after SYSTem:SECurity:IMMediate.
SYSTem:COMMunicate:LAN:CONTrol?
Reads the initial Control connection port number for Sockets communications. This connection is used to send and receive commands and queries.
| (none) |
5000 (0 if the interface does not support sockets) |
Return the Control connection port number:
SYST:COMM:LAN:CONT? |
- Use the Control socket connection to send a Device Clear (DCL) to the instrument or to detect pending Service Request (SRQ) events.
- On the 34460A, this requires option 34460A-LAN or option 3446LANU.
SYSTem:COMMunicate:LAN:DHCP {ON|1|OFF|0}
SYSTem:COMMunicate:LAN:DHCP?
Disables or enables instrument's use of DHCP. The acronym DHCP stands for Dynamic Host Configuration Protocol, a protocol for assigning dynamic IP addresses to networked devices. With dynamic addressing, a device can have a different IP address every time it connects to the network.
ON: instrument tries to obtain an IP address from a DHCP server. If a DHCP server is found, it assigns a dynamic IP address, Subnet Mask, and Default Gateway to the instrument.
OFF or DHCP unavailable: instrument uses the static IP address, Subnet Mask, and Default Gateway during power-on.
| {ON|1|OFF|0}. Default: ON. |
0 (OFF) or 1 (ON) |
Disable DHCP:
SYST:COMM:LAN:DHCP OFF
SYST:COMM:LAN:UPDate |
- Most corporate LANs have a DHCP server.
- SYSTem:SECurity:IMMediate sets this parameter to its default value.
- On the 34460A, this requires option 34460A-LAN or option 3446LANU.
- If a DHCP LAN address is not assigned by a DHCP server, then an Auto-IP address is obtained after approximately 2 minutes. An Auto-IP address has the form 169.254.nnn.nnn.
- This setting is non-volatile; it is not changed by power cycling, a Factory Reset (*RST), or an Instrument Preset (SYSTem:PRESet).
SYSTem:COMMunicate:LAN:DNS[{1|2}] "<address>"
SYSTem:COMMunicate:LAN:DNS[{1|2}]? [{CURRent|STATic}]
Assigns static IP addresses of Domain Name System (DNS) servers. A primary and a secondary server address may be assigned. If DHCP is available and enabled, DHCP will auto-assign these server addresses. These auto-assigned server addresses take precedence over the static addresses assigned with this command. Contact your LAN administrator for details.
|
Command: "nnn.nnn.nnn.nnn". Default: "0.0.0.0".
Query: {CURRent|STATic}. Default: CURRent.
|
"198.105.232.4" |
Set a static primary DNS address:
SYST:COMM:LAN:DNS "198.105.232.4"
SYST:COMM:LAN:UPD
|
- CURRent: returns address currently being used by the instrument.
- STATic: returns static address from non-volatile memory. This address is used if DHCP is disabled or unavailable.
- SYSTem:SECurity:IMMediate sets this parameter to its default value.
- On the 34460A, this requires option 34460A-LAN or option 3446LANU.
- The assigned DNS server addresses are used if DHCP is disabled or unavailable. Otherwise, the DNS server addresses are auto-assigned by DHCP.
- The DNS server addresses are stored in nonvolatile memory. They do not change when power has been off, after a Factory Reset (*RST) or after an Instrument Preset (SYSTem:PRESet).
SYSTem:COMMunicate:LAN:DOMain?
Returns the domain name assigned to the instrument.
| (none) |
"example.com" |
Return the domain name being used by the instrument:
SYST:COMM:LAN:DOM? |
- If Dynamic Domain Name System (DNS) is available on your network and your instrument uses DHCP, the domain name is assigned by the Dynamic DNS service at power-on.
- A null string ("") indicates that no domain name is assigned.
- On the 34460A, this requires option 34460A-LAN or option 3446LANU.
SYSTem:COMMunicate:LAN:GATeway "<address>"
SYSTem:COMMunicate:LAN:GATeway? [{CURRent|STATic}]]
Assigns a default gateway for the instrument. 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 that are destined for a device not on the local subnet, as determined by the Subnet Mask setting. Contact your LAN administrator for details.
|
Command: "nnn.nnn.nnn.nnn". Default: "0.0.0.0".
Query: {CURRent|STATic}. Default: CURRent.
|
"198.105.232.1" |
Set default gateway address:
SYST:COMM:LAN:GATEWAY "198.105.232.1"
SYST:COMM:LAN:UPD
|
- CURRent: returns address currently being used by the instrument.
- STATic: returns static address from non-volatile memory. This address is used if DHCP is disabled or unavailable.
- SYSTem:SECurity:IMMediate sets this parameter to its default value.
- On the 34460A, this requires option 34460A-LAN or option 3446LANU.
- If DHCP is enabled (SYSTem:COMMunicate:LAN:DHCP ON), the specified default gateway is not used. However, if the DHCP server fails to assign a valid IP address, the currently configured default gateway is used.
- This setting is non-volatile; it is not changed by power cycling, a Factory Reset (*RST), or an Instrument Preset (SYSTem:PRESet).
SYSTem:COMMunicate:LAN:HOSTname "<name>"
SYSTem:COMMunicate:LAN:HOSTname? [{CURRent|STATic}]]
Assigns a hostname to the instrument. A hostname is the host portion of the domain name, which is translated into an IP address. If Dynamic Domain Name System (Dynamic DNS) is available on your network and your instrument uses DHCP, the hostname is registered with the Dynamic DNS service at power-on. If DHCP is enabled (SYSTem:COMMunicate:LAN:DHCP ON), the DHCP server can change the specified hostname.
|
String of up to 15 characters.
Must start with letter (A-Z)
May contain letters, numbers (0-9), or dashes ("-")
Default: "K-<instrument model number>-nnnnn", where nnnnn is the last five digits of the instrument's serial number.
|
"LAB1-34461A" |
|
Define a hostname:
SYST:COMM:LAN:HOST "LAB1-DMM"
SYST:COMM:LAN:UPD
|
- If no hostname exists, a null string ("") is returned.
- On the 34460A, this requires option 34460A-LAN or option 3446LANU.
- For the query form, specify "CURRent" (default) to read the value currently being used by the instrument. Specify "STATic" to read the host name currently stored in nonvolatile memory within the instrument (may not be the actual name used by the instrument if DHCP is enabled).
- This setting is non-volatile; it is not changed by power cycling, a Factory Reset (*RST), or an Instrument Preset (SYSTem:PRESet).
- This parameter is set to its default value when the instrument is shipped from the factory and after SYSTem:SECurity:IMMediate.
SYSTem:COMMunicate:LAN:IPADdress "<address>"
SYSTem:COMMunicate:LAN:IPADdress? [{CURRent|STATic}]]
Assigns a static Internet Protocol (IP) address for the instrument. If DHCP is enabled (SYSTem:COMMunicate:LAN:DHCP ON), the specified static IP address is not used. Contact your LAN administrator for details.
|
Command: "nnn.nnn.nnn.nnn"
Query: {CURRent|STATic}. Default: CURRent.
|
"169.254.149.35" |
Set a static IP address:
SYST:COMM:LAN:IPAD "169.254.149.35"
SYST:COMM:LAN:UPD |
- On the 34460A, this requires option 34460A-LAN or option 3446LANU.
- For the query form, specify "CURRent" (default) to read the value currently being used by the instrument. Specify "STATic" to read the value currently stored in nonvolatile memory within the instrument (may not be the actual address used by the instrument if DHCP is enabled).
- This setting is non-volatile; it is not changed by power cycling, a Factory Reset (*RST), or an Instrument Preset (SYSTem:PRESet).
- This parameter is set to its default value when the instrument is shipped from the factory and after SYSTem:SECurity:IMMediate.
SYSTem:COMMunicate:LAN:MAC?
Returns the instrument's Media Access Control (MAC) address as an ASCII string of 12 hexadecimal characters (0-9 and A-F) enclosed in quotation marks.
|
Your LAN administrator may need the MAC address to assign a static IP address for this device.
|
| (none) |
"0030D3001041" |
Return the MAC address:
SYST:COMM:LAN:MAC? |
- On the 34460A, this requires option 34460A-LAN or option 3446LANU.
- The MAC address is also known as the link-layer address, the Ethernet (station) address, LANIC ID or Hardware Address. This is an unchangeable 48-bit address assigned by the manufacturer to each unique Internet device.
SYSTem:COMMunicate:LAN:SMASk "<mask>"
SYSTem:COMMunicate:LAN:SMASk? [{CURRent|STATic}]]
Assigns a subnet mask for the instrument to use in determining whether a client IP address is on the same local subnet. When a client IP address is on a different subnet, all packets must be sent to the Default Gateway. Contact your LAN administrator for details.
|
Command: "nnn.nnn.nnn.nnn". Default: "255.255.0.0".
Query: {CURRent|STATic}. Default: CURRent.
|
"255.255.255.0" |
Set the subnet mask:
SYST:COMM:LAN:SMAS "255.255.255.0"
SYST:COMM:LAN:UPD |
- On the 34460A, this requires option 34460A-LAN or option 3446LANU.
- If DHCP is enabled (SYSTem:COMMunicate:LAN:DHCP ON), the specified subnet mask is not used. However, if the DHCP server fails to assign a valid IP address, the instrument uses the Auto-IP subnet mask.
- A value of "0.0.0.0" or "255.255.255.255" indicates that subnetting is not being used.
- SYSTem:SECurity:IMMediate sets this parameter to its default value.
- CURRent: returns address currently being used by the instrument.
- STATic: returns static address from non-volatile memory. This address is used if DHCP is disabled or unavailable.
- This setting is non-volatile; it is not changed by power cycling, a Factory Reset (*RST), or an Instrument Preset (SYSTem:PRESet).
SYSTem:COMMunicate:LAN:TELNet:PROMpt "<string>"
SYSTem:COMMunicate:LAN:TELNet:PROMpt?
Sets the command prompt seen when communicating with the instrument via Telnet.
|
String of up to 15 characters
Default is Instrument Model Number: 34460A>, 34461A>, 34465A>, or 34470A>
|
"Command>" |
Set the command prompt:
SYST:COMM:LAN:TELN:PROM "Command>" |
- On the 34460A, this requires option 34460A-LAN or option 3446LANU.
- The instrument uses LAN port 5024 for SCPI Telnet sessions and port 5025 for SCPI Socket sessions.
- Telnet sessions are typically started from a host computer shell:
telnet <IP_address> <port>
For example:
telnet 169.254.4.10 5024
To exit a Telnet session, press <Ctrl-D>.
- This setting is non-volatile; it is not changed by power cycling, a Factory Reset (*RST), or an Instrument Preset (SYSTem:PRESet).
- SYSTem:SECurity:IMMediate sets this parameter to its default value.
SYSTem:COMMunicate:LAN:TELNet:WMESsage "<string>"
SYSTem:COMMunicate:LAN:TELNet:WMESsage?
Sets welcome message seen when communicating with instrument via Telnet.
|
Quoted string of up to 63 characters.
Default: "Welcome to Keysight's <instrument model number> Digital Multimeter"
|
"Welcome to the Telnet Session" |
|
Define a welcome message:
SYST:COMM:LAN:TELN:WMES "Welcome to the Telnet Session"
|
- On the 34460A, this requires option 34460A-LAN or option 3446LANU.
- The instrument uses LAN port 5024 for SCPI Telnet sessions and port 5025 for SCPI Socket sessions.
- This setting is non-volatile; it is not changed by power cycling, a Factory Reset (*RST), or an Instrument Preset (SYSTem:PRESet).
- SYSTem:SECurity:IMMediate sets this parameter to its default value.
SYSTem:COMMunicate:LAN:UPDate
Stores any changes made to the LAN settings into non-volatile memory and restarts the LAN driver with the updated settings.
| (none) |
(none) |
| (see below) |
- On the 34460A, this requires option 34460A-LAN or option 3446LANU.
- Must be sent after changing the settings for DHCP, DNS, gateway, hostname, IP address, subnet mask, or WINS.
- Make all changes to the LAN settings before sending this command.
Example
The following example configures the instrument to use statically assigned LAN settings.
SYST:COMM:LAN:DHCP OFF
SYST:COMM:LAN:DNS "198.105.232.4"
SYST:COMM:LAN:DNS2 "198.105.232.5"
SYST:COMM:LAN:GAT "198.105.232.1"
SYST:COMM:LAN:HOST "LAB1-DMM"
SYST:COMM:LAN:IPAD "198.105.232.101"
SYST:COMM:LAN:SMAS "255.255.255.0"
SYST:COMM:LAN:WINS "198.105.232.4"
SYST:COMM:LAN:WINS "198.105.232.5"
SYST:COMM:LAN:UPD
The following example configures the instrument back to use DHCP.
SYST:COMM:LAN:DHCP ON
SYST:COMM:LAN:UPD
SYSTem:COMMunicate:LAN:WINS[{1|2}] "<address>"
SYSTem:COMMunicate:LAN:WINS[{1|2}]? [{CURRent|STATic}]
Assigns the static IP addresses of the Windows Internet Name System (WINS) servers. A primary and a secondary server address may be assigned. If DHCP is available and enabled, DHCP will auto-assign these server addresses. These auto-assigned server addresses take precedence over the static addresses assigned with this command. Contact your LAN administrator for details.
|
Command: "nnn.nnn.nnn.nnn". Default: "0.0.0.0".
Query: {CURRent|STATic}. Default: CURRent.
|
"198.105.232.4" |
Set a static primary WINS address:
SYST:COMM:LAN:WINS "198.105.232.4"
SYST:COMM:LAN:UPD |
- On the 34460A, this requires option 34460A-LAN or option 3446LANU.
- The WINS addresses are stored in nonvolatile memory. They do not change when power has been off, after a Factory Reset (*RST) or after an Instrument Preset (SYSTem:PRESet).
- SYSTem:SECurity:IMMediate sets this parameter to its default value.
- CURRent: returns address currently being used by the instrument.
- STATic: returns static address from non-volatile memory. This address is used if DHCP is disabled or unavailable.
SYSTem:USB:HOST:ENABle {ON|1|OFF|0}
SYSTem:USB:HOST:ENABle?
Disables or enables the front panel USB host port. Calibration security must be unsecured (CALibration:SECure:STATe <code>,OFF) before sending this command.
| {ON|1|OFF|0}. Default: OFF. |
0 (OFF) or 1 (ON) |
|
Disable the USB host port:
CAL:SEC:STAT OFF,MY_CAL_CODE
SYST:USB:HOST:ENAB OFF
CAL:SEC:STAT ON
|
- This feature requires the SEC licensed option. This option can be ordered as factory option or as customer-installable option. See Models and Options for details. Without this option, the front panel USB interface is always enabled.
- If the front panel USB host port is disabled, it cannot be used to store or load measurements, state files, preferences or other files or to perform firmware update.
- This setting is non-volatile; it is not changed by power cycling, a Factory Reset (*RST), or an Instrument Preset (SYSTem:PRESet).