proceed beyond a caution sign
until the indicated conditions
are fully understood and met.
No part of this manual may be
reproduced in any form or by
any means (including electronic storage and retrieval or
translation into a foreign language) without prior agreement and written consent from
Agilent Technologies, Inc. as
governed by United States and
international copyright lays.
Manual Part Number
08703-90058
Edition
July 2004
Printed in Malaysia
Agilent Technologies, Inc.
Digital Signal Analysis
1400 Fountaingrove Parkway
Santa Rosa, CA 95403, USA
Warranty
The material contained in this
document is provided “as is,”
and is subject to being
changed, without notice, in
future editions. Further, to the
maximum extent permitted by
applicable law, Agilent disclaims all warranties, either
express or implied, with regard
to this manual and any information contained herein,
including but not limited to the
implied warranties of merchantability and fitness for a
particular purpose. Agilent
shall not be liable for errors or
for incidental or consequential
damages in connection with
the furnishing, use, or performance of this document or of
any information contained
herein. Should Agilent and the
user have a separate written
agreement with warranty
terms covering the material in
this document that conflict
with these ter ms, th e warra nty
terms in the separate agreement shall control.
WARNING
Warning denotes a hazard. It
calls attention to a procedure
which, if not correctly performed or adhered to, could
result in injury or loss of life.
Do not proceed beyond a
warning sign until the indicated conditions are fully
understood and met.
Restricted Rights Legend.
Use, duplication, or disclosure
by the U.S. Government is subject to restrictions as set forth
in subparagraph (c) (1) (ii) of
the Rights in Technical Data
and Computer Software clause
at DFARS 252.227-7013 for
DOD agencies, and subparagraphs (c) (1) and (c) (2) of
the Commercial Computer
Software Restricted Rights
clause at FAR 52.227-19 for
other agencies.
Safety Notices
CAUTION
Caution denotes a hazard. It calls
attention to a procedure
which, if not correctly performed or adhered to, could
result in damage to or destruction of the product. Do not
2
Contents
1.Introduction to Instrument Control
Introduction to Instrument Control 1-2
Instrument Control using the VXIplug&play Driver 1-3
Instrument Control using BASIC 1-9
2.Alphabetical Command Reference
Alphabetical Command Reference 2-2
Keys to Programming Commands 2-3
Programming Commands 2-14
8703A Commands Not Supported in the 8703B 2-76
3.Command Listings
Alphabetical List of Commands 3-2
OPC-Compatible List of Commands 3-4
Data Processing Chain 6-2
Data Arrays 6-2
Common Output Commands 6-3
Fast Data Transfer Commands 6-4
Data Levels 6-4
Learnstring and Calibration-Kit String 6-5
7.Error Reporting
Error Reporting 7-2
Status Reporting 7-3
The Status Byte 7-6
Contents-1
Contents
The Event-Status Register and Event-Status Registers B and L 7-7
Error Output 7-8
Error Messages in Numerical Order 7-9
8.Programming Examples
Example Programs 8-2
Measurement Process 8-3
Programming Examples 8-5
Measurement Setup Examples 8-9
Measurement Calibration Examples 8-26
Measurement Data Transfer Examples 8-63
Measurement Process Synchronization Examples 8-74
Analyzer System Setup Examples 8-84
List-Frequency and Limit-Test Table Examples 8-92
Report Generation Examples 8-106
Limit Line and Data Point Special Functions 8-125
Contents-2
1
Introduction to Instrument Control1-2
Instrument Control using the VXIplug&play Driver1-3
Instrument Control using BASIC1-9
Introduction to Instrument Control
Introduction to Instrument Control
Introduction to Instrument Control
Introduction to Instrument Control
In this chapter, you can find an introduction to the remote operation of your analyzer using an
external controller. You should be familiar with the operatio n of the analyz er before at tempting to
remotely control the analyzer over the Gener al Purpose Int erface B us (GPIB). Ref er to the user ’s
guide for operating information. For information on the instrument’s preset state and memory
allocation, refer to the 8703B Lightwave Component Analyzer Reference manual.
This manual is not intended to teach programming or to discuss GPIB theo ry except at an
introductory level. Programming examples that demonstrate the remote operation of the
analyzer are documented in Chapter 8, “Programming Examples” and are also provided o n the
CD-ROM that was shipped with this manual. All example programs are provided in BASIC, and
most are also provided in Visual C++ and Visual BASIC for use with the VXIplug&play driver.
1-2
Introduction to Instrument Control
Instrument Control using the VXIplug&play Driver
Instrument Control using the VXIplug&play Driver
VXIplug&play is a term indicating conformance to a set of system-level standards produced by
the VXIplug&play Systems Alliance. The charter of the alliance was “to improve the
effectiveness of VXI-based solutio ns by increasing ease-of-use and improving the interoperability
of multi-vendor VXI systems.”
Installing the VXIplug&play driver on your computer will allow you to control the analyzer via
common programming environments without having to learn the instrument-specific mne monics.
Requirements
The VXIplug&play driver for your analyzer is designed for a PC operating Windows 95 or
Windows NT version 3.51 or higher. The driver requires a virtual instrument software
architecture (VISA)-compatible GPIB interface, and the VISA I/ O Library version 1.1 or higher.
The driver is compatible with the following programming environments:
• Microsoft Visual Basic, version 4.0 o r higher
• Microsoft Visual C++, version 4.0 or higher
• Borland C++, version 4.5 or higher
• Agilent VEE, version 3.2 or higher
• National Instruments LabWindows/CVI, version 4.0.1 or higher
• National Ins truments LabVIE W, version 4.0.1 or high e r
Installing the VXIplug&play Driver
NOTEThis procedure assumes that you have installed a VISA-compatible GPIB interface
and the VISA I/O library, version 1.1 or higher. It also assumes that you have
installed—and are familiar with—one of the programming environments listed
above.
1. The install program for t he VXIplug&play driver for your analyzer is located in the root
directory of the CD-ROM that accompanied this manual. The file is titled “875x.exe”
a. If you need to order a new CD-ROM, contact Agilent Technologies and order part number
08703-10202.
b. You can also download the file from the Web. Go to http://www.tm.agilent.com and follow
the “Software and Driver” and “Instrument Driver” links.
2. Run “875x.exe” to install the VXIplug&play driver on your computer. The default directory
that is used by the install-shield is vxipnp\winxx\875x, where winxx designates the operating
system in use by your computer, such as winnt, win95, etc.
3. If you have difficulty installing the VXIplug&play driver, contact Agilent Te chnologies by
calling the nearest sales or service office.
1-3
Introduction to Instrument Control
Instrument Control using the VXIplug&play Driver
System Setup
1. Use an GPIB interconnect cable (such as 10833A/B/C/D) to connect the analyzer to the GPIB
interface card on your computer.
2. Switch on the computer.
3. Switch on the analyzer.
a. To verify the analyzer's address, press:
Local, SET ADDRESSES, ADDRESS: 8703
The analyzer has only one GPIB interface, though it occupies two addresses: one for the
instrument and one for the display. The display address is equal to the instrument address
with the least-significant bit incremented. The display address is automatically set each
time the instrument address is set.
The default analyzer addresses are:
—16 for the instrument
—17 for the display
CAUTIONOther devices connected to the bus cannot occupy the same address as the
analyzer or the display.
The analyzer should now be displaying t he instrument's address in the upper right section
of the display. If the address is not 16, return the address to its default setting (16) by
pressing:
16, x1, Preset
b. Set the system control mode to either “pass-control” or “talker/listener” mode. These are
the only control modes in which the analyzer will accept commands over GPIB. To set the
system-control mode, press:
Local, TALKER/LISTENER
or
Local, USE PASS CONTROL
1-4
Introduction to Instrument Control
Instrument Control using the VXIplug&play Driver
Verifying the Bus Connection
Check the interface bus connection and operation by following the appropriate procedure (for
the type of interface card you are using) below.
Interface Bus Verification Procedure (GPIB Interface Card)
1. Check the bus connection by running the VISA Assistant in the I/O Libraries. The VISA
Assistant will automatically report what it finds on the bus. Notice that the VISA Assistant is
reporting instruments at addresses 16 and 17. As mentioned earlier, these addresses
designate the instrument and its display, respectively.
Figure 1-1.VISA Assistant Window
2. To further verify GPIB operation, send a preset command to the analyzer by doing the
following in the VISA Assistant window:
a. Single-click on “GPIB0::16::INSTR” to highlight it.
b. Make sure that the “Formatted I/O” tab is selected.
c. Enter PRES; in the text box.
d. Click on “viPrintf.”
e. This command should preset the analyzer. If an instrument preset does not occur, there is
a problem. Check all GPIB address settings and physical connections. Most GPIB probl ems
are caused by an incorrect address or faulty/loose GPIB cables.
1-5
Introduction to Instrument Control
Instrument Control using the VXIplug&play Driver
Interface Bus Verification Procedure (National Instruments Card)
1. Check the bus connection by running Win32 VISA Interactive Control. When this program is
run, it automatically reports what it finds on the bus. Notice that the program is reporting
instruments at addresses 16 and 17. As mentioned earlier, these addresses designate the
instrument and its display, respectively.
Figure 1-2.Win32 VISA Interactive Control Window: Bus Report
2. To further verify GPIB operation, double click on “GPIB0::16::INSTR” and then perform the
following steps.
a. Make sure that the “Basic I/O” tab is selected.
b. Click on the “Write” tab.
c. Enter PRES; in the “Buffer” text box.
d. Click on “Execute.”
e. This command should preset the analyzer. If an instrument preset does not occur, there is
a problem. Check all GPIB address settings and physical connections. Most GPIB probl ems
are caused by an incorrect address or faulty/loose GPIB cables.
1-6
Instrument Control using the VXIplug&play Driver
Figure 1-3.Win32 VISA Interactive Control: Sending a Command
Introduction to Instrument Control
Controlling the Analyzer with the VXIplug&play Driver
The “Programming Examples” CD-ROM that was shipped with this manual includes many
example programs that can be used to control your analyzer . The fol lowing sections provide some
information on using the VXIplug&play driver with the Visual C++ and Visual BASIC
programming environment s.
Using Visual BASIC to Control the Analyzer
When using Visual BASIC, you will need to include the two fil es listed below in your proje ct. They
were installed on your computer in the following directories when you installed the driver:
• \vxipnp\winxx\875x\875x.bas
• \vxipnp\winxx\include\visa32.bas
NOTEThe directories shown above are the default locations for these files. (“winxx”
indicates the operating system you are using, such as winnt, win95, etc.) If you
designated a different path during installation, you will need to amend the path
above to include the specific path that you indicated during installation.
1-7
Introduction to Instrument Control
Instrument Control using the VXIplug&play Driver
Using Visual C++ to Control the Analyzer
When using Visual C++, you will need to include the file listed below in your pro ject . The file was
installed on your computer in the following directory when you installed the driver:
\vxipnp\winxx\lib\msc\875x_32.lib
NOTEThe directory shown above is the default location for this file. (“winxx” indicates
the operating system you are using, such as winnt, win95, etc.) If you designated a
different path during installation, you will need to ame nd the path above to include
the specific path that you indicated during installation.
1-8
Introduction to Instrument Control
Instrument Control using BASIC
Instrument Control using BASIC
This section describes how to control the analyzer using BASIC 6.2 (or higher), or BASIC for
Windows 6.3 (or higher) on one of the following computers:
• HP 9000 Series 200/300
• HP 9000 Series 700 with BASIC-UX
• PC with a GPIB interface card installed
.
Table 1-1. Additional BASIC 6.2 Programming Information
Description Agilent
Part Number
BASIC 6.2 Programming Guide98616-90010
BASIC 6.2 Language Reference (2 Volumes)98616-90004
Using BASIC for Instrument Control, Volume I82303-90001
Using BASIC for Instrument Control, Volume II82303-90002
BASIC for Windows Manual SetE2060-90100
Table 1-2. Additional GPIB Information
Description Agilent
Part Number
BASIC 6.2 Interface Reference98616-90013
Tutorial Description of the General Purpose Interface Bus5021-1927
Required Equipment
• Computer running BASIC 6.2 (or higher) or BASIC for Windows 6.3 (or higher)
• Supported GPIB interface card
• GPIB interconnect cables (such as 10833A/B/C/D)
System Setup and GPIB Verification
1. Connect the analyzer to the computer with an GPIB cable.
1-9
Introduction to Instrument Control
Instrument Control using BASIC
Figure 1-4.The Analyzer System with Controller
2. Switch on the computer, and launch BASIC or BASIC for Windows.
3. Switch on the analyzer.
a. To verify the analyzer's address, press:
Local, SET ADDRESSES, ADDRESS: 8703
The analyzer has only one GPIB interface, though it occupies two addresses: one for the
instrument and one for the display. The display address is equal to the instrument address
with the least-significant bit incremented. The display address is automatically set each
time the instrument address is set.
The default analyzer addresses are:
—16 for the instrument
—17 for the display
CAUTIONOther devices connected to the bus cannot occupy the same address as the
analyzer.
The analyzer displays the instrument's address in the upper right section of the display. If
the address is not 16, return the address to its default setting (16) by pressing:
16, x1, Preset
1-10
Introduction to Instrument Control
Instrument Control using BASIC
b. Set the system control mode to either “pass-control” or “talker/listener” mode. These are
the only control modes in which the analyzer will accept commands over GPIB. To set the
system-control mode, press:
Local, TALKER/LISTENER
or
Local, USE PASS CONTROL
4. Check the interface bus by performing a simple command from the computer controller. Type
the following command on the controller:
OUTPUT 716;”PRES;”
Execute, or Return
NOTEHP 9000 Series 300 computers use the Return key as both execute and enter. Some
other computers may have an
function. For reasons of simplicity, the notation
Enter, Execute, or Exec key that performs the same
Return is used throughout this
document.
This command should preset the analyzer. If an instrument preset does not occur, there is a
problem. Check all GPIB addresses and connections. Most GPIB problems are caused by an
incorrect address or faulty/loose GPIB cables.
1-11
Introduction to Instrument Control
Instrument Control using BASIC
Sending Commands
A remote controller can manipulate the functions of the analyzer by sending commands to the
analyzer via the General Purpose Interface Bus (GPIB). The commands used are specific to the
analyzer. Remote commands executed over the bus take precedence over manual commands
executed from the instrument's fr ont pane l. R em ote co mmands are executed as soon as they are
received by the analyzer. A command only applies to the active channel (except in cases where
functions are coupled between channel s). Most commands are equivalent to front-pane l hardkeys
and softkeys.
Command Structure in BASIC
Consider the following BASIC command for setting the analyzer's start frequency to 50 MHz:
OUTPUT 716;”STAR 50 MHZ;”
The command structure in BASIC has several different elements:
the BASIC command statement OUTPUT - The BASIC data-output statement.
the appendage 716 - The data is directed to interface 7 (GPIB), and
on to the device at address 16 (the analyzer). This
appendage is terminated with a semicolon. The next
appendage is STAR, the instrument mnemonic for
setting the analyzer's start frequency.
data 50 - a single operand used by the root mnemonic STAR
to set the value.
unit MHZ - the units that the operand is expressed in.
terminator ; - indicates the end of a command, enters the data,
and deactivates the active-entry area.
The “STAR 50 MHZ;” command performs the same function as pressing the following keys on
the analyzer's front panel:
Start, 50, M/u
STAR is the root mnemonic for the start key, 50 is the data, and MHZ are the units. Where possible,
the analyzer's root mnemonics are derived from the equivalent key label. Otherw ise they are
derived from the common name for the function. Chapter 2, “Alphabetical Command Reference”
lists all the root mnemonics and all the different units accepted.
The semico lon (;) following MHZ terminates the command within the analyzer. It removes start
frequency from the active-entry ar ea, and prep ares the analyzer f or the next co mmand. If the re is
a syntax error in a command, the analyzer will ignore the comm and and look for the next
terminator. When it finds the next terminator, it starts processing incoming commands normally.
Characters between the syntax error and the next terminator are lost. A line feed also acts as a
terminator. T he BASIC OUTPUT statement transmits a carriage return/line feed following the data.
This can be suppressed by putting a semicolon at the end of the statement.
1-12
Introduction to Instrument Control
Instrument Control using BASIC
The OUTPUT 716; statement will transmit all items listed (as long as they are separated by
commas or semicolons) including:
• literal information enclosed in quotes
• numeric variables
•string variables
•arrays
A carriage return/line feed is transmitted after each item. Again, this can be suppressed by
terminating the commands with a semicolon. The analyzer automatically goes into remote mode
when it receives an OUTPUT command from the controller. When this happens, the front-panel
remote (R) and listen (L) GPIB status indicators illuminate. In remote m ode, the analyzer ignores
any data that is input with the front-panel keys, w ith the exception of
Local. Pressing Local,
returns the analyzer to manual operation, unless t he universal GPIB command LOCAL LOCKOUT
7 has been issued. There are two ways to exit from a local lockout. Either issue the LOCAL 7
command from the controller or cycle the line power o n the analyzer.
Setting a parameter such as start frequency is just one form of command the analyzer will accept.
It will also accept simple commands that require no operand at all. For example, execute:
OUTPUT 716;"AUTO;"
In response, the analyzer autoscales the active channel. Autoscale only applies to the active
channel, unlike start frequency, which applies to both channels as long as the channels are
stimulus-coupled.
The analyzer will also accept commands that switch various f unctions on and off. For example, to
switch on dual-channel display, execute:
OUTPUT 716;"DUACON;"
DUACON is the analyzer root mnemonic for “dual-channel display on.” This causes the analyzer to
display both channels. To go back to single-channel display mode, for example, switching off
dual-channel display, execute:
OUTPUT 716;"DUACOFF;"
The construction of the command starts with the root mnemonic DUAC (dual-channel display)
and ON or OFF is appended to the root to form the entire command.
The analyzer does not distinguish between upper- and lower-case letters. For example, execute:
OUTPUT 716;"auto;"
NOTEThe analyzer also has a debug mode to aid in troubleshooting systems. W h en the
debug mode is ON, the analyzer scrolls incoming GPIB commands across the
display. To manually activate the debug mode, press
Local, GPIB DIAG ON. To
deactivate the debug mode from the controller, execute:
OUTPUT 716;"DEBUOFF;"
Command Query
Suppose the operator has changed the power level from the front panel. The computer can find
1-13
Introduction to Instrument Control
Instrument Control using BASIC
the new power level using the analyz er's command-query function. If a question mark is
appended to the root of a command, the analyzer will output the value of that function.
For instance, POWE 7 DB; sets the analyzer's output power to 7 dB, and POWE?; outputs the
current RF output power at the test port to the system controller. For example:
Type SCRATCH and press
Type EDIT and press
10 OUTPUT 716;"POWE?;"
20 ENTER 716;Reply
30 DISP Reply
40 END
Return, to clear old programs.
Return, to access the edit mode. Then type in:
NOTEMost commands can also be queried by sending the command (without a value)
and then sending the OUTPACTI command, as in the following example that queries
the power value:
10 OUTPUT 716;”POWE;OUTPACTI;”
Running the Program The computer will display the preset source-power level in dBm. Change
the power level by pressing
Local, Power, XX, x1. Now run the program again.
When the analyzer receives POWE?, it prepares to transmit the current RF source-power level.
The BASIC statement ENTER 716 allows the analyzer to transmit information to the computer by
addressing the analyzer to talk. This illuminates the analyzer front-panel talk (T) light. The
computer places the data transmitted by the analyzer into the variables listed in the ENTER
statement. In this case, the analyzer transmits t he output power , whi ch gets placed in the variable
Reply .
The ENTER statement takes the stream of binary-data output from the analyzer and reformats it
back into numbers and ASCII strings. With the formatting set to its default state, the ENTER
statement will format the data into real variables, integers, or ASCII strings, depending on the
variable being filled. The variable list must match the data the analyzer has to transmit. If there
are not enough variables, data is lost. If there are too many variables for the data available, a
BASIC error is generated.
The formatting done by the ENTER statement can be changed. The formatting can be
deactivated to allow binary transfers of data. Also, the ENTER USING statement can be used to
selectively control the formatting.
ON/OFF commands can be also be queried. The reply is a one (1) if the function is active, a zero
(0) if it is not active. Similarly , if a command controls a function that is underline d on the analyzer
softkey menu when active, querying that command yields a one (1) if the command is underlined,
a zero (0) if it is not. For example, press
Meas. Though there are seven options on the
measurement menu, only one is underlined at a time. The un derlined o ption will r eturn a one (1 )
when queried.
1-14
Introduction to Instrument Control
Instrument Control using BASIC
For instance, rewrite line 10 as:
10OUTPUT 716;"DUAC?;"
Run the program once and note the result. Then press Local,Display, DUAL CHAN, to toggle the
display mode, and run the program again.
Another example is to rewrite line 10 as:
10OUTPUT 716;"PHAS?;"
In this case, the program will display a one (1) if phase is currently being displayed. Since the
command only applies to the active channel, the response to the PHAS? inquiry depends on
which channel is active.
Operation Complete
Occasionally, there is a need to query the analyzer as to when certain analyzer operations have
completed. For instance, a program should not have the operator connect the next calibration
standard while the analyzer is still measuring the current one. To provide such information, the
analyzer has an “operation complete” reporting mechanism, or OPC command, that will indicate
when certain key commands have completed operation. The mechanism is activated by sending
either OPC or OPC? immediately before an OPC-compatible command. When the command
completes execution, bit 0 of th e event-status register will be set. If OPC was queried with OPC ?,
the analyzer will also output a one (1) when the command completes execution.
As an example, type SCRATCH and press
Return.
Type EDIT and press Return.
Type in the following program:
10 OUTPUT 716;"SWET 3 S;OPC?;SING;"
Set the sweep time to 3 seconds, and OPC a single sweep.
20 DISP "SWEEPING"
30 ENTER 716;Reply The program will halt at this point until the analyzer
completes the sweep and issues a one (1).
40 DISP "DONE"
50 END
1-15
Introduction to Instrument Control
Instrument Control using BASIC
Running the Program Running this program causes the computer to display the sweeping
message as the instrument executes the sweep. The computer will display DONE just as the
instrument goes into hold. When DONE appears, the program could then continue on, being
assured that there is a valid data trace in the instrument.
Preparing for Remote (GPIB) Control
At the beginning of a program, the analyzer is taken from an unknown state and brought under
remote control. This is done with an abort/clear sequence. ABORT 7 is used to halt bus activity
and return control to the computer. CLEAR 716 will then prepare the analyzer to receive
commands by:
• clearing syntax errors
• clearing the input-command buffer
• clearing any messages waiting to be output
The abort/clear sequence readies the analyze r to receive GPIB commands. T he next step i nvolves
programming a known state into the anal yzer. The most convenient way to do this is to preset the
analyzer by sending the PRES (preset) command. If preset cannot be used, the status-reporting
mechanism may be employed. When using the status-report ing register , CLES (Clear Status) can
be transmitted to the analyzer to clear all of the status-reporting registers and their enables.
Type SCRATCH and press
Return.
Type EDIT and press Return. Type in the following program:
10 ABORT 7 This halts all bus action and gives acti ve co nt ro l to
the computer.
20 CLEAR 716 This clears all GPIB errors, resets the GPIB interface, and
clears the syntax errors. It does not affect the
status-reporting system.
30 OUTPUT 716;"PRES;" Presets the instrument. This clears the status-reporting
system, as well as resets all of the front-panel settings,
except for the GPIB mode and the GPIB addresses.
40 ENDRunning this program brings the analyzer to a known
state, ready to respond to GPIB contro l.
The analyzer will not respond to GPIB commands unless the remote line is asserted. When the
remote line is asserted, the analyzer is addressed to listen for commands from the controller. In
remote mode, all the front-panel keys are disabled (with the exception of
Local, and the
line-power switch). ABORT 7 asserts the remote line, which remains asserted until a LOCAL 7
statement is executed.
Another way to assert the remote line is to execute:
REMOTE 716
This statement asserts the analyzer's remote-o peration mode and addresses the analyzer t o listen
for commands from the controller. Press any front-panel key except
front-panel keys will respond until
1-16
Local, has been pressed.
Local. Note that none of the
Introduction to Instrument Control
Instrument Control using BASIC
Local, can also be disabled with the sequence:
REMOTE 716
LOCAL LOCKOUT 7
After executing the code above, none of the front-panel keys will respond. The analyzer can be
returned to local mode temporarily with:
LOCAL 716
As soon as the analyzer is addressed to listen, it goes back into local-lockout mode. The only way
to clear the local-lockout mode, aside from cycling line power, is to execute:
LOCAL 7
This command un-asserts the remote line on the interface. This puts the instrument into local
mode and clears the local-lockout comm and. Return the instrument to remote mode by pressing:
Local, TALKER/LISTENER
or
Local, USE PASS CONTROL
I/O Paths
One of the features of BASIC is the use of input/output paths. The instrument may be addressed
directly by the instrument's device number as shown in the previous examples. However, a more
sophisticated approach is to declare I/O paths such as: ASSIGN @Nwa TO 716. Assigning an I/O
path builds a look-up table in the computer's memory that contains the device-address codes and
several other parameters. It is easy to quickly change addresses th roughout the entir e program at
one location. I/O operation is more efficient because it uses a table, in place of calculating or
searching for values related to I/O. In the more elaborate examples where file I/O is discussed, the
look-up table contains all the information about the file. Execution time is decreased, because the
computer no longer has to calculate a device's address each time that device is addressed.
For example:
Type SCRATCH and press
Return.
Type EDIT and press Return.
Type in the following program:
10 ASSIGN @Nwa TO 716 Assigns the analyzer to ADDRESS 716.
20 OUTPUT @Nwa;"STAR 50 MHZ;" Sets the analyzer' s start frequency to 50 MHz.
NOTEThe use of I/O paths in binary-format transfers allows the user to quickly
distinguish the type of transfer taking place. I/O paths are used throughout the
examples and are highly recommended for use in device input/output.
1-17
Introduction to Instrument Control
Instrument Control using BASIC
1-18
2
Alphabetical Command Reference2-2
Keys to Programming Commands2-3
Programming Commands2-14
8703A Commands Not Supported in the 8703B2-76
In this chapter, you can find an alphabetical list and brief descriptions of the supported
commands for controlling the Agilent 87 03B remotely.
NOTESome commands have a range of values associated with them. If you send a
value that is beyond the analyzer’s capability, the analyzer will default to the
closest allowed value. Refer to the individual commands for the specific range
of values allowed.
Symbol Conventions
<num> Required numerical data.
<choice1|choice2|…|choicen> An appendage that is part of the command. For example,
FORMAT<DOS|LIF> indicates that the actual commands are
FORMATDOS and FORMATLIF .
<$> Indicates a character string operand which must be enclosed
by double quotes.
| An either/or choice in an appendage or optional data.
[ ] Optional data.
A terminator indicates the end of a command string, and this manual uses a semicolon as the
terminator in all syntax examples. The analyzer also interprets line feeds and GPIB end or
identify (EOI) messages as terminators. Terminators are not necessary for the analyzer to
interpret commands correctly, however in the case of a syntax error, the analyzer will attempt to
recover at the next terminator. Therefore, it is recommended that you conclude each command
with a terminator.
Because this chapter is an “Alphabetical Command Reference,” the commands have been listed
alphabetically, rather than by function, in both the “Syntax” sections and the “Description ”
sections. Therefore, commands grouped together in the “Syntax” sections, are grouped
alphabetically and/or due to common syntax form, not necessarily due to common functionality.
The softkeys listed in the “Front Panel Equivalents” tables may no t be in the first menu viewed
when the associated hardkey is pressed. In many cases, more than one key press will be required
to locate the softkey. Refer to your analyzer’s reference guide for the exact location of any
softkey.
Some commands that do not have an associated query syntax can be queried by sending the
command (without a value) and then sending t he OUTPACTI command, as in the following
example that queries the segment power value:
10 OUTPUT 716;”SEGPOWER;OUTPACTI;”
Many of the commands that do have a listed query syntax can also be queried in this manner.
SMOOTHING ON OFFSMOOO <ON|OFF>
CalISOLATIONISOL
CalALTERNATE A and BALTAB
Alphabetical Command Reference
Keys to Programming Commands
CalALTERNATE RFL/TRANALTAB
CalCORRECTION ON OFFCORR
CalDEFINE STANDARDDEFS
CalDONE 1-PORT CALSAV1
CalDONE 2-PORT CALSAV2
CalDONE RESP ISOL’N CALRAID
CalDONE:DONE
CalDONE:RESPDONE
CalEXTENSION PORT 1PORT1
CalEXTENSION PORT 2PORT2
CalEXTENSIONS ON OFFPORE
CalFULL 2-PORTCALIFUL2
CalFWD ISOL’NFWDI
CalFWD MATCHFWDM
CalFWD TRA N SFWDT
CalINTERPOL ON OFFCORI
CalISO L’N STDRAIISOL
CalISOLATION DONEISOD
CalMAXIMUM FREQUENCYMAXF
CalOMIT ISOLATIONOMII
2-3
Alphabetical Command Reference
Keys to Programming Commands
Table 2-1. Front Panel Equivalen ts (2 of 11)
HardkeySoftkeyCommand
CalREFLECTIONREFL
CalRESPONSECALIRESP
CalRESPONSERAIRESP
CalRESPON SE & ISOL’NCALIRAI
CalRespons e & Match (E/O)CA LIEORM
CalRespons e & Matc h (O/E)CALIOERM
CalResponse & Match: DoneRAMD
CalRESUME CA L SEQUENCERESC
CalREV ISOL’NREVI
CalREV MATCHREVM
CalREV TRAN SREVT
CalS11 1-PORTCALIS111
CalS11ACLASS11A
CalS11BCLASS11B
CalS11CCLASS11C
CalS22 1-PORTCALIS221
CalS22ACLASS22A
CalS22ACLASS22B
CalS22ACLASS22C
CalSET Z0SETZ
CalSLIDING LOAD DONESLID
CalSPECIFY CLASS DONECLAD
Calstandar d listed under softkey 1STANA
Calstandar d listed under softkey 2STANB
Calstandar d listed under softkey 3STANC
Calstandar d listed under softkey 4STAND
Calstandar d listed under softkey 5STANE
Calstandar d listed under softkey 6STANF
Calstandar d listed under softkey 7STANG
CalSTANDARDS DONEREFD
CalSTANDARDS DONETRAD
2-4
Table 2-1. Front Panel Equivalen ts (3 of 11)
HardkeySoftkeyCommand
CalTESTSET SW n SweepsTSS WIn
CalTRANSMISSNTRAN
CalVELOCITY FACTORVELOFACT
Center CENT
Chan 1N/ACHAN1
Chan 2N/ACHAN2
Chan 3N/ACHAN3
Chan 4N/ACHAN4
CopyLINE TYPE DATALINTD ATA
LINE TYPE MEMORYLINTMEMO
LIST VALUESLISV
Alphabetical Command Reference
Keys to Programming Commands
NEXT PAGENEXP
OP PARAMSOPEP
PLOTPLOT
RESTORE DISPLAYRESD
2-5
Alphabetical Command Reference
Keys to Programming Commands
Table 2-1. Front Panel Equivalen ts (4 of 11)
HardkeySoftkeyCommand
Display2x:[1&2][3&4]D2XUPCH2
2x:[1&3][2&4]D2XUPCH3
4x:[1][2][3][4]D4XUPCH2
4x:[1][3][2][4]D4XUPCH3
AUX CHAN ON OFFAUXC <ON|OFF>
BACKGROUND INTENSITYBACI
BEEP DONE ON OFFBEEPDONE <ON|OFF>
BEEP FAIL ON OFFBEEPFAIL <ON|OFF>
BEEP WARN ON OFFBEEPWARN <ON|OFF>
BRIGHTNESSCBRI
DATA ->MEMORYDATI
DATA and MEMORYDISPDATM
DATA/MEMDISPDDM
DATA-MEMDISPDMM
DATA+MEMDISPDPM
DATA*MEMDISPDTM
MEM1/MEM2DISPM1DM
MEM1-MEM2DISPM1MM
MEM1+MEM2DISPM1PM
MEM1*MEM2DISPM1TM
MEM2/MEM1DISPM2DM
MEM2-MEM1DISPM2MM
MEM/DATADISPMDD
MEM-DATADISPMMD
MATH->MEMMATI
MEM1->MEM2MEM1I
MEM2->MEM1MEM2I
2-6
DEFAULT COLORSDEFC
DISPLAY: DATADISPDATA
DUAL CHAN ON OFFDUAC <ON|OFF>
FREQUENCY BLANKFREO
INTENSITYINTE
Table 2-1. Front Panel Equivalen ts (5 of 11)
HardkeySoftkeyCommand
downN/ADOWN
Entry OffN/AENTO
FormatDELAYDELA
IMAGINARYIMAG
LIN MAGLINM
LOG MAGLOGM
PHASEPHAS
POLARPOLA
REALREAL
SMITH CHARTSMIC
SWRSWR
Alphabetical Command Reference
Keys to Programming Commands
LocalADDRESS: CONTROLLERAD DRCONT
ADDRESS: DISKADDRDISC
ADDRESS: P MTR/GPIBADDRPOWM
DISK UNIT NUMBERDISCUNIT
GPIB DIAG ON OFFDEBU <ON|OFF>
PLTR PORT GPIBADDRPLOT
PRNTR PORT GPIBADDRPRIN
USE PASS CONTROLUSEPASC
Markerall OFFMARKOFF
D MODE OFFDELO
D REF = D FIXED MKRDELRFIXM
D REF = nDELR
FIXED MKR AUX VALUEMARKFAUV
FIXED MKR STIMULUSMARKFSTI
FIXED MKR VALUEMARKFVAL
MARKER nMARKn
MKR ZEROMARKZERO
2-7
Alphabetical Command Reference
Keys to Programming Commands
Table 2-1. Front Panel Equivalen ts (6 of 11)
HardkeySoftkeyCommand
Marker FctnDISP MKRS ON OFFDISM
G + jB MKRSMIMGB
POLAR LIN MKRPOLMLIN
SMITH LIN MKRSMIMLIN
POLAR LOG MKRPOLMLOG
SMITH LOG MKRSMIMLOG
MARKER -> CENTERMA RKCENT
MARKER -> DELAYMARKDELA
MARKER -> SPANMARKSPAN
MARKER -> STARTMARKSTAR
MARKER -> STOPMARKSTOP
MARKERS: CONTIN UOUSMARKCONT
MARKERS: COUPLEDMARKCOUP
MARKERS: DISCRETEMARKDISC
MARKERS: UNCOUP LEDMARKUNCO
MEASURE: STATSMEASTAT
SMITH R + jX MKRSM IMRX
POLAR Re/Im MKRPOLMRI
SMITH Re/Im MKRSMIMRI
SEARCH: TARGETSEATARG
TRACKING ON OFFTRACK
WIDTH VALUEWIDV
WIDTHS ON OFFWIDT
Table 2-1. Front Panel Equivalen ts (7 of 11)
HardkeySoftkeyCommand
MeasBMEASB
AMEASA
A/BAB
A/R AR
B/RBR
CONVERSION 1/SCONV1DS
CONVERSION OFFCONVOFF
CONVERSION Y:Ref lCONVYREF
CONVERSION Y:Tran sCONVYTRA
CONVERSION Z:ReflCO NVZREF
CONVERSION Z:TransCONVZT RA
Alphabetical Command Reference
Keys to Programming Commands
E/O TransMEASEO1
O/E Trans (Port 1)MEASOE1
O/E Trans (Port 2)MEASOE2
O ReflMEASO1
O TransMEAS001
RMEASR
Refl:FWD S11 (A/R)S11
Refl:REV S22 (B/R)S22
Trans:FWD S21 (B/R)S21
Trans:REV S12 (A/R)S12
PowerN/APOWE
PORT POWERPORTP
PWR RANGE AUTO MANPWRR <PMAN| P AUTO>
RANGE nPRAN
SOURCE PWR ON OFFSOUP <ON|OFF>
PresetN/APRES
N/ARST
2-9
Alphabetical Command Reference
Keys to Programming Commands
Table 2-1. Front Panel Equivalen ts (8 of 11)
HardkeySoftkeyCommand
Save/RecallCLEARCLEAREG <01-31>
CLEAR ALLCLEARALL
DATA ARRAY ON OFFEXTMDATA
DATA ONLYEXTMDATO
FILE NAMETITF
FORMAT ARY ON OFFEXTMFORM
FORMAT INT DISKINID
GRAHPICS ON OFFEXTMGRAP
INTERNAL DISKINTD
LOADLOAD
RAW ARRAY ON OFFEXTMRAW
READ FILE TITLESREFT
SAVESAVEREG
SAVE FILE when GRAPH FMT [ ] is set to CSV and
FILETYPE: GRAPHIC is selected.
SAVE FILE when GRAPH FMT [ ] is set to JPG and
FILETYPE: GRAPHIC is selected.
SAVE USING ASCIISAVUASCI
SAVE USING BINARYSAVUBINA
TITLETITREG
ADDR<CONT|DISC|PLOT|POWM|PRIN><num>;or ADDR<CONT|DISC|PLOT|POWM|PRIN>?;
Sets the GPIB address for the following peripherals.
Command Description RangeQuery Response
ADDRCONTController GPIB address. The address
where control is returned after a pass
control.
ADDRDISCExternal disk drive GPIB address.integers 0–30
ADDRPLOTPlotter GPIB address.integers 0–30
ADDRPOWMPower meter GPIB address.integers 0–30
ADDRPRINPrinter GPIB address.integers 0–30
integers 0–30
<num><
<num><
<num><
<num><
<num><
L
>
F
L
>
F
L
>
F
L
>
F
L
>
F
ADJB
ADJB
Executes autobiasing of optical modulator. No query response
ALTAB
ALTAB; or ALTAB?;
Command Description RangeQuery Response
ALTABPlaces the analyzer in the alternate inputs
measurement mode, where A and B
measurements are made on alternate
sweeps. See also “CHOPAB.”
2-14
N/A
<0|1><
L
>
F
Alphabetical Command Reference
AR
AR; or AR?;
Command Description RangeQuery Response
AR
ARMeasures and displays A/R on the active
channel.
N/A
<0|1><
L
>
F
ASEG
ASEG; or ASEG?;
Command Description RangeQuery Response
ASEGUses all segments for list frequency sweep.
See also “SSEG”
N/A
<0|1><
L
>
F
AUTB;
AUTB<ON|OFF>;
Enable or disable autobiasing of optical modulator.
AUTO
AUTO;
Command Description RangeQuery Response
AUTOAuto scale the active channel. N/AN/A
AUXC
AUXC<ON|OFF>; or AUXC?;
Command Description RangeQuery Response
AUXCEnables and disables auxiliary channels 3
and 4. OPC-compatible.
Example
10 OUTPUT 716;”CHAN1;AU XCON;”Turns on channel 3
20 OUTPUT 716;”CHAN2;AU XCON;”Turns on channel 4
N/A
<0|1><
L
>
F
2-15
Alphabetical Command Reference
AVER
AVER
AVERFACT<num>; or AVERFACT?;
AVERO<ON|OFF>; or AVERO?;
AVERREST;
Command Description RangeQuery Response
AVERFACTSets the averaging factor on the active channel.integers 0–999
AVEROTurns averaging on and off on the active
channel.
AVERRESTRestarts the averaging on the active channel.N/AN/A
N/A
<num><
<0|1><
BACI
BACI<num>; or BACI?;
Command Description RangeQuery Response
BACISets the background intensity of the
display.
integers 0–100
<num><
L
>
F
BEEP
BEEP<DONE|WARN|FAIL><ON|OFF>; or BEEP<DONE|WARN|FAIL>?;
Command Description RangeQuery Response
BEEPDONECauses the analyzer's warning beeper to
sound at the completion of functions such
as save, done with calibration standard,
and data trace saved.
N/A
<0|1><
L
>
F
L
>
F
L
>
F
BEEPFAILCauses the analyzer's warning beeper to
sound in the event of a limit test failure.
BEEPWARNCauses the analyzer's warning beeper to
sound when a warning message is
generated.
N/A
N/A
<0|1><
<0|1><
L
>
F
L
>
F
BR
BR; or BR?;
Command Description RangeQuery Response
BRMeasures and displays B/R on the active
channel.
2-16
N/A
<0|1><
L
>
F
Alphabetical Command Reference
BSAMP
BSAMP<ON|OFF>;
Switch B , sampler to : ON = LW, OFF = R F.
BWLIMDB
BWLIMDB<num>; or BWLIMDB?;
Command Description RangeQuery Response
BSAMP
BWLIMDBEnters the N dB Point, the amplitude below
the peak that is used to measure the filter’s
bandwidth.
-500 to 500 dB
<num><
L
>
F
BWLIMDISP
BWLIMDISP<ON|OFF>; or BWLIMDISP?;
Command Description RangeQuery Response
BWLIMDISPTurns the measured bandwidth value in the
upper left corner of the displa y on and off.
The measured bandwidth valu e is displayed
near the bandwidth Pass/Wide/Narrow
message.
N/A
<0|1><
L
>
F
BWLIMMKR
BWLIMMKR<ON|OFF>; or BWLIMMKR?;
Command Description RangeQuery Response
BWLIMMKR
Turns the limit bandwidth marker on and
off.
N/A
<0|1><
L
>
F
BWLIMMAX
BWLIMMAX<num>[HZ|KHZ|MHZ|GHZ]; or BWLIMMAX?;
Command Description RangeQuery Response
BWLIMMAXEnters the maximum bandwidth value. If the
measured bandwidth is greater than this
value, the filter fails the bandwidth test.
a. Refer to “Preset State and Memory Allocation” in your analyzer’s reference guide.
stimulus range
a
<num><
L
>
F
2-17
Alphabetical Command Reference
BWLIMMIN
BWLIMMIN
BWLIMMIN<num>[HZ|KHZ|MHZ|GHZ]; or BWLIMMIN?;
Command Description RangeQuery Response
BWLIMMINEnters the minimum bandwidth value. If the
measured bandwidth is less than this value,
the filter fails the bandwidth test.
a. Refer to “Preset State and Memory Allocation” in your analyzer’s reference guide.
stimulus range
a
<num><
L
>
F
BWLIMSTAT
BWLIMSTAT;
Command Description RangeResponse
BWLIMSTATReturns the results of the bandwidth test. A
returned value of 0 indicates that the filter
passed the bandwidth test. A returned
value of −1 indicates that the filter failed
the bandwidth test because it is narrower
than the bandwidth limit. A returned value
of 1 indicates that the filter failed the
bandwidth test because it is wider than the
bandwidth limit.
N/A
<−1|0|1><
L
>
F
BWLIMTEST
BWLIMTEST<ON|OFF>; or BWLIMTEST?;
Command Description RangeQuery Response
BWLIMTESTTurns the bandwidth test on and off. N/A
<0|1><
L
>
F
BWLIMVAL
BWLIMVAL;
Command Description RangeResponse
BWLIMVALReturns the measured bandwidth value.N/A
<num><
L
>
F
CALI
CALI<EORM|OERM|FUL2|RAI|RESP|S111|S221>;
2-18
Alphabetical Command Reference
CALI<EORM|OERM|FUL2|RAI|RESP|S111|S221>?;
Command Description RangeQuery Response
CALK35MM
CALIEORM
Select E/O response and match
<011>
calibration.
CALIOERM
Select O/E response and match
<011>
calibration.
CALIFUL2
a
Begins the sequence for a short, load, open,
N/A
thru (SLOT) 2-port calibration.
CALIRAIBegins the sequence for a response and
N/A
isolation calibration.
CALIRESPBegins the sequence for a response
N/A
calibration.
CALIS111Begins the sequence for an S11 1-port
N/A
calibration (ES models), or a reflection
1-port calibration (ET models).
CALIS221
a
Begins the sequence for an S22 1-port
calibration.
N/A
a. The result of the query command only tells if the particular type of calibration is currently active. It does not
provide information on the status of the cal sequence
.
<0|1><
<0|1><
<0|1><
<0|1><
<0|1><
L
L
L
L
L
CALK35MM
>
F
>
F
>
F
>
F
>
F
CALK35MM;
Command Description RangeQuery Response
CALK35MMSelects the 3.5mm calibration kit
coefficients.
N/AN/A
CBRI
CBRI<num>; or CBRI?;
Command Description RangeQuery Response
CBRIAdjusts the color brightness of the selected
display feature.
integers 0–100
<num><
L
>
F
2-19
Alphabetical Command Reference
CENT
CENT
CENT<num>[HZ|DB]; or CENT?;
Command Description RangeQuery Response
CENTSets the center stimulus value. If a list
frequency segment is being edited, sets the
stimulus range
a
<num><
L
>
F
center of the list segment.
a. For frequency or power sweeps, refer to “Preset State and Memory Allocation,” in your analyzer’s reference guide.
For CW time: 0 to 24 hours. For frequency sweep, transform on:
on:
±1/time step.
± 1/frequency step. For CW time sweep, transform
2-20
Alphabetical Command Reference
CHAN
CHAN<1|2|3|4>;
Makes channel 1, 2, 3, or 4 the active channel. OPC-compatible. No query response.
NOTEThese commands should use OPC? to prevent timing errors with subsequent
commands. Example code written in BASIC:
10 OUTPUT 716;"OPC?;CHAN2;"
20 ENTER 716;OPC
CLAD
CLAD;
Command Description RangeQuery Response
CLADClass done (modify cal kit, specify class).N/AN/A
CHAN
CLASS
CLASS<11A|11B|11C|22A|22B|22C>;
These commands call reflection standard classes during a calibration sequence. If only one
standard is in the class, it is measured. If there is more than one, the standard being used must be
selected with STAN<A|B|C|D|E|F|G>. If there is only one standard in the class, these commands
CLEAREGClears save/recall registers 01 through 31.
CLEAREG01 through CLEAREG05 are the
same as CLEA1 through CLEA5.
OPC-compatible.
CLEARALLClears all the save/recall registers.
OPC-compatible.
two-digit
integers 01–31
N/AN/A
N/A
CLEAL
CLEAL;
Command Description RangeQuery Response
CLEALClears the limit line list. Should be
preceded by EDITLIML.
N/AN/A
CLEL
CLEL;
Clears the currently selected list. This could be a frequency list, power loss list, or limit test list.
Must be preceded by an “EDIT” command. No query response.
CLES
CL[E]S;
Command Description RangeQuery Response
CLESClears the status byte register, the
event-status registers, and the enable
registers.
CLS
Same as
CLES.
N/AN/A
N/AN/A
CLER
CLER;
Clears (or deletes) the all of existing ripple test limits. No query response.
2-22
COEFA
COEFA<1-4> [value]
Set numerator coefficients of response model.
COEFB
COEFB<1-4> [value]
Set denominator coefficients of response model.
COEFDELA
COEFDELA [value];
Set delay coefficient of response model.
COEFK;
Alphabetical Command Reference
COEFA
COEFK;
Sets constant coefficient of response model.
CONS
CONS;
Continues the sequence that was paused.
CONT
CONT; or CONT?;
Command Description Range Query Response
CONTPlaces the analyzer in continuous sweep
trigger mode.
N/A
<0|1><
L
>
F
2-23
Alphabetical Command Reference
CONV
CONV
CONV<1DS|OFF|YREF|YTRA|ZREF|ZTRA>;or CONV<1DS|OFF|YREF|YTRA|ZREF|ZTRA>?;
These 6 commands convert the S-parameter data to:
Command Description Range Query Response
CONV1DSInverted S-parameters.N/A
CONVOFFTurns S-parameter conversion off.N/A
CONVYREFY:reflection (admittance). N/A
CONVYTRAY:transmission (transmission). N/A
CONVZREFZ:reflection (impedance).N/A
CONVZTRAZ:transmission (transmission). N/A
<0|1><
<0|1><
<0|1><
<0|1><
<0|1><
<0|1><
L
>
F
L
>
F
L
>
F
L
>
F
L
>
F
L
>
F
CORI
CORI<ON|OFF>; or CORI?;
Command Description Range Query Response
CORITurns interpolative error correction on and
off.
N/A
<0|1><
L
>
F
CORR
CORR<ON|OFF>; or CORR?;
Command Description Range Query Response
CORRTurns error correction on and off.N/A
<0|1><
L
>
F
COU
COU<C><ON|OFF>; or COU<C>?;
Command Description Range Query Response
COUCCouples and uncouples the stimulus
between the channels.
N/A
<0|1><
L
>
F
COUS
COUS<ON|OFF>;
2-24
Alphabetical Command Reference
Switch coupling to measurement parameter ON or OFF.
CWFREQ
CWFREQ<num>[HZ|DB]; or CWFREQ?;
Command Description RangeQuery Response
CWFREQ
CWFREQSets the CW frequency for power sweep and
CW frequency modes. While the list
stimulus range
a
<num><
L
>
F
frequency table segment is being edited, it
sets the center frequency of the current
segment. See also “MARKCENT.”
a. For frequency or power sweeps, refer to “Preset State and Memory Allocation,” in the analyzer’s reference guide.
For CW time: 0 to 24 hours. For frequency sweep, transform on:
on:
±1/time step.
±1/frequency step. For CW time sweep, transform
CWTIME
CWTIME; or CWTIME?;
Command Description Range Query Response
CWTIMESelects CW time as the sweep type.N/A
<0|1><
L
>
F
D2XUPCH
D2XUPCH<2|3>; or D2XUPCH<2|3>?;
Command Description Range Query Response
D2XUPCH2Sets up a two-graticule display with
channel 2 on top.
D2XUPCH3Sets up a two-graticule display with
channel 3 on top.
N/A
N/A
<0|1><
<0|1><
L
>
F
L
>
F
D4XUPCH
D4XUPCH<2|3>; or D4XUPCH<2|3>?;
Command Description Range Query Response
D4XUPCH2Sets up a four-graticule display with
channel 2 in the upper right quadrant of
the display.
D4XUPCH3Sets up a four-graticule display with
channel 3 in the upper right quadrant of
the display.
N/A
N/A
<0|1><
<0|1><
L
>
F
L
>
F
2-25
Alphabetical Command Reference
DATI
DATI
DATI;
Stores the data trace in channel memory. OPC-compatible. No query response.
DEBU
DEBU<ON|OFF>; or DEBU?;
Command Description RangeQuery Response
DEBUTurns the GPIB debug mode on and off.
When on, the analyzer scrolls incoming
GPIB commands across the display.
N/A
<0|1><
L
>
F
DEFC
DEFC;
Sets the d efault co lors for al l display f eatures. N o q uery res ponse.
DEFS
DEFS<num>;
Command Description RangeQuery Response
DEFSBegins standard definition during cal kit
modification. “<num>” is the standard
number.
integers 1–8 N/A
DEL
DEL<O|RFIXM>; or DEL<O|RFIXM>?;
DELR<num>; or DELR<num>?;
Command Description Range Query Response
DELOTurns delta marker mode off.N/A
DELRMakes the indicated marker the delta
reference.
DELRFIXMMakes the fixed marker the delta reference.N/A
integers 1–5
2-26
<0|1><
<0|1><
<0|1><
L
>
F
L
>
F
L
>
F
Alphabetical Command Reference
DELA
DELA; or DELA?;
Command Description RangeQuery Response
DELA
DELADisplays the data formatted as group delay.N/A
<0|1><
L
>
F
DEMO
DEMO<AMPL|OFF|PHAS>; or DEMO<AMPL|OFF|PHAS>?;
Command Description RangeQuery Response
DEMOAMPLTurns on transform demodulation and sets
the transform demodulation to amplitude
demodulation. Only has a meaningful effect
with a CW time transform.
DEMOOFFTurns the transform demodulation
function off.
DEMOPHASSets the transform demodulation to phase
demodulation. Only has a meaningful effect
with a CW time transform.
N/A
N/A
N/A
<0|1><
<0|1><
<0|1><
L
>
F
L
>
F
L
>
F
DISC
DISC<UNIT><num>; or DISC<UNIT>?;
Command Description RangeQuery Response
DISCUNITSpecifies which disk in an external
multiple-disk drive to be used for
save/recall.
integers 0–30
<num><
L
>
F
DISM
DISM<ON|OFF>; or DISM?;
Command Description RangeQuery Response
DISMWhen on, displays the response and
stimulus values for all markers that are
turned on; when off, only the active
marker's value is displayed.
These commands display the indicated combinations of data and trace me mo ry on the active
channel.
Command Description Range Query Response
DISPDATAData only.N/A
DISPDATMData and memory.N/A
DISPDDMData divided by memory (linear division,
N/A
log subtraction). See also “DIVI.”
DISPDMMData minus memory (linear subtraction).
N/A
See also “MINU.”
DISPMEMOMemory only.N/A
DISPDPM
DISPDTM
DISPM1DM
DISPM1MM
DISPM1PM
DISPM1TM
DISP
M2DM
Display data plus memory.N/A
Display data times memory.N/A
Display memory 1 divided by memory 2.N/A
Display memory 1 minus by memory 2N/A
Display memory 1 plus memory 2.N/A
Display memory 1 times memory 2.N/A
Display memory 2 divided by memory 1.N/A
<0|1><
<0|1><
<0|1><
<0|1><
<0|1><
<0|1><
<0|1><
<0|1><
<0|1><
<0|1><
<0|1><
<0|1><
L
>
F
L
>
F
L
>
F
L
>
F
L
>
F
L
>
F
L
>
F
L
>
F
L
>
F
L
>
F
L
>
F
L
>
F
DISP
M2MM
DISPMATH
DISPMMD
DISP
MDD
Display memory 2 minus memory 1.N/A
Display math resultsN/A
Display memory minus dataN/A
Display memory divided by dataN/A
<0|1><
<0|1><
<0|1><
<0|1><
L
>
F
L
>
F
L
>
F
L
>
F
DONE
DONE;
Done with a class of standards, during a calibration. Only needed when multiple standards are
measured to complete the class. OPC-compatible. No query response.
DONM
DONM;
2-28
Alphabetical Command Reference
DOSEQ
Done modifying a test sequence. No query response.
DOSEQ
DOSEQ<1-6>;
Start sequence 1-6. No query response.
DOWN
DOWN;
Decrements the value displayed in the active entry area (em ulates pressing the down-arrow key ).
No query response.
2-29
Alphabetical Command Reference
DRIVPORT
DRIVPORT
DRIVPORT<ON|OFF>;
Drive port; ON = LW, OFF = RF.
DUAC
DUAC<ON|OFF>; or DUAC?;
Command Description RangeQuery Response
DUACTurns dual channel display on and off.N/A
<0|1><
L
>
F
EDIT
EDIT<DONE|LIML|LIST>;
Command Description RangeQuery Response
EDITDONEDone editing list frequency, limit table, cal
sensor table, or power loss list.
OPC-compatible.
EDITLIMLBegins editing limit table.N/AN/A
EDITLISTBegins editing list frequency table.N/AN/A
N/AN/A
EDITRLIM
EDITRLIM;
Begins the editing of the ripple limit list. No query response.
ELED
ELED<num>[S]; or ELED?;
Command Description RangeQuery Response
ELED
2-30
Sets the electrical delay offset. ±10 seconds
<num><
L
>
F
Alphabetical Command Reference
ENTO
ENTO;
Command Description Range Query Response
ENTO
ENTORemoves displayed information from the
active entry area on the screen.
N/A N/A
EOCAL
EOCAL;
Internal E/O service calibration parameter.
ESE
ESE<num>; or ESE?;
Command Description RangeQuery Response
ESEEnables the selected event-status register
bits to be summarized by bit 5 in the status
byte. An event-status register bit is enabled
when the corresponding bit in the operand
<num> is set.
integers 0–255
<num><
L
>
F
ESNL
ESNL<num>; or ESNL?;
Command Description RangeQuery Response
ESNLEnables the selected event-status register L
bits to be summarized by bit 2 in the status
byte. An event-status register bit is enabled
when the corresponding bit in the operand
<num> is set.
integers 0–4095
<num><
L
>
F
ESL?
ESL?;
Command Description Range Query Response
ESL?Query only. Outputs event-status register.N/A
<num><
L
>
F
2-31
Alphabetical Command Reference
EXTM
EXTM
EXTM<DATA|FORM|GRAP|RAW><ON|OFF>;or EXTM<DATA|FORM|GRAP|RAW>?;
These commands include the indicated information when an instrument state is stored to the
internal floppy disk drive or an external disk.
Command Description Range Query Response
EXTMDATAAdds error corrected data (real and
imaginary pairs) along with the other files.
EXTMFORMFormatted trace data. Uses currently
selected format for data.
EXTMGRAPUser graphics.N/A
EXTMRAWRaw data arrays (real and imaginary pairs).N/A
a. See Figure 6-1 on page 6-3. This error corrected data is the same as that output by the OUTPDATA command.
N/A
a
N/A
<0|1><
<0|1><
<0|1><
<0|1><
L
>
F
L
>
F
L
>
F
L
>
F
EXTT
EXTT<ON|OFF>; or EXTT?;
Command Description Range Query Response
EXTTActivates or deactivates the external
trigger mode. OPC-compatible.
N/A
<0|1><
L
>
F
FORM
FORM<1|2|3|4|5>;
These 5 commands set the data format for array transfers in and out of the instrument:
Command Description Range Query
Response
FORM1The analyzer's internal binary format, 6 bytes-per-data point.
The array is preceded by a four-byte header. The first two
bytes represent the string “#A”, the standard block header.
The second two bytes are an integer representing the number
of bytes in the block to follow. FORM1 is best applied when
rapid data transfers, not to be modified by the computer nor
interpreted by the user, are required.
FORM2IEEE 32-bit floating-point format, 4 bytes-per-number,
8 bytes-per-data point. The data is preceded by the same
header as in FORM1. Each number consists of a 1-bit sign, an
8-bit biased exponent, and a 23-bit mantissa. FORM2 is the
format of choice if your computer is not a PC, but supports
single-precision floating-point numbers.
2-32
N/AN/A
N/AN/A
Alphabetical Command Reference
Command Description Range Query
Response
FREO
FORM3IEEE 64-bit floating-point format, 8 bytes-per-number,
16 bytes-per-data point. The data is preceded by the same
header as in FORM1. Each number consists of a 1-bit sign, an
11-bit biased exponent, and a 52-bit mantissa. This format
may be used with double-precision floating-point numbers.
No additional precision is available in the analyzer data, but
FORM3 may be a convenient form for transferring data to
your computer.
FORM4ASCII f loating-point format. The data is transmitted as ASCII
numbers, as described in “Output Syntax” on page 5-4. There
is no header. The analyzer always uses FORM4 to transfer
data that is not related to array transfers (i.e. marker
responses and instrument settings). Data is comma delimited.
FORM5PC-DOS 32-bit floating-point format with 4 bytes-per-number,
8 bytes-per-data point. The data is preceded by the same
header as in FORM1. The byte order is reversed with respect
to FORM2 to comply with PC-DOS formats. If you are using a
PC-based controller, FORM5 is the most effective format to
use.
FREO
FREO;
N/AN/A
N/AN/A
N/A
Frequency blank. Turns frequency notation off. Once the frequency notation has been turned off
(blanked), it cannot be turned back on until a preset or recall is initiated. No query response.
FRER
FRER; or FRER?;
Command Description Range Query Response
FRERPlaces the analyzer in GPIB free run mode.
(Same as continuous sweep trigger mode.)
See “CONT.”
N/A
<0|1><
L
>
F
FWD
FWD<I|M|T>;
These commands are OPC-compatible if there is only one standard in the class. If there is just one
standard, that standard is measured automatically. If there is more than one standard in the class,
2-33
Alphabetical Command Reference
HOLD
the standard being used must be selected with the STAN command.
Command Description Range Query Response
FWDISelects the forward isolation calibration
class during a 2-port calibration sequence.
FWDMSelects the forward match calibration class
during a 2-port calibration sequence.
FWDTSelects the forward transmission
calibration class during a 2-port calibration
sequence.
N/AN/A
N/AN/A
N/AN/A
HOLD
HOLD; or HOLD?;
Command Description Range Query Response
HOLDPuts the sweep trigger into hold mode.N/A
<0|1><
L
>
F
IDN?
IDN?;
Command Description Range Query Response
IDN?Query only. Outputs the identification string:
where 87NNEX is the model number of the
instrument, xxxxxxxxxx is the serial number of
the instrument, and X.XX is the firmware
revision of the instrument.
N/A See command description
IFBW
IFBW<num>[HZ]; or IFBW?;
Command Description RangeQuery Response
IFBWSets the IF bandwidth.Choose from 10, 30,
100, 300, 1000, 3000
<num><
L
>
F
IMAG
IMAG; or IMAG?;
Command Description Range Query Response
IMAGSelects the imaginary display format.N/A
<0|1><
L
>
F
2-34
Alphabetical Command Reference
INI
INI
INI<D>;
Initializes the internal disk. All previous information on the disk will be destroyed. No query
response.
INPU
INPUCALC<num><array>;
INPU<CALK|DATA|FORM><array>;
INPULEAS<learnstring>; or INPULEAS?;
INPURAW<1|2|3|4><array>;
All of these commands (with a few noted exceptions) input an array and require that you set the
format for data transfers with the FORM command. All of these commands have an associated
OUTPut command that is used to transfer data from the analyzer. See “OUTP,” later in this
chapter.
Command Description Range Query
Response
INPUCALC
INPUCALK
INPUDATAInputs an error corrected data array, using the current
INPUFORMInputs a formatted data array, using the current setting
INPULEAS
INPURAW1Inputs raw data array 1 (S
INPURAW2Inputs raw data array 2 (S
b
b
Error coefficient array
Inputs a cal kit array in FORM1 only. Can be read out
with the OUTCALK command. After the transfer, the data
should be saved into the user cal kit area with the
SAVEUSEK command.
setting of the FORM command.
of the FORM command.
Inputs a learn string in FORM1 only. Can be read out
with the OUTPLEAS command, or with INPULEAS?.
received, the analyzer stops sweeping, error-corrects the
data, then formats and displays the data.
received, the analyzer stops sweeping, error-corrects the
data, then formats and displays the data.
a
<num>.
data). After the data is
11
data). After the data is
21
two-digit
integers 01–12
N/AN/A
N/AN/A
N/AN/A
N/A
N/AN/A
N/AN/A
N/A
<data><
L
>
F
INPURAW3Inputs raw data array 3 (S
received, the analyzer stops sweeping, error-corrects the
data, then formats and displays the data.
INPURAW4Inputs raw data array 4 (S
received, the analyzer stops sweeping, error-corrects the
data, then formats and displays the data.
data). After the data is
12
data). After the data is
22
N/AN/A
N/AN/A
2-35
Alphabetical Command Reference
INPU
a. These commands input an individual error coefficient array. Before sending an array, issue a CALIXXXX; command,
where XXXX specifies the calibration type. (See “CALI” earlier in this book.) Then input the array or arrays. Lastly
store the data with the SAVC command. The instrument goes into hold, displaying uncorrected data. Complete the
process by triggering a sweep, with the CONT command (for continuous sweep) or the SING command (for a single
sweep). See Table 2-1 on page 2-37 for the contents of the different arrays.
b. Does not require a preceding “FORM” command.
2-36
Table 2-1. Error Coefficient Arrays
Alphabetical Command Reference
INT
Array
Response Response
& Isolation
01E
or E
R
T
EX (ED)
02ET (ER)ESE
03E
04E
05
06E
1-portEnhanced
b
E
D
R
Response
E
D
S
E
R
X
c
E
L
T
07E
08E
09E
10E
11E
12E
2-port
E
DF
E
SF
E
RF
E
XF
E
LF
E
TF
DR
SR
RR
XR
LR
TR
a
TRL/
LRM
E
E
E
E
E
E
E
E
E
E
E
E
DF
SF
RF
XF
LF
TF
DR
SR
RR
XR
LR
TR
O/E
Response
& Match
E
DR
E
SR
E
RR
E
XF
E
LF
E
TF
E
DF
E
SF
E
RF
E/O
Response
& Match
E
DI
E
S
E
R
E
X
E
T
a. One path, 2-port cal duplicates arrays 1 to 6 in arrays 7 to 12.
b. Response and isolation corrects for crosstalk and transmission tracking in transmission measurements, and for
directivity and reflection tracking in reflection measurements.
c. This term is used to generate the calibration coefficients, but is not used during measurement error correction.
Meaning of first subscript:M e aning of second subscript:
D: directivityF: forward
S: source matchR: reverse
R: reflection tracking
X: crosstalk or isolation
L: load match
T: transmission tracking
INT
INT<D>;
Selects the internal disk as the active storage device. N o query response.
2-37
Alphabetical Command Reference
INTE
INTE
INTE<num>; or INTE?;
Command Description RangeQuery Response
INTESets the display intensity, 50 to 100
percent.
integers 50–100
<num><
L
>
F
ISO
ISO<D|L>;
Command Description Range Query Response
ISODDone with isolation subsequence in a
2-port or enhance response calibration.
OPC-compatible.
ISOLBegins the isolation subsequence step in a
2-port calibration.
N/A N/A
N/AN/A
LIM
LIM<D|L|M|S|U><num>[DB|HZ];
These commands edit a limit test segment. The lim it tabl e edit ing is begun with EDITLIML;, and
a segment is brought up for editing wit h SEDI<num>; or added using SADD;. The segment is
closed with SDON;, the table is closed with EDITDONE;.
Command Description RangeQuery Response
LIMDSets the limit delta value while editing a
limit line segment.
LIMLSets the lower limit value.
LIMMSets the middle limit value.
LIMSSets the limit stimulus break point.
LIMUSets the upper limit value.
a. For log mag: ± 500 dB. For phase: ± 500 degrees. For Smith chart and Polar: ± 500 units. For linear magnitude: ± 500
units. For SWR:
10e-15 seconds, and 10 picounits.
b. For frequency or power sweeps, refer to “Preset State and Memory Allocation,” in your analyzer’s reference guide.
For CW time: 0 to 24 hours. For frequency sweep, transform on:
on:
±1/time step.
± 500 units. The scale is always positive, and has minimum values of 0.001 dB, 10e-12 degrees,
amplitude range
amplitude range
amplitude range
stimulus range
amplitude range
± 1/frequency step. For CW time sweep, transform
a
a
a
b
a
see “Note” below
see “Note” below
see “Note” below
see “Note” below
see “Note” below
NOTECurrently these commands can be queried by sending the command followed by
the OUTPACTI command, as in the following example to query the upper limit
2-38
Alphabetical Command Reference
value:
10 OUTPUT 716;”LIMU;OUTPACTI;”
Future revisions of firmware may support the standard query form (which
currently always returns a zero) for these commands.
LIMI
LIMI<AMPO|STIO><num>[HZ|DB]; or LIMI<AMPO|STIO>?;
LIMI<LINE|TEST><ON|OFF>; or LIMI<LINE|TEST>?;
LIMIMAOF;
These commands are used to define and display limit testing.
Command Description RangeQuery Response
LIMI
LIMIAMPOEnters the limit line amplitude offset.
LIMILINETurns the display of the limit lines on and
off.
LIMIMAOFMarker to limit offset. Centers the limit
a
amplitude range
N/A
<num><
<0|1><
N/AN/A
L
>
F
L
>
F
lines about the current marker position
using the limit amplitude offset function.
LIMISTIOEnters the stimulus offset of the limit lines.
stimulus range
LIMITESTTurns limit testing on and off.N/A
a. For log mag: ± 500 dB. For phase: ± 500 degrees. For Smith chart and Polar: ± 500 units. For linear magnitude: ± 500
units. For SWR:
10e-15 seconds, and 10 picounits.
b. For frequency or power sweeps, refer to “Preset State and Memory Allocation,” in your analyzer’s reference guide.
For CW time: 0 to 24 hours. For frequency sweep, transform on:
on:
±1/time step.
± 500 units. The scale is always positive, and has minimum values of 0.001dB, 10e-12 degrees,
± 1/frequency step. For CW time sweep, transform
b
<num><
<0|1><
L
>
F
L
>
F
LIMT
LIMT<FL|SL|SP>;or LIMT<FL|SL|SP>?;
These commands edit a limit test segment. The lim it tabl e edit ing is begun with EDITLIML;, and
a segment is brought up for editing wit h SEDI N; or added using SADD;. The segment is closed
with SDON;, the table is closed with EDITDONE;.
Command Description Range Query Response
LIMTFLMakes the segment a flat line.N/A
LIMTSLMakes the segment a sloping line.N/A
LIMTSPMakes the segment a single point.N/A
<0|1><
<0|1><
<0|1><
L
>
F
L
>
F
L
>
F
2-39
Alphabetical Command Reference
LINFREQ
LINFREQ
LINFREQ; or LINFREQ?;
Command Description Range Query Response
LINFREQSelects a linear frequency sweep.N/A
<0|1><
L
>
F
LINM
LINM; or LINM?;
Command Description Range Query Response
LINMSelects the linear magnitude display
format.
N/A
<0|1><
L
>
F
LINT
LINT<DATA|MEMO><num>;
Command Description RangeQuery Response
LINTDATA
LINTMEMO
Enters the line type for plotting data.integers 0–10 N/A
Enters the line type for plotting memory.integers 0–10 N/A
LIS
LISFREQ; or LISFREQ?;
LIS<IFBWM|PWRM><ON|OFF>; or LIS<IFBWM|PWRM>?;
List frequency functions.
Command Description Range Query Response
LISFREQSelects the list frequency sweep mode.N/A
LISIFBWMEnables/disables the IFBW setting for a
list-frequency table in swept list mode.
LISPWRMEnables/disables the power setting for a
list-frequency table in swept list mode.
N/A
N/A
<0|1><
<0|1><
<0|1><
L
>
F
L
>
F
L
>
F
2-40
LISTTYPE
LISTTYPE<LSTP|LSWP>; or LISTTYPE?;
Alphabetical Command Reference
LISTTYPE
Command Description Range
LISTTYPELSTPSelects the stepped list mode for use with a
list-frequency table.
LISTTYPELSWPSelects the swept list mode for use with a
list-frequency table.
a. 0 = stepped list mode
1 = swept list mode
N/A
N/A
Query Response
L
<0|1><
<0|1><
>
F
L
>
F
LISV
LISV;
Command Description Range Query Response
LISVActivates the list values function. Requesting a
plot (or print) copies only the current page. See
also “NEXP,”“PREP,”“PLOT,”“PRINALL,” and
“PRINTALL.”
N/A N/A
LOAD
a
LOAD<num>;
Command Description RangeQuery Response
LOADLoads the file from disk using the file name
provided by the preceding TITF<num>;
command. The actual file loaded depends
on the file title in the file position specified
by the TITF<num> command. Requires pass
control mode when using the GPIB port.
integers 1–5N/A
LOGFREQ
LOGFREQ; or LOGFREQ?;
Command Description Range Query Response
LOGFREQSelects a log frequency sweep.N/A
<0|1><
L
>
F
2-41
Alphabetical Command Reference
LOGM
LOGM
LOGM; or LOGM?;
Command Description Range Query Response
LOGMSelects the log magnitude display format. N/A
<0|1><
L
>
F
MANTRIG
MANTRIG; or MANTRIG?;
Command Description Range Query Response
MANTRIGSets the trigger mode to manual trigger on
point. OPC-compatible.
N/A
<0|1><
L
>
F
MAN_LASER
MAN_LASER<ON|OFF>; or MAN_L AS ER?;
Toggles laser on and off (with autobias).
MARK
MARK<1|2|3|4|5><num>; or MARK<1|2|3|4|5>?;
MARK<3DB|BUCK|FAUV|FSTI|FVAL><num>; or MARK<BUCK|FAUV|FSTI|FVAL>?;
MARK<CONT|COUP|DISC|MAXI|MINI|OFF|UNCO>; or
MENUOFFBlanks the softkey menu. Use with caution, as this
may give unusual results when setting up an
instrument state. Recommend setting up states
using MENUON (default) and, when setup is complete,
using MENUOFF .
MENUAVGBrings up the menu associated with the Avg front
panel key.
N/AN/A
N/AN/A
MENUCALBrings up the menu associated with the
panel key.
MENUCOPYBrings up the menu associated with the
panel key.
MENUDISPBrings up the menu associated with the
panel key.
MENUFORMBrings up the menu associated with the
panel key.
MENUMARKBrings up the menu associated with the
panel key.
MENUMEASBrings up the menu associated with the
panel key.
MENUMRKFBrings up the menu associated with the
front panel key.
MENUSRCHBrings up the menu associated with the
front panel key.
Cal front
Copy front
Display front
Format front
Marker front
Meas front
Marker Fctn
Marker Fctn
N/AN/A
N/AN/A
N/AN/A
N/AN/A
N/AN/A
N/AN/A
N/AN/A
N/AN/A
2-46
Alphabetical Command Reference
MINMAX
Command Description Range Query
Response
MENUPOWEBrings up the menu associated with the Marker Fctn
front panel key.
MENURECABrings up the menu associated with the
front panel key
MENUSAVEBrings up the menu associated with the
front panel key
MENUSCALBrings up the menu associated with the
front panel key.
MENUSTIMBrings up the menu associated with the
front panel key.
MENUSWEEBrings up the menu associated with the
front panel key.
MENUSYSTBrings up the menu associated with the
panel key.
Save/Recall
Save/Recall
Scale Ref
Sweep Setup
Sweep Setup
System front
Front Panel Equivalents
Press the associated hardkey listed above.
MINMAX
N/AN/A
N/AN/A
N/AN/A
N/AN/A
N/AN/A
N/AN/A
N/AN/A
MINMAX<ON|OFF>; or MINMAX?;
Command Description Range Query Response
MINMAXEnables/disables min/max recording per
segment. Min and max values are recorded
per limit segment. Limit testing need not be
active.
N/A
<0|1><
L
>
F
For more information refer to “Limit Line and Data Point Special Functions” on page8-125.
MINU
MINU; or MINU?;
Command Description Range Query Response
MINUData minus memory (linear subtraction).
See also “DISPDMM.”
N/A
<0|1><
L
>
F
MODEI;
Model to memory.
2-47
Alphabetical Command Reference
NEXP
NEXP
NEXP;
Displays the next page of the operating parameters list. (Use OPEP to display the operating
parameters list.) No query response.
NUMG
NUMG<num>;
Command Description RangeQuery Response
NUMGActivates the indicated number of groups
of sweeps. A group is whatever is needed to
update the current parameter once. This
function restarts averaging if it is enabled.
OPC-compatible.
integers 1–999N/A
OMII
OMII;
Omits the isolation step of a calibration sequence. No query response.
OPC
OPC; or OPC?;
Command Description Range
OPCOperation complete. Reports the
completion of the next command received
by setting bit 0 in the event-status register,
or by replying to an interrogation if OPC? is
issued.
N/A
Query Response
L
<0|1><
>
F
a
a. 0 = next command not yet completed
1 = next command completed
2-48
Alphabetical Command Reference
OPEP
OPEP
OPEP;
Presents a list of key operating parameters. Requesting a plot (or print) copies only the current
page. See also “NEXP,”“PREP,”“PLOT,”“PRINALL,” and “PRINTALL.” No query response.
OUTP
In the following “Syntax” section, commands are grouped alphabetically by common syntax form,
not necessarily due to common functionality.
NOTEMost commands that output an array require that you set the format for data
transfers with the FORM command.
Many of these commands have an associated INPUT command that is used to transfer data to the
analyzer. Refer to “Alphabetical Command Reference” on page 2-2 for a list of input commands.
2-49
Alphabetical Command Reference
OUTP
Command Description RangeResponse
OUTPACTIOutputs the value of the active function, or
the last active function if the active entry
area is off. The value is returned in ASCII
format.
OUTPAMAX
a
Outputs the max values for all limit line
segments. This is an ASCII transfer
(FORM4).
OUTPAMIN
a
Outputs the min values for all limit line
segments. This is an ASCII transfer
(FORM4).
OUTPAPEROutputs the smoothing aperture in
stimulus units, rather than as a percentage.
OUTPCALCOutputs the selected error coefficient array
for the active cal on the active channel.
b
OUTPCALKOutputs the currently active calibration kit,
as a string of less than 1000 bytes. The data
is in FORM1.
OUTPFARPLPTOutputs the onscreen failed ripple point
information in the following commaseparated value format: the number of
failed points followed by pairs of numbers
representing the first failed frequency, first
failure value, second failed frequency,
second failure value, and so on.
N/A
N/A
N/A
N/A
two-digit
integers 01–12
N/A
N/A
L
>
<$><
F
L
<array><
<array><
<num><
<array><
<$><
>
F
L
>
F
L
>
F
L
>
F
L
>
F
<num,array><
L
>
F
OUTPCHANOutputs the active channel number: 1, 2, 3,
N/A
or 4.
OUTCNTROutputs the ABUS counter.N/A
OUTPDATAOutputs the error-corrected data from the
N/A
active channel in real/imaginary pairs. See
Figure 6-1 on page 6-3.
OUTPDATPOutputs the trace data indexed by point
N/A
(see “SELPT”).
OUTPDATROutputs the trace data for a range of points
N/A
(see “SELMINPT,”“SELMAXPT”). This is an
ASCII (FORM4) transfer.
OUTPERROOutputs the oldest error message in the
N/A
error queue. Sends the error number first,
and then the error message itself, as an
ASCII (FORM4) string no longer than 50
characters.
<num><
<array><
L
>
F
L
>
F
<num,num><
L
<array><
<num,$><
>
F
L
F
L
>
F
>
2-50
Alphabetical Command Reference
Command Description RangeResponse
OUTP
OUTPFAIPThis command is similar to OUTPLIMF
except that it reports the number of
failures first, followed by the stimulus and
trace values for each failed point in the
test. ASCII format.
a
OUTPFORMOutputs the formatted display data array
from the active channel, in current display
units. See Table 2-3 on page 2-76.
OUTPIDENOutputs the identification string for the
analyzer in the form:
Agilent,8703B,xxxxxxxxxx,X.XX where
8703B is the model number of the
instrument, xxxxxxxxxx is the serial
number of the instrument, and X.XX is the
firmware revision of the instrument. (Same
as the “IDN?” command.)
OUTPLEASOutputs the learn string, which contains
the entire front panel state, the limit table,
and the list frequency table. It is always in
binary format not intended for decoding.
OUTPLIMOutputs the status of the limit test for the
a,
channel selected with <num>.
c
OUTPLIMFOutputs the limit test results for each failed
point, followed by the number of failed
a
points. This is an ASCII transfer.
,d
N/A
N/A
N/A
N/A
integers 1–4
N/A
L
<array><
<array><
<$><
>
F
L
>
F
L
>
F
<learnstring><
<0|1|−1><
<array><
L
F
L
>
F
L
>
F
>
OUTPLIMLOutputs the limit test results for each point
in the sweep. This is an ASCII transfer.
a,c,d
OUTPLIMMOutputs the limit test results at the active
marker.
a,c,d
OUTPMARKOutputs the active marker values. The first
two numbers are the marker response
values, and the last is the stimulus value.
See Table 2-3 on page 2-76 for the meaning
of the response values as a function of
display format.
OUTPMAXPOutputs the maximum point value between
selected points.
OUTPMEMOOutputs the memory trace from the active
channel. The data is in real/imaginary
pairs, and can be treated the same as data
read with the OUTPDATA command. See
Figure 6-1 on page 6-3.
N/A
N/A
N/A
N/A
N/A
L
<array><
>
F
<num,num,num,num><
>
F
L
<num,num,num><
<num,num><
L
<array><
>
F
>
F
L
>
F
L
2-51
Alphabetical Command Reference
OUTP
Command Description RangeResponse
OUTPMINPOutputs the minimum point value between
N/A
selected points.
OUTPMRISOutputs three values for risetime.N/A
OUTPMSTAOutputs the marker statistics in ASCII
N/A
format: mean, standard deviation, and
peak-to-peak variation in that order. If
statistics is not on, it is turned on to
generate current values and turned off
again. See also “MEASTAT.”
OUTPMWIDOutputs the marker bandwidths search
N/A
results in ASCII format: bandwidth, center,
and Q in that order. If widths is not on, it is
turned on to generate current values and
then turned off again.
OUTPOPTSOutputs an ASCII string of the options
N/A
installed in the analyzer.
OUTPPLOTOutputs the HPGL plot string in ASCII
N/A
format to the GPIB port. Can be directed to
a plotter, or read into the computer.
OUTPPRINOutputs a PCL raster dump of the display,
N/A
intended for a graphics printer.
L
<num,num><
>
F
<num,num,num><
<num,num,num><
<num,num,num><
L
<$><
>
F
L
>
<$><
F
L
<$><
>
F
L
>
F
L
>
F
L
>
F
OUTPRAWOutputs the selected raw data array. See
Figure 6-1 on page 6-3.
OUTPRIPLOutputs the peak-to-peak ripple between
selected points.
OUTPRPLBNDALLOutputs the measured ripple values for all
active frequency bands in the following
comma-separated value format: the number
of bands followed by pairs of numbers
representing the first band number (1),
ripple value of first band, second band
number (2), ripple value of second band,
and so on.
OUTPRPLBNDPFOutputs the pass/fail status for selected
frequency band (see
“SELBND”) as “1”
(band passes) or as “0” (band fails).
OUTPRPLBNDVALOutputs the ripple value for selected
frequency band (see “SELBND”).
integers 1–4:
1=S11 data
2=S21 data
3=S
data
12
4=S22 data
Frequency
range
N/A
N/A
N/A
L
<array><
>
F
<num,num><
<num,array><
L
<0|1><
<num><
>
F
L
>
F
L
>
F
L
>
F
2-52
Alphabetical Command Reference
Command Description RangeResponse
OUTP
OUTPSEGAFOutputs the segment number and its limit
N/A
test st atus for all active segments. Th is is an
ASCII transfer.
OUTPSEGAMOutputs the limit test min/max for all
a,c
N/A
segments. Outputs the segment number,
max stimulus, max value, min stimulus,
min value for all active segments. This is an
ASCII transfer.
OUTPSEGFOutputs the limit test status for a specified
segment. See also “SELSEG.”
OUTPSEGMOutputs limit test min/max for a specified
segment. See also “SELSEG.”
OUTPSERNOutputs a string that contains the serial
a,c
N/A
a,c
N/A
a
N/A
number of the analyzer.
OUTPSTATReturns the status byte as an ASCII integer
N/A
(0–255) that can be interpreted as the 8-bit
status byte. Refer to “The Status Byte” on
page 7-6 for more information about the
status byte. This command is the same as
“STB?.”
OUTPTESSOutputs the test statusN/A
L
<array><
<array><
<0|1|−1><
>
F
L
>
F
L
<num,num><
L
>
<$><
F
L
<num><
>
F
>
F
L
>
F
OUTPTITLOutputs the display title in ASCII format.N/A
a. Refer to “Limit Line and Data Point Special Functions” on page 8-125.
b. See Table 2-1 on page 2-37 for the contents of the different arrays. Each array is output in the currently set form
determined by the FORM command. The data is in real/imaginary pairs, with the same number of pairs as points in the
sweep.
c. Values returned for limit test status are: 0 (fail), 1 (pass), or
d. This command outputs the limit test results. The results consist of four f ields. First is the stimulus value for the point.
Second is an integer indicating test status. Third is the upper limit at that point. Fourth is the lower limit at that
point. If there are no limits at that point, the third and forth fields are zero.
−1 (no limit).
<$><
L
>
F
2-53
Alphabetical Command Reference
PAUS
OUTP Reference Tables
Table 2-2. Error Coefficient Arrays
Array
Response Response
& Isolation
01E
or E
R
T
EX (ED)
02ET (ER)ESE
03E
04E
05
06E
1-portEnhanced
b
E
D
R
Response
E
D
S
E
R
X
c
E
L
T
07E
08E
09E
10E
11E
12E
2-port
E
DF
E
SF
E
RF
E
XF
E
LF
E
TF
DR
SR
RR
XR
LR
TR
a
TRL/
LRM
E
E
E
E
E
E
E
E
E
E
E
E
DF
SF
RF
XF
LF
TF
DR
SR
RR
XR
LR
TR
O/E
Response
& Match
E
DR
E
SR
E
RR
E
XF
E
LF
E
TF
E
DF
E
SF
E
RF
E/O
Response
& Match
E
DI
E
S
E
R
E
X
E
T
a. One path, 2-port cal duplicates arrays 1 to 6 in arrays 7 to 12.
b. Response and isolation corrects for crosstalk and transmission tracking in transmission measurements, and for
directivity and reflection tracking in reflection measurements.
c. This term is used to generate the calibration coefficients, but is not used during measurement error correction.
Meaning of first subscript:M e aning of second subscript:
D: directivityF: forward
S: source matchR: reverse
R: reflection tracking
X: crosstalk or isolation
L: load match
T: transmission tracking
PAUS
PAUS;
Pauses the sequence; to be followed b y CONS to resume the sequence. No query response.
2-54
Alphabetical Command Reference
PHAO
PHAO<num>; or PHAO?;
Command Description RangeQuery Response
PHAO
PHAOSets the phase offset.0–360 degrees
<num><
L
>
F
PHAS
PHAS; or PHAS?;
Command Description Range Query Response
PHASSelects the phase display format. N/A
<0|1><
L
>
F
PLOT
PLOT;
Initiates a plot. Requires pass control mode when using the GPIB port. No query response.
NOTEThis command should be followed by a wait equal to 2 sweeps. Example wait code
written in BASIC:
OUTPUT 716;"POIN801;"
OUTPUT 716;”SWET?;”
ENTER 716;T
WAIT 2*T
2-55
Alphabetical Command Reference
POL
POL
POL<A|MLIN|MLOG|MRI>; or POL<A|MLIN|MLOG|MRI>?;
Command Description Range Query Response
POLASelects the polar display format. N/A
POLMLINSelects linear as the marker readout format
for polar display.
POLMLOGSelects log as the marker readout format
for polar display.
POLMRISelects real/imaginary as the marker
readout format for polar display.
N/A
N/A
N/A
<0|1><
<0|1><
<0|1><
<0|1><
L
>
F
L
>
F
L
>
F
L
>
F
PORE
PORE<ON|OFF>; or PORE?;
Command Description Range Query Response
PORETurns port extensions on and off.N/A
<0|1><
L
>
F
PORT
PORT<1|2><num>[S];or PORT<1|2>?;
These commands set the port extension length for the indicated port or input.
Ports 1 and 2 refer to the test set ports.
Command Description RangeQuery Response
PORT1Port 1±10 seconds
PORT2Port 2±10 seconds
<num><
<num><
L
>
F
L
>
F
PORTP
PORTP<CPLD|UNCPLD>; or PORTP?;
Command Description Range
PORTPSelects either coupled or uncoupled for the
port powers of a given channel.
a. 0 = uncoupled
1 = coupled
N/A
2-56
Query Response
L
<0|1><
>
F
a
Alphabetical Command Reference
POWE
POWE<num>[DB]; or POWE?;
Command Description RangeQuery Response
POWE
POWESets the output power level.output power
range of your
analyzera
a. The output power range of your analyzer depends upon the model and installed options. Refer to your analyzer’s
reference guide to determine the power range of your analyzer.
<num><
L
>
F
POWS
POWS; or POWS?;
Command Description Range Query Response
POWSSelects power sweep, from the sweep type
menu.
N/A
<0|1><
L
>
F
PRAN
Syntax
PRAN<num>;
Command Description RangeQuery Response
PRANSets the source power range.
a. PRAN0 through PRAN7 are used for ranges 0 through 7.
b. Use two-digit integers 01 through 12. PRAN01 through PRAN12 are used for ranges 0 through 11.
integers
integers
a
0–7
b
01–12
N/A
PRES
PRES;
Presets the analyzer to the factory preset state. OPC-compatible. No query response.
NOTEPressing the Preset key on the analyzer will either invoke the factory preset state,
or a user-selected state (if one has been set up). Sending the PRES command will
always invoke the factory preset state. This i s true even if the analyz er is cur rently
set up to recall a user preset st ate when t he
State and Memory Allocation” on page9-1. For more information on user presets,
see your analyzer’s user’s guide.
Preset key is pressed. Refer to “Preset
2-57
Alphabetical Command Reference
PWRR
NOTEThis command should use OPC? to prevent timing errors with subsequent
commands. Example code written in BASIC:
10 OUTPUT 716;"OPC?;PRES;"
20 ENTER 716;X
PWRR
PWRR<PMAN|PAUTO>; or PWRR?;
Command Description Range Query Response
L
PWRRSelects whether the power range is in auto
or manual mode.
a. 0 = manual mode
1 = auto mode
N/A
<0|1><
a
>
F
PULV [value];
Set pulse width search value.
PULW<ON|OFF>;
Select pulse width sear ch OF F /ON.
RAI
RAI<D|ISOL|RESP>;
Command Description Range Query Response
RAIDCompletes the response and isolation cal
sequence. OPC-compatible.
RAIISOLCalls the isolation class for the response
and isolation calibration.
RAIRESPCalls the response class for the response
and isolation calibration.
N/AN/A
N/AN/A
N/AN/A
RAMD;
Response and match cal done.
2-58
Alphabetical Command Reference
READ
READ<DATE|TIME>;
Command Description Range Query Response
READ
READDATEOutputs the date in the following string
format: DD MMM YYYY.
READTIMEOutputs the time in the following string
format: HH:MM:SS.
N/AN/A
N/AN/A
REAL
REAL; or REAL?;
Command Description RangeQuery Response
REALSets the display format to real.N/A
<0|1><
L
>
F
RECAREG
RECAREG<num>;
Command Description RangeQuery Response
RECAREGRecalls from save/recall registers 01–31.
OPC-compatible.
two-digit
integers 01–31
N/A
RECAREG<1-31>;
Recalls previously saved display colo rs. No query response.
RECEOUT<ON|OFF>;
Select path to receiver output; ON=CAL, OFF = OPT.
2-59
Alphabetical Command Reference
RECO
RECO
RECO;
Recalls previously saved display colo rs. No query response.
REF
REF<D|L>;
Command Description RangeQuery Response
REFDCompletes the reflection calibration
subsequence of a 2-port calibration.
OPC-compatible.
REFLBegins the reflection calibration
subsequence of a 2-port calibration.
N/AN/A
N/AN/A
REF
REF<P|V><num>; or REF<P|V>?;
Command Description RangeQuery Response
REFPEnters the reference position. 0 is the
bottom, 10 is the top of the graticule.
REFVEnters the reference line value.
a. For log mag: ± 500 dB. For phase: ± 500 degrees. For Smith chart and Polar: ± 500 units. For linear magnitude: ± 500
units. For SWR:
−15 seconds, and 10 picounits.
10e
± 500 units. The scale is always positive, and has minimum values of 0.001dB, 10e−12 degrees,
integers 0–10
amplitude range
a
<num><
<num><
L
>
F
L
>
F
REFT
REFT;
Recalls file titles from disk. Requires pass control if using an external disk drive on GPIB. No
query response.
RESC
RESC;
Command Description RangeQuery Response
RESCResume a previously started cal sequence.N/AN/A
2-60
Alphabetical Command Reference
RESD
RESD;
Command Description Range Query Response
RESD
RESDRestores the measurement display after
viewing the operating parameters or list
values.
N/A N/A
RESM;
Reset model 1.
RESPDONE
RESPDONE;
Command Description Range Query Response
RESPDONECompletes the response calibration
sequence. OPC-compatible.
N/A N/A
REST
REST;
Measurement restart. No query response.
REV
REV<I|M|T>;
These commands are OPC-compatible if there is only one standard in the class. If there is just one
standard, that standard is measured automatically. If there is more than one standard in the class,
the class command only calls another menu.
Command Description Range Query Response
REVICalls the reverse isolation calibration class
during a full 2-port calibration.
REVMCalls the reverse match calibration class
during a full 2-port calibration.
REVTCalls the reverse transmission calibration
class during a full 2-port calibration.
N/A N/A
N/AN/A
N/AN/A
2-61
Alphabetical Command Reference
RLIMLINE
RLIMLINE
RLIMLINE<ON|OFF>; or RLIMLINE?;
Command Description RangeQuery Response
RLIMLINETurns the lines that represent the ripple
test limits on and off.
N/A
<0|1><
L
F
RLIMM
RLIMM<num>[DB]; or RLIMM?;
Command Description RangeQuery Response
RLIMMSets the value of the maximum allowable
ripple limit for current frequency band.
0.01 to 100 dB
<num><
L
>
F
RLIMSTP
RLIMSTP<num>[HZ|KHZ|MHZ|GHZ]; or RLIMSTP?;
Command Description RangeQuery Response
RLIMSTPSets the stop frequency of the current
frequency band.
a. Refer to “Preset State and Memory Allocation.”
stimulus range
a
<num><
L
>
F
>
RLIMSTR
RLIMSTR<num>[HZ|KHZ|MHZ|GHZ]; or RLIMSTR?;
Command Description RangeQuery Response
RLIMSTRSets the start frequency of the current
ripple limit.
a. Refer to “Preset State and Memory Allocation.”
stimulus range
a
<num><
L
>
F
RLIMTEST
RLIMTEST<ON|OFF>; or RLIMTEST?;
Command Description RangeQuery Response
RLIMTESTTurns the ripple limit test on and off. N/A
2-62
<0|1><
L
>
F
Alphabetical Command Reference
RLIMVAL
RLIMVAL<OFF|ABS|MAR>;
Command Description RangeQuery Response
RLIMVAL
RLIMVALDisplays the ripple limit value of the
selected band (see “SELBND”) in absolute
format (ABS) or margin format (MAR). OFF
turns the displayed ripple limit value off.
N/AN/A
RST
RST;
Presets the analyzer to the factory preset state. OPC-compatible. See Chapter 9, “Preset State
and Memory Allocation” No query response.
NOTEPressing the Preset key on the analyzer will either invoke the factory preset state,
or a user-selected state (if one has been set up). Sending the RST command will
always invoke the factory preset state. This i s true even if the analyz er is cur rently
set up to recall a user preset state when the
Preset key is pressed. For more
information on user preset s, see your analyzer’s user’s guide.
S
S<11|12|21|22>; or S<11|12|21|22>?;
Command Description RangeQuery Response
S11Forward reflection measurementN/A
S12Reverse transmission measurementN/A
S21Forward transmission measurement N/A
S22
Reverse reflection measurement
N/A
<0|1><
<0|1><
<0|1><
<0|1><
L
>
F
L
>
F
L
>
F
L
>
F
SADD
SADD;
Adds a new segment to the table during a list-frequency, limit-table, cal sensor table, or power
loss table edit. No query response.
2-63
Alphabetical Command Reference
SAV
SAV
SAV<1|2|C>;
Command Description Range Query Response
SAV1Completes the 1-port calibration sequence.
OPC-compatible.
SAV2Completes the 2-port calibration sequence.
OPC-compatible.
SAVCCompletes the transfer of error correction
coefficients back into the instrument.
OPC-compatible.
N/A N/A
N/AN/A
N/AN/A
SAVE
SAVEREG<num>;
Command Description RangeQuery Response
SAVEREGSaves to save/recall registers 01–31.
SAVEREG01 through SAVEREG05 are the
same as SAVE1 through SAVE5.
OPC-compatible.
two-digit
integers 01–31
N/A
SAVECSV
SAVECSV;
Saves the current measurement to the disk drive in the comma-separated value (CSV) format. No
query response.
SAVEJPG
SAVEJPG;
Saves the current display to the disk drive in the JPG format. OPC-compatible. No query
response.
SAVU
SAVU<ASCI|BINA>;
Command Description Range Query Response
SAVUASCISelects ASCII format for saving to disk.
Conforms to CITIFile specifications.
SAVUBINASelects binary format for saving to disk.N/AN/A
2-64
N/AN/A
Alphabetical Command Reference
SCAL
SCAL<num>; or SCAL?;
Command Description RangeQuery Response
SCAL
SCALSets the trace scale factor.
a. For log mag: ± 500 dB. For phase: ± 500 degrees. For Smith chart and Polar: ± 500 units. For linear magnitude: ±500
units. For SWR:
10e
−15 seconds, and 10 picounits.
± 500 units. The scale is always positive, and has minimum values of 0.001dB, 10e−12 degrees,
amplitude range
a
<num><
L
>
F
SDEL
SDEL;
Deletes the current segment while editing a list frequency, a limit table, or a power loss list. No query
response.
SDON
SDON;
Closes a segment after editing a list frequency, a limit table, or a power loss list.No query response.
SEA
SEA<L|R>;
SEA<MAX|MIN|OFF>; or SEA<MAX|MIN|OFF>?;
SEATARG<num>; or SEATARG?;
These commands control the marker searches. The marker searches place the active marker
according to the indicated search criteria. The search is continuously updated if tracking is ON
(see “TRACK”).
Command Description RangeQuery Response
SEALSearch left for next occurrence of the target
value.
SEAMAXSearch for trace maximum on the current
channel.
SEAMINSearch for trace minimum on the current
channel.
SEAOFFTurns the marker search off. N/A
SEARSearch right for next occurrence of the
target value.
SEATARGSet the search target amplitude.
N/AN/A
N/A
N/A
N/AN/A
amplitude range
a
<0|1><
<0|1><
<0|1><
<num><
L
>
F
L
>
F
L
>
F
L
>
F
2-65
Alphabetical Command Reference
SEDI
a. For log mag: ± 500 dB. For phase: ± 500 degrees. For Smith chart and Polar: ± 500 units.
For linear magnitude:
± 500 units. For SWR: ± 500 units.
SEDI
SEDI<num>; or SEDI?;
Command Description RangeQuery Response
SEDIDuring either a frequency, limit, or power
loss table edit, selects segment <num> for
editing.
state dependent.
Range for
frequency segment
= 1 to 30. Range for
limit t est segment =
1 to 18 . Range for
power loss table
segment = 1 to 12
<num><
L
>
F
SEG
SEG<IFBW|POWER><num>;
Command Description RangeQuery Response
SEGIFBWSets the IFBW for the active segment of a
list-frequency table in swept list mode.
SEGPOWERSets the power for the active segment of a
list-frequency table in swept list mode.
a. The output power range is dependent upon the model and option configuration of your analyzer. Refer to your
analyzer’s reference guide to determine the output power range of your analyzer.
Choose from 10,
30, 100, 300,
1000, 3000,
3700, 6000
output power
range of your
analyzer
a
see “Note” below
see “Note below
NOTECurrently these commands can be queried by sending the command followed by
the OUTPACTI command, as in the following example to query the upper limit
value:
10 OUTPUT 716;”SEGIFBW;OUTPACTI;”
Future revisions of firmware may support the standard query form (which
currently always returns a zero) for these commands.
2-66
Alphabetical Command Reference
SEL
SEL<MAXPT|MINPT|PT|SEG><num>; or SEL<MAXPT|MINPT|PT|SEG>?;
Command Description RangeQuery Response
SEL
SELMAXPTSelects the last point number in the range
of points that the
report.
SELMINPTSelects the first point number in the range
of points that the
report.
SELPTSelects the point number that the
OUTPDATR command will
OUTPDATR command will
OUTPDATP command will report.
SELSEGSelects the segment number to report on
for the
OUTPSEGF and OUTPSEGM
commands.
0 to n−1, where
n=number of
points
0 to n−1, where
n=number of
points
0 to n−1, where
n=number of
points
integers 1–18
<num><
<num><
<num><
<num><
L
>
F
L
>
F
L
>
F
L
>
F
NOTEFor the definition of a limit segment, see “Limit Line and Data Point Special
Functions” on page 8-125.
SELBND
SELBND<num>; or SELBND?;
Command Description RangeQuery Response
SELBNDSelects the ripple frequency band for the
following commands: OUTPRPLBNDPF,
OUTPRPLBNDVAL, and RLIMVAL.
integers 1−12
<num><
L
>
F
SET
SET<Z><num>; or SET<BIT|Z>?;
SET<DATE|TIME><$>;
Command Description RangeQuery Response
SETDATESets the date in the following format: DD
MMM YYYY, where DD is the day and must
be 2 digits, MMM is the month and must be
three alpha characters (JAN, FEB, MAR,
APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV,
DEC), and YYYY is the year and must be 4
digits.
See “Description .”N/A
2-67
Alphabetical Command Reference
SING
Command Description RangeQuery Response
SETTIMESets the time in the following format:
HH:MM:SS, where HH is the hour, MM is
minutes, SS is seconds, and each must be 2
digits.
SETZSets the characteristic impedance of the
measurement system.
See “Description .”N/A
0.1 to 500 Ω
<num><
SING
SING;
Single sweep. OPC-compatible. No query response.
SLI
SLI<D>;
Sliding load done. No query response.
SMI
SMI<C|MGB|MLIN|MLOG|MRI|MRX>; or SMI<C|MGB|MLIN|MLOG|MRI|MRX>?;
L
>
F
Command Description Range Query Response
SMICSelects Smith chart display format. N/A
SMIMGBSelects G+jB (conductance and
susceptance) marker readout on a Smith
chart.
SMIMLINSelects linear magnitude marker readout
on a Smith chart.
SMIMLOGSelects log magnitude marker readout on a
Smith chart.
SMIMRISelects real/imaginary pairs (resistance
and reactance) marker readout on a Smith
chart.
SMIMRXSelects R + jX marker readout on a Smith
chart.
N/A
N/A
N/A
N/A
N/A
<0|1><
<0|1><
<0|1><
<0|1><
<0|1><
<0|1><
L
>
F
L
>
F
L
>
F
L
>
F
L
>
F
L
>
F
SMOO
SMOOAPER<num>; or SMOOAPER?;
2-68
Alphabetical Command Reference
SMOOO<ON|OFF>; or SMOOO?;
Command Description RangeQuery
Response
SOFR
<0|1><
L
L
F
SMOOAPERSets the smoothing aperture as a percent of the
trace.
SMOOOSelects whether smoothing is on or off. N/A
0.05 to 20%
<num><
SOFR
SOFR;
Displays the firmware revision on the screen. No query response.
SOFT
SOFT<num>;
Command Description RangeQuery Response
SOFTActs as though the indicated softkey was
pressed.
integers 1–8 N/A
SOUP
>
F
>
SOUP<ON|OFF>; or SOUP?;
Command Description Range Query Response
SOUPSelects whether the source power is on or
off.
N/A
<0|1><
L
>
F
SPAN
SPAN<num>[HZ|DB]; or SPAN?;
Command Description RangeQuery Response
SPANSets the stimulus span value. If a list
frequency segment is being edited, sets the
span of the list segment.
a. For frequency or power sweeps, refer to “Preset State and Memory Allocation,” in your analyzer’s reference guide.
For CW time: 0 to 24 hours. For frequency sweep, transform on:
±1/time step.
on:
stimulus range
± 1/frequency step. For CW time sweep, transform
a
<num><
L
>
F
2-69
Alphabetical Command Reference
SPLD
SPLD
SPLD<ON|OFF>; or SPLD?;
Command Description RangeQuery Response
SPLDTurns the split display mode on and off. N/A
<0|1><
L
>
F
SPLID
SPLID<1|2|4>; or SPLID<1|2|4>?;
Command Description Range Query Response
SPLID1Puts all displayed channels on one full-size
graticule.
SPLID2Puts all displayed channels on two
graticules.
SPLID4Puts each displayed channel on a separate
graticule.
N/A
N/A
N/A
<0|1><
<0|1><
<0|1><
L
>
F
L
>
F
L
>
F
SRE
SRE<num>; or SRE?;
Command Description RangeQuery Response
SREService request enable. A bit set in <num>
enables the corresponding bit in the status
byte to generate an SRQ.
integers 0–255
<num><
L
>
F
SSEG
SSEG<num>; or SSEG?;
Command Description RangeQuery Response
SSEGSelects the desired segment of the
frequency list for a list frequency sweep.
See also “ASEG”.
integers 1–30
<num><
L
>
F
ST AN
STAN<A|B|C|D|E|F|G>;
2-70
Alphabetical Command Reference
Standards A through G are associated with softkeys 1 through 7, respectively.
Command Description RangeQuery
Response
STAR
STANAThese 7 commands (OPC-compatible) select a
STANBN/AN/A
STANCN/AN/A
STANDN/AN/A
STANEN/AN/A
STANFN/AN/A
STANGN/AN/A
standard from a class during a calibration sequence.
If a class is requested, as in CLASS11A (S11 1-port
cal) the analyzer will do one of two things:
• If there is only one standard in the class, it will
measure that standard automatically.
• If there are several standards in the class, then
one of these commands must be used to select
one of these standards, causing it to be
measured.
N/A N/A
ST AR
STAR<num>[HZ|DB]; or STAR?;
Command Description RangeQuery Response
STARSets the start stimulus value. If a list
frequency segment is being edited, sets the
start of the list segment.
a. For frequency or power sweeps, refer to “Preset State and Memory Allocation,” in your analyzer’s reference guide.
For CW time: 0 to 24 hours. For frequency sweep, transform on:
on:
±1/time step.
stimulus range
± 1/frequency step. For CW time sweep, transform
a
<num><
L
>
F
STB?
STB?;
Command Description RangeQuery Response
STB?Query only. Outputs the status byte in
ASCII format (FORM4). Same as
OUTPSTAT.
N/A
<num><
L
>
F
STEPSWP
Syntax
STEPSWP<ON|OFF>; or STEPSWP?;
Command Description RangeQuery Response
STEPSWPTurns step sweep mode on or off.N/A
<0|1><
L
>
F
2-71
Alphabetical Command Reference
STOP
STOP
STOP<num>[HZ|DB]; or STOP?;
Command Description RangeQuery Response
STOPSets the stop stimulus value. If a list
frequency segment is being edited, sets the
stop of the list segment.
a. For frequency or power sweeps, refer to “Preset State and Memory Allocation,” in your analyzer’s reference guide.
For CW time: 0 to 24 hours. For frequency sweep, transform on:
on:
±1/time step.
stimulus range
± 1/frequency step. For CW time sweep, transform
a
<num><
L
>
F
STPSIZE
STPSIZE<num>[HZ|DB]; or STPSIZE?;
Command Description RangeQuery Response
STPSIZESets the step size while editing a list
frequency segment.
a. For frequency or power sweeps, refer to “Preset State and Memory Allocation,” in your analyzer’s reference guide.
For CW time: 0 to 24 hours. For frequency sweep, transform on:
±1/time step.
on:
stimulus range
±1/frequency step. For CW time sweep, transform
a
<num><
L
>
F
SWE
SWEA;
SWET<num>[S]; or SWET?;
Command Description RangeQuery Response
SWEAAutomatically selects the fastest sweep
time based on the current analyzer settings
for number of points, IF bandwidth, sweep
mode, averaging condition and frequency
span.
SWETSets the sweep time. (Setting SWET0 is
equivalent to sending the
SWEA command.)
N/A N/A
0–86,400 s
<num><
L
>
F
NOTEThe SWET command should be followed by a wait equal to 2 sweeps. Example wait
code written in BASIC:
10 OUTPUT 716;"SWET.1;"
20 WAIT 2*.1
2-72
Alphabetical Command Reference
SWR
SWR; or SWR?;
Command Description RangeQuery Response
SWR
SWRSelects the SWR display format.N/A
<0|1><
L
>
F
TESS?
TESS?;
Command Description Range Query Response
TESS?Query only. Queries whether a test set is
connected. Returns a one on the standard
analyzer.
N/A
<0|1><
L
>
F
TINT
TINT<num>; or TINT?;
Command Description RangeQuery Response
TINTAdjusts the tint for the selected display
feature.
integers 0–100
<num><
L
>
F
TIT
TIT<F|REG><num><$>;
TIT<L><$>;
TITSQ;
Command Description Range Query Response
TITFTitles the indicated file numbers.<num>: 1–5
<$>: 10 char. max.
TITLEnters a new display title.48 characters maxN/A
TITREGTitles save/recall registers 01 through 31.
TITREG01 through TITREG05 are the
same as
TITR1 through TIT R5.
<num>: 01–31
<$>: 10 char. max.
N/A
N/A
2-73
Alphabetical Command Reference
TRA
TRA
TRA<D|N>;
Command Description RangeQuery Response
TRADCompletes the transmission calibration
subsequence of a 2-port calibration or
enhanced response calibration.
OPC-compatible.
TRANBegins the transmission calibration
subsequence of a 2-port calibration or
enhanced response calibration.
N/A N/A
N/AN/A
TRACK
TRACK<ON|OFF>; or TRACK?;
Command Description Range Query Response
TRACKTurns marker search tracking on and off.N/A
<0|1><
L
>
F
20 ENTER 716;X
TRIG
TRIG;
Wait for sweep trigger.
TST?
TST?;
Command Description RangeQuery Response
TST?Query only. Causes a self test and returns a
zero if the test is passed.
N/A
<num><
L
>
F
TSTP
TSTP<P1|P2>;
Selects test port 1 or 2 for non-S-parameter measurements. No query response.
UP
UP;
2-74
Alphabetical Command Reference
USEPASC
Increments the value displayed in the active entry area (emulates pressing the up-arrow key).No query response.
USEPASC
USEPASC; or USEPASC?;
Command Description Range Query Response
USEPASCPuts the analyzer in pass control mode.N/A
<0|1><
L
>
F
VELOFACT
VELOFACT<num>; or VELOFACT?;
Command Description RangeQuery Response
VELOFACTEnters the velocity factor of the
transmission medium.
0 to 10
<num><
L
>
F
WID
WIDT<ON|OFF>; or WIDT?;
WIDV<num>; or WIDV?;
Command Description Range Query Response
WIDTTurns the bandwidth search on and off. N/A
WIDVEnters the widths search parameter.
a. For log mag: ± 500 dB. For phase: ± 500 degrees. For Smith chart and Polar: ± 500 units.
For linear magnitude:
± 500 units. For SWR: ± 500 units.
amplitude range
a
<0|1><
<num><
L
>
F
L
>
F
WINDUSEM
WINDUSEM;
Uses trace memory as window.
WRSK
WRSK<num><$>;
Command Description Range Query Response
WRSKEnters new softkey labels into the indicated
softkey positions. Initial use of these
commands requires previous commands
MENUFORM; and MENUOFF;.
<num>: integers 1–8
<$>: 10 char. max.
N/A
2-75
Alphabetical Command Reference
8703A Commands Not Supported i n th e 8703B