Last updated: 2010-04-21
The uppercase letters of a mnemonic represent the short form of the mnemonic, whereas the long form of a mnemonic is the short form followed by the lowercase letters. The test set accepts either the long form or the short form of the mnemonic.
The mnemonics that are inside square brackets are optional. That is, a command operates the same whether or not the mnemonic in square brackets is used in the command.
A vertical bar, |, implies choices. When mnemonics are listed in parentheses separated by vertical bars ( | ), you must choose one of the mnemonics inside the parentheses.
Complex commands are valuable because they set the state of the parameter and a value for that parameter. For example, a command that contains the mnemonic [:SAMPlitude] is a complex command that sets the state to ON as well as the amplitude. You can use parameters such as amplitude, frequency, gain, number, time, and value as a complex command. Refer to the specific command for the parameter that applies.
num value |
Integer, float or scientific values. For example, CALL:POWer -55.5 CALL:POWer -5.55E+001 CALL:CHANnel 525 |
string |
Characters. The string will often need to be enclosed in single or double quotes, depending upon your programming environment. For example, CALL:CIDentity "#0123456789*" CALL:UPLink:PRAChannel:ASUBchannels '111111111111' The string returned by the test set is enclosed by double quotes. |
choice1|choice2|choice3 |
Specific character choices. For example, CALL:OPERating:MODE D2KTest SYSTem:COMMunicate:GPIB:DEBug ON |
Some commands have optional units of measurement. These are displayed in square brackets. If no units are specified in the command then the default unit in bold font below is used. The test set accepts the specified unit either with or without a space inserted between the <num value> and the unit (for example, both 10S and 10 S are valid). The following table summarizes the units available.
Description |
Optional Units |
Example |
Amplitude (linear) |
V|MV |
To set the spectrum monitor's timeout interval to 20 seconds, use any of the following formats:
SETup:SMONitor:TIMeout:TIME 20 SETup:SMONitor:TIMeout:TIME 20S SETup:SMONitor:TIMeout:TIME 20 S |
Power (logarithmic) |
DBM|DBW |
|
Level (relative) |
DB |
|
Frequency |
HZ|KHZ|MHZ|GHZ |
|
Time |
S|MS|US|NS |
|
Percentage |
PCT |
The [:SELected] Mnemonic is an optional mnemonic that implies a current selection on the test set. Often there are other mnemonics that can be used in place of the [:SELected] mnemonic to configure a setting that is not the currently selected configuration on the test set. The mnemonics that can replace the [:SELected] mnemonic are listed in parentheses separated by vertical bars ( | ) in the description table title.
When the setting and query values of a GPIB command are strings, a single quote is needed around the strings when setting the command, while the test set returns the result in double quoted strings when querying.