Agilent Technologies 8719ES, Programmer'S Manual

Page: 494 / 541

Chapter 7 7-131
Programming Examples
Limit Line and Data Point Special Functions
Constants Used Throughout This Document
NOTE
The logic values attached to pass and fail indicators were chosen to be
consistent with the current logic used in the standard
OUTPLIML
and
OUTPLIMF
commands.
Table 7-14 is an interpretation of the Pass/Fail/No_Limit status constants. These constants
are used to identify the Pass/Fail/No_Limit state on the data strings if status is returned.
Table 7-15 is an interpretation of the min/max test constants. If the selected segment has
no associated limit, the NO_DATA string is generated, which reports a stimulus value of 0
and a data value of
−
1000.
Output Limit Test Pass/Fail Status Per Limit Segment
Two commands allow you to query the pass/fail test status on a limit segment basis.
•
SELSEG<num>
will select the segment.
•
OUTPSEGF
will return the status of the limit test for that segment: 1 (PASS), 0 (FAIL) or
−
1 (NO_LIMIT) if no limit exists for the selected segment number. Due to the
non-sequential numbering of actual limit line segments on the screen, some segment
numbers will have no associated limits and will thus return
−
1 (NO_LIMIT).
Under the following conditions,
OUTPSEGF
will issue the following errors:
❏
If the limit testing is off: “30: Requested Data Not Currently Available.” To clear the
error message, turn the limit test on.
❏
If the limit table is empty: “204: Limit Table Empty” (this is a new message). To clear
the error message, enter a limit table.
In both cases, the error is issued and the command responds with
−
1 (NO_LIMIT).
The argument for
SELSEG<num>
is limited by the maximum number of segments allowed in
the limit table, which is currently 18. The minimum value for the argument is 1. If the
user inputs a number that is outside this range, the active entry limits are invoked,
causing the analyzer to return the status for limit 18.
Table 7-14 Pass/Fail/No_Limit Status Constants
Status Definition Status Indicator
PASS 1
FAIL 0
NO_LIMIT
−
1
Table 7-15 Min/Max Test Constants
String Stimulus Value Data Value
NO_DATA 0
−
1000