Command Groups
number of wavef
orms or by time, or specify a violation threshold that must be
met before considering a test a failure, or specify an action (such as writing to a
file or sending an SRQ) that is to be performed upon a violation, a test failure,
or test completion. Use MASK:CUSTom andthenthe
:MASK:USER commands
to create user-defined custom masks.
A series of examples showing how to use mask commands for typical tasks
is included as an appendix. (See page E-1, Mask/Limit Command Sequence
Examples.)
Table 2-31
: Mask commands
Command
Descripti
on
APPLicat
ion:TYPe
When a mask/limit or power test application module is installed, one of the associated test
types is always selected by default. This command allows the test type to be changed
from the
default.
MASK:CO
Py:SOUrce
Specifie
s the standard m ask that is to be copied to a user created custom mask.
MASK:C
OPy:USER
Copies
the specified standard mask to a user created custom mask.
MASK:C
OUNt
Resets
to zero the number of hits and failures for all mask segments.
MASK:
COUNt:FAILURES?
Retur
ns the number of pass/fail mask tests that have failed
MASK
:COUNt:HITS?
This
query returns the sum of all hits in all mask segments.
MASK
:COUNt:SEG<x>:HITS?
This
query r eturns the number of hits for the specified mask segment.
MAS
K:COUNt:TESTS?
Ret
urns the number of pass/fail tests that have occurred
MAS
K:COUNt:VIOLATIONS?
Ret
urns the number of test violations that have occurred in the current pass/fail test.
MA
SK:COUNt:WAVEFORMS?
Re
turns the number of waveforms that have been acquired and processed during pass/fail
mask testing.
MASK:CUSTom Sets the user-defined custom mask to its initialized state, or copies the currently active
mask to the user-defined custom mask.
MASK:DISplay Controls whether a user-defined custom mask is displayed on the screen.
MASK:LOCk Locks the mask to the waveform so that any changes made to the horizontal and/or vertical
scale settings of the w aveform will redraw the mask segments in proportion.
MASK:MARgin:PERCent Sets or returns the tolerance for the m ask test. A positive value expands the mask and a
negative margin shrinks the mask by the specified percentage.
MASK:SOUrce Specifies the mask source waveform to be used during pass/fail mask testing
MASK:STANdard Replaces the existing mask, if any, with a specified standard mask.
MASK:STOPOnviolation Stops the waveform acquisitions upon the first occurrence of a waveform violation.
MASK:TEMPLate:CREATEmask Causes a template m ask to be created for limit testing, based on the s ettings of the
MASK:TEMPLate:SOUrce, MASK:TEMP Late:TOLera nce:HORizontal, and
MASK:TEMPLate:VERTical commands.
MASK:TEMPLate:SOUrce Specifies the source waveform to be used to create a mask template for limit testing.
MASK:TEMPLate:TOLerance:
HORizontal
Specifies the +/- horizontal limit (tolerance) for a m ask template to be used for limit testing.
MASK:TEMPLate:TOLerance:
VERTical
Specifies the +/- vertical limit (tolerance) for a mask template to be used for lim it testing.
2-32 MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual