Syntax Reference - Keysight · confirm all nodes (AUTOLEARN), C-98 confirm crc for node...

© Agilent Technologies 20012003 Syntax Reference i06/2003

Symbols Numerics A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Syntax Reference Syntax Reference Syntax Reference Syntax Reference

Symbols%, Non-alpha-3& (BT-BASIC), Non-alpha-5(ANALOG), D-27* (BT-BASIC), Non-alpha-6+ (BT-BASIC), Non-alpha-7- (BT-BASIC), Non-alpha-8< (BT-BASIC), Non-alpha-11 (BT-BASIC), Non-alpha-23>= (BT BASIC), Non-alpha-25[ ] (BT-BASIC), Non-alpha-27^ (BT-BASIC), Non-alpha-30⁄ (BT-BASIC), Non-alpha-10

Aabort (BT-BASIC), A-1

abs (BT-BASIC), A-3access ports (CONFIGURATION), A-4acknowledge all failures (BT-BASIC), A-7acknowledge digital failures (BT-BASIC), A-8acs (BT-BASIC), A-9add crc to node (AUTOLEARN), A-10add driver on (DEBUG), A-12add receiver on (DEBUG), A-14, A-16add sync at (DEBUG), A-18add vector at (DEBUG, A-20address (VCL), A-16analog (edit), A-22and (BT-BASIC), A-24andtree (VCL), A-26append (BT-BASIC), A-28arm (ANALOG), A-31asn (BT-BASIC), A-33assign to (BT-BASIC), A-35assign to (VCL), A-41at event set to (VCL), A-49at event wait for (VCL), A-52atn (bt-basic), A-55

© Agilent Technologies 20012003 Syntax Reference ii


autoadjust (BT-BASIC), A-56autofile (BT-BASIC), A-58autolearn (BT-BASIC), A-60autolearn end (BT-BASIC), A-62auxconnect (BT-BASIC), A-64auxdisconnect (BT-BASIC), A-66auxiliary (ANALOG), A-68

Bbackdrive current (SAFEGUARD), B-1bank/end bank (CONFIGURATION), B-3basic (edit), B-5beep (BT-BASIC), B-7bidirectional (ITL), B-8bidirectional (VCL), B-10, B-12binand (BT-BASIC), B-14bincmp (BT-BASIC), B-16bineor (BT-BASIC), B-18binior (BT-BASIC), B-20bit (BT-BASIC), B-22bni (BT-BASIC), B-24board consultant (BT-BASIC), B-26board graphics (BT-BASIC), B-27board graphics display board (BT-BASIC), B-29board graphics display panel (BT-BASIC), B-31board graphics end (BT-BASIC), B-32

board graphics highlight board (BT-BASIC), B-33board graphics highlight clear (BT-BASIC), B-35board graphics highlight device (BT-BASIC), B-37board graphics highlight nodes (BT-BASIC), B-40board handler (CONFIGURATION), B-42board number is (BT-BASIC), B-44board object is (TEXT), B-46board placement (BT-BASIC), B-48board placement on (BT-BASIC), B-53board version is (BT-BASIC), B-64boardfailed (BT-BASIC), B-58boards (CONFIGURATION), B-60boards wired in parallel (CONFIGURATION), B-62bond wire (SAFEGUARD), B-70Break key (misc), B-72bsdl (BT-BASIC), B-73btgetenv$ (BT-BASIC), B-66bti (BT-BASIC), B-76buffer$ (BT-BASIC), B-79buffered reporting on/off (BT-BASIC), B-81buswire (ITL), B-83bvi$ (BT-BASIC), B-68

Ccall (BT-BASIC), C-1call (VCL), C-5

© Agilent Technologies 20012003 Syntax Reference iii


capacitor (ANALOG), C-7capture (VCL), C-11capturepack (VCL), C-13cards (CONFIGURATION), C-16cat (BT-BASIC), C-25cd (BT-BASIC), C-28chain (ITL), C-31change (edit), C-34changem (edit), C-36changen (edit), C-38check board (BT-BASIC), C-40check boardxy (BT-BASIC), C-44check wait at event (VCL), C-50checkerboard (ITL), C-48chr$ (BT-BASIC), C-52clear (BT-BASIC), C-54clear connect keep (ANALOG), C-65clear connect-powered (ANALOG), C-56clear connect-unpowered (ANALOG), C-62clear failures (BT-BASIC), C-70clear nrun (BT-BASIC), C-72combinatorial (VCL), C-74command/edit (SOFTKEY), C-76Common Delimiter, Non-alpha-3compile (BT-BASIC), C-77compress (VCL), C-84condition with (VCL), C-87

conditioned device (VCL), C-92configuration (edit), C-94confirm (misc), C-96confirm all nodes (AUTOLEARN), C-98confirm crc for node (AUTOLEARN), C-100confirm diagnosis (BT-BASIC), C-102confirm node (AUTOLEARN), C-103confirm vectors (AUTOLEARN), C-105connect (CONFIGURATION), C-116connect (ITL), C-118connect -powered (ANALOG), C-107connect -unpowered (ANALOG), C-113connect keep (ANALOG), C-120cont (BT-BASIC), C-125continue analog (VCL), C-128continue digital (ANALOG), C-130control (BT-BASIC), C-132controllerloop (VCL), C-135copy over and copy to (BT-BASIC), C-138copy to (BT-BASIC), C-143cos (BT-BASIC), C-144count (VCL), C-145cps/dps (BT-BASIC), C-152create ascii (BT-BASIC), C-154create dir (BT-BASIC), C-156crt$ (BT-BASIC), C-158custom (ITL), C-159

© Agilent Technologies 20012003 Syntax Reference iv


Ddata (VCL), D-5data/end data (ANALOG), D-1data/end data (VCL), D-3datetime$ (BT-BASIC), D-7dbconnect (DEBUG), D-9debug (BT-BASIC), D-13debug (ITL), D-17debug board (BT-BASIC), D-19debug end (DEBUG), D-20debug port (CONFIGURATION), D-21debug status (DEBUG), D-23def (BT-BASIC), D-24default device, D-27

(VCL), D-29delay for cooling (VCL), D-31delete (edit), D-33delete vector at (DEBUG), D-35detector (ANALOG), D-37devices (ITL), D-44diagnose faults (DEBUG), D-46digital (edit), D-48dim (ANALOG), D-50dim (BT-BASIC), D-52diode (ANALOG), D-56disable (ITL), D-59

disable with (VCL), D-63disabled device (VCL), D-68disables (ITL), D-61discharge (ANALOG), D-70disconnect -powered (ANALOG), D-73disconnect -unpowered (ANALOG), D-78display adjustments (DEBUG), D-82display clear (DEBUG), D-83display crc for node (AUTOLEARN), D-85display device (DEBUG), D-87display device-polarity (DEBUG), D-91display device-testjet (DEBUG), D-93display dump (DEBUG), D-95display failure (DEBUG), D-97display format (DEBUG), D-99display graphics (DEBUG), D-102display groups (DEBUG), D-104display hex (DEBUG), D-107display histogram (DEBUG), D-109display measurement (DEBUG), D-111display moa (DEBUG), D-113display next (DEBUG), D-115display nodes (DEBUG), D-117display pins (DEBUG), D-120display previous (DEBUG), D-123display probe (DEBUG), D-125display refresh (DEBUG), D-127

© Agilent Technologies 20012003 Syntax Reference v


display renumber (DEBUG), D-129display scale (DEBUG), D-130display start at (DEBUG), D-132display states (DEBUG), D-134display subvector (DEBUG), D-136display swap (DEBUG), D-138display update (DEBUG), D-140display user vectors (DEBUG), D-142display vector (DEBUG), D-144div (BT-BASIC), D-146downcounter (VCL), D-148dps (BT-BASIC), D-150drive (VCL), D-152drive formatted (VCL), D-156drive vector at event (VCL), D-158dround (BT-BASIC), D-160duplicate (edit), D-162dut clock period (DEBUG), D-164dut clock period (VCL), D-165dutfailed (BT-BASIC), D-167dynamic (VCL), D-169

Eedit, E-1else (BT-BASIC), E-3enable, E-4

enable loop counter (VCL), E-11enable statements, E-4end, E-13, E-36, E-51end bank, E-14end capture, E-17end chain, E-15end compress, E-19end controllerloop, E-21end data, E-23, E-24end devices, E-25end disables (ITL), E-26end frame, E-28end homingloop, E-30end if, E-31end include, E-32end loop, E-33end module, E-34end nodes, E-35end on failure, E-38end parameters, E-40end pcf (VCL) (ITL), E-41end repeat (VCL) (ITL), E-43end segment, E-44end sub, E-46end subtest, E-47end subvector, E-48end test, E-50

© Agilent Technologies 20012003 Syntax Reference vi


end timing set, E-53end unit (VCL) (ITL), E-55end vector, E-56enter, E-57enter using, E-61eod, E-66errl, E-68errm$, E-69errmlong$, E-71errn, E-73events every, E-74events every internal, E-77execute, E-79, E-83, E-84execute to end, E-92execute to fail, E-93execute to vector, E-94exit, E-96exit if, E-97exit if pass, E-98exit test, E-99exor, E-101exp, E-103expand homingloop at, E-104external test, E-106extract version, E-108exttest$, E-110

Ffabon (BT-BASIC), F-3fail device (BT-BASIC), F-1failure (SHORTS), F-5family (VCL), F-7faoff (BT-BASIC), F-11faon/faoff (BT-BASIC), F-12fault dictionary is (TEXT), F-15fault object is (TEXT), F-17fboff (BT-BASIC), F-18fbon/fboff (BT-BASIC), F-19fcdon (BT-BASIC), F-22fcoff (BT-BASIC), F-24fcon/fcoff (BT-BASIC), F-25fdoff (BT-BASIC), F-30fdon/fdoff (BT-BASIC), F-28fetch (edit), F-31fetch (VCL), F-37file (VCL), F-33, F-40find (edit), F-45find library (BT-BASIC), F-47find pins (BT-BASIC), F-51find testjet probes (BT-BASIC), F-53findm (edit), F-55findn (edit), F-57first pass yield (BT-BASIC), F-35

© Agilent Technologies 20012003 Syntax Reference vii


fixed (ITL), F-61fixed (VCL), F-59fixture consultant (BT-BASIC), F-63fixture lock (BT-BASIC), F-64fixture tooling (BT-BASIC), F-65fixture unlock (BT-BASIC), F-69flash assignments/end flash assignments (VCL), F-70flash isp (VCL), F-72fn (BT-BASIC), F-73fnend (BT-BASIC), F-78for-to-step/next (BT-BASIC), F-79format (VCL), F-83frame/end frame (VCL), F-86functional (VCL), F-90fuse (ANALOG), F-92

Ggenerate backpatch (DEBUG), G-1generate debug (VCL), G-3generate debug macros (BT BASIC), G-5generate map (VCL), G-6, G-11generate nested repeat warning (VCL), G-13generate static test (VCL), G-15generate testjet (BT-BASIC), G-17get (BT-BASIC), G-19global (ANALOG), G-22

global (BT-BASIC), G-24goto (BT-BASIC), G-27gpconnect (ANALOG), G-30gpconnect (BT-BASIC), G-33gpdisconnect (ANALOG), G-36gpdisconnect (BT-BASIC), G-39grade tests (BT-BASIC), G-42graycounter (VCL), G-44ground bounce suppression (ITL), G-46

Hhalt (VCL), H-1hard drop limit is (TEXT), H-3heat source (SAFEGUARD), H-5homingloop (VCL), H-7homingloop hexadecimal (VCL), H-12hti (BT-BASIC), H-14

Iif then | else | end if (BT-BASIC), I-1ignore all failures (BT-BASIC), I-6ignore digital failures (BT-BASIC), I-8image (BT-BASIC), I-10in module (DIGITAL), I-52include (BT-BASIC), I-34

© Agilent Technologies 20012003 Syntax Reference viii


include (SAFEGUARD), I-36include (STATES), I-38include (VCL), I-40indictments, L-68inductor (ANALOG), I-42initialize to (VCL), I-46initiate (ANALOG), I-50input (BT-BASIC), I-55input using (BT-BASIC), I-60inputs (VCL), I-64inputs collapsed (VCL), I-68inputs formatted (VCL), I-70inputs formatted clock (VCL), I-72inputs scan (VCL), I-74inputs scan clock (VCL), I-76inputs scan mode (VCL), I-78inputs scan reset (VCL), I-80int (BT-BASIC), I-82interconnect (ITL), I-83ipg (BT-BASIC), I-85ipg from (BT-BASIC), I-90ipg on (BT-BASIC), I-94itb$ (BT-BASIC), I-99ith$ (BT-BASIC), I-101itl (BT-BASIC), I-103ito$ (BT-BASIC), I-105

Jjumper (ANALOG), J-1

Kkeep serial clocks (STL), K-4keyboard is (BT-BASIC), K-1

Llearn (BT-BASIC), L-1learn capacitance (BT-BASIC), L-3learn crc for node (AUTOLEARN), L-5learn test time (DEBUG), L-7learn vectors (AUTOLEARN), L-9learning (BT-BASIC), L-11, L-13len (BT-BASIC), L-15lgt (BT-BASIC), L-18line frequency (CONFIGURATION), L-19link (BT-BASIC), L-21list (edit), L-23list object (BT-BASIC), L-25list source (BT-BASIC), L-29listm (edit), L-30listn (edit), L-32lli$ (BT-BASIC), L-34

© Agilent Technologies 20012003 Syntax Reference ix


load (BT-BASIC), L-35load board (BT-BASIC), L-38local (BT-BASIC), L-39local lockout (BT-BASIC), L-41log function (BT-BASIC), L-43log statement (BT-BASIC), L-44log board (BT-BASIC), L-47log board end (BT-BASIC), L-50log board start (BT-BASIC), L-52log clear (BT-BASIC), L-54log clear for retest (BT-BASIC), L-57log devices (BT-BASIC), L-60log devices off (BT-BASIC), L-62log is (BT-BASIC), L-63log level is (BT-BASIC), L-66log out (BT-BASIC), L-70log using (BT-BASIC), L-73loop | exit if | end loop (BT-BASIC), L-76looptest, L-78lwc$ (BT-BASIC), L-80

Mmap file is (TEXT), M-1mark (SOFTKEY), M-3marker clear (DEBUG), M-4marker start (DEBUG), M-5

mask all nodes (AUTOLEARN), M-7mask from/to all nodes (AUTOLEARN), M-9mask from/to node (AUTOLEARN), M-11mask from/to vectors (AUTOLEARN), M-13mask node (AUTOLEARN), M-15mask vectors (AUTOLEARN), M-17mass storage is (BT-BASIC), M-19measure (ANALOG), M-20merge (BT-BASIC), M-24message (VCL), M-27meter (BT-BASIC), M-29minimum wait (BT-BASIC), M-33mod (BT-BASIC), M-35model (SAFEGUARD), M-37module pin assignment (BT-BASIC), M-41module/end module (CONFIGURATION), M-39move (edit), M-45msec (BT-BASIC), M-47msi (BT-BASIC), M-49msi$ (BT-BASIC), M-51

Nnandtree (VCL), N-1newlink scanworks_disconnect_(BT_BASIC), S-28newlink scanworks_reset_(BT_BASIC), S-29next (BT-BASIC), N-3

© Agilent Technologies 20012003 Syntax Reference x


next (VCL), N-4nfetr (ANALOG), N-6no (BT-BASIC), N-9node (STATES), N-11nodes (SHORTS), N-20nonanalog (ANALOG), N-22nondigital (VCL), N-24nortree (VCL), N-26not (BT-BASIC), N-28npn (ANALOG), N-30nrun (BT-BASIC), N-33num (BT-BASIC), N-35number (edit), N-37

Oobject checking (BT-BASIC), O-1off break (BT-BASIC), O-3off error (BT-BASIC), O-4off failure (ANALOG), O-6on (BT-BASIC), O-8on break (BT-BASIC), O-10on error (BT-BASIC), O-13on failure / end on failure (ANALOG), O-16on failure report (VCL), O-19operating temperature (SAFEGUARD), O-20operator (BT-BASIC), O-22

option bit (BT-BASIC), O-25or (BT-BASIC), O-27oti (BT-BASIC), O-29output (BT-BASIC), O-31output using (BT-BASIC), O-36outputs (ITL), O-40outputs (VCL), O-42outputs formatted (VCL), O-44outputs limited to (VCL), O-46outputs reference clock (VCL), O-48outputs scan (VCL), O-50overdrive power (SAFEGUARD), O-52override xt analog (CONFIGURATION), O-54

Ppack states (BT-BASIC), P-1package (SAFEGUARD), P-3panelfailed (BT-BASIC), P-5parameters (SAFEGUARD), P-7part (edit), P-9partforms (BT-BASIC), P-11pass device (BT-BASIC), P-14pause (ANALOG), P-16pause (BT-BASIC), P-17pause (VCL), P-19pb qstats (SOFTKEY), P-21

© Agilent Technologies 20012003 Syntax Reference xi


pcf (ITL), P-22pcf (VCL), P-24pcf order is (VCL), P-30pcf order is nodes (ITL), P-28, P-34performance port, P-34pfetr (ANALOG), P-35pi (BT-BASIC), P-38pins (BT-BASIC), P-39piped (VCL), P-41PLD ISP

print level, P-82pnp (ANALOG), P-43polarity print level is (BT-BASIC), P-46port (CONFIGURATION), P-48ports (CONFIGURATION), P-52pos (BT-BASIC), P-54possible drop limit is (TEXT), P-56potentiometer (ANALOG), P-58power (VCL), P-62power pins (ANALOG), P-64powered (BT-BASIC), P-66powered shorts (ITL), P-68ppoll (BT-BASIC), P-70prerun (BT-BASIC), P-73preset counter (VCL), P-75print (ANALOG), P-84print (BT-BASIC), P-86

print level, P-82print using (BT-BASIC), P-89printer is (BT-BASIC), P-92probe (BT-BASIC), P-96probe (CONFIGURATION), P-99probe report (BT-BASIC), P-101probe selection (BT-BASIC), P-103probe selection on (BT-BASIC), P-107processor (VCL), P-111program monitor (BT-BASIC), P-113pslimit (BT-BASIC), P-115pwd (BT-BASIC), P-117

Qqstats (BT-BASIC), Q-4question (BT-BASIC), Q-1Quick Report, Q-3quick report (BT-BASIC), Q-3

Rrandomize (BT-BASIC), R-1rcall (ANALOG) (BT-BASIC), R-2re-save (BT-BASIC), R-71re-store (BT-BASIC), R-79recall display from (DEBUG), R-5

© Agilent Technologies 20012003 Syntax Reference xii


recall minus (SOFTKEY), R-7recall node data for node from (AUTOLEARN), R-8recall plus (SOFTKEY), R-10receive (VCL), R-11receive delay (DEBUG), R-13receive formatted (VCL), R-17receive vector at event (VCL), R-20recycle to end (DEBUG), R-22recycle to fail (DEBUG), R-23recycle to vector (DEBUG), R-24relay controls vacuum (CONFIGURATION), R-26remote (BT-BASIC), R-28remove adjustments (DEBUG), R-30remove all crc from node (AUTOLEARN), R-31remove crc from node (AUTOLEARN), R-32remove sync (DEBUG), R-34rename (BT-BASIC), R-35repeat (ITL), R-37repeat (VCL), R-39report (ANALOG), R-41report (BT-BASIC), R-43report (SHORTS), R-46report analog (ANALOG), R-49report clear (BT-BASIC), R-53report fault syndrome (BT-BASIC), R-55report is (BT-BASIC), R-58report level is (BT-BASIC), R-62

report out (BT-BASIC), R-64report using (BT-BASIC), R-68resistor (ANALOG), R-75return (BT-BASIC), R-83revision$ (BT-BASIC), R-85rewind (VCL), R-86rexit (ANALOG) (BT-BASIC), R-88rinit (ANALOG) (BT-BASIC), R-90rli$ (BT-BASIC), R-95rnd (BT-BASIC), R-96rotate (BT-BASIC), R-98rps (BT-BASIC), R-100run (BT-BASIC), R-102

Ssafeguard (BT-BASIC), S-3safeguard (edit), S-1save (BT-BASIC), S-5save display (DEBUG), S-9save failures (BT-BASIC), S-11save node data for node (AUTOLEARN), S-13scan bus interconnect (VCL), S-15scan connect (VCL), S-17scan disable (VCL), S-19scan interconnect (VCL), S-21scan powered shorts (VCL), S-23

© Agilent Technologies 20012003 Syntax Reference xiii


scanworks connect (BT_BASIC), S-25scanworks debug (BT-BASIC), S-26scanworks disconnect (BT_BASIC), S-28scanworks reset (BT_BASIC), S-29scratch (edit), S-31scratch board (BT-BASIC), S-32segment (VCL), S-34segment hexadecimal (VCL), S-38select boards on panel (BT-BASIC), S-40select edge (DEBUG), S-44send (BT-BASIC), S-46sequential (VCL), S-48serial (edit), S-50set driver offset (DEBUG), S-52set driver offset (VCL), S-55set driver state on (DEBUG), S-58set load (DEBUG), S-60set load (VCL) (ITL), S-63set probe (DEBUG), S-66set receiver offset (DEBUG), S-68set receiver offset (VCL), S-71set receiver state on (DEBUG), S-74set ref (DEBUG), S-76set ref (VCL) (ITL), S-80set slew rate (DEBUG), S-84set slew rate (VCL) (ITL), S-87set terminators (DEBUG), S-91

set terminators (VCL) (ITL), S-94set to (VCL), S-97set vector timing on (DEBUG), S-103set wait line offset (VCL), S-105settling delay (SHORTS), S-107setup test editor (BT-BASIC), S-109sgn (BT-BASIC), S-110shift (BT-BASIC), S-111short (SHORTS), S-113shorts (BT-BASIC), S-115silicon nail, S-117silicon node (ITL, S-119sin (BT-BASIC), S-121softkey (BT-BASIC), S-122softkey clear (BT-BASIC), S-125softkeys (BT-BASIC), S-127softkeys clear (BT-BASIC), S-129softkeys off (BT-BASIC), S-131softkeys on & off (BT-BASIC), S-132softkeys over (BT-BASIC), S-134softkeys to & over (BT-BASIC), S-135source (ANALOG), S-137spoll (BT-BASIC), S-142sps (BT-BASIC), S-144sqr (BT-BASIC), S-148srq (BT-BASIC), S-149start vector numbering at (TEXT), S-151

© Agilent Technologies 20012003 Syntax Reference xiv


states (edit), S-153status (BT-BASIC), S-154step (BT-BASIC), S-159stop (BT-BASIC), S-160store (BT-BASIC), S-162store line (SOFTKEY), S-166sub (BT-BASIC), S-167sub (VCL), S-170subend (BT-BASIC), S-172subend (VCL), S-174subexit (BT-BASIC), S-175subtest/end subtest (ANALOG), S-176subvector (VCL), S-178supplies (CONFIGURATION), S-180switch (ANALOG), S-183sync (VCL), S-188Syntax Alpha List, Syntax - -i

Ttab (BT-BASIC), T-1tan (BT-BASIC), T-3target (CONFIGURATION), T-4tck (ITL), T-8tdi (ITL), T-10tdo (ITL), T-12test (ANALOG), T-14

test (BT-BASIC), T-16test (ITL), T-20test analog (ANALOG), T-22test consult (SOFTKEY), T-24test consultant (BT-BASIC), T-25test cont (BT-BASIC), T-26test digital (VCL), T-28test inputs only (ITL), T-32test isolated analog (ANALOG), T-30test monitor (BT-BASIC), T-34test node (TESTJET), T-36test on boards (BT-BASIC), T-38test pins (TESTJET), T-40test powered (ANALOG), T-42test scanworks (BT-BASIC), T-44test shorts (BT-BASIC), T-46test time (VCL), T-47Test Until Pass, L-78testhead cleanup (BT-BASIC), T-49testhead configuration (BT-BASIC), T-51testhead is (BT-BASIC), T-52testhead name (CONFIGURATION), T-54testhead power (BT-BASIC), T-56testhead status (BT-BASIC), T-57testjet print level is (BT-BASIC), T-59testorder (BT-BASIC), T-61testplan generation (BT-BASIC), T-63

© Agilent Technologies 20012003 Syntax Reference xv


text (edit), T-67th$ (BT-BASIC), T-69then (BT-BASIC), T-70thermal resistance (SAFEGUARD), T-71threshold (SHORTS), T-73throughput report, Q-3tied (VCL), T-75time$ (BT-BASIC), T-77timeout (BT-BASIC), T-78timing set (VCL), T-80tms (ITL), T-83to (BT-BASIC), T-85tolerance margin (BT-BASIC), T-86topology device count (BT-BASIC), T-89topology device data$ (BT-BASIC), T-91topology device pin count (BT-BASIC), T-94topology device pin data$ (BT-BASIC), T-95topology get device pins (BT-BASIC), T-97topology get devices (BT-BASIC), T-99topology get internal devices (BT-BASIC), T-101topology get node connections (BT-BASIC), T-103topology get nodes (BT-BASIC), T-105topology get parent devices (BT-BASIC), T-107topology internal device count (BT-BASIC), T-109topology node connection count (BT-BASIC), T-110topology node count (BT-BASIC), T-112topology node data$ (BT-BASIC), T-113

topology parent device count (BT-BASIC), T-115translate board (BT-BASIC), T-116translate faults (BT-BASIC), T-119trigger (ANALOG), T-121trigger (BT-BASIC), T-125trim$ (BT-BASIC), T-127triml$ (BT-BASIC), T-129trimr$ (BT-BASIC), T-130trst (ITL), T-131Turning off

Data Removal, G-10

Uunit (ITL), U-1unit (VCL), U-3unit disable method (VCL), U-6unit disable test (VCL), U-8unlink (BT-BASIC), U-10unpowered (BT-BASIC), U-12upc$ (BT-BASIC), U-14upcounter (VCL), U-15use cards on (VCL), U-17use parameters (SAFEGUARD), U-19use pcf order (VCL), U-21use timing set (VCL), U-24

© Agilent Technologies 20012003 Syntax Reference xvi


Vvacuum well (BT-BASIC), V-1val (BT-BASIC), V-4val$ (BT-BASIC), V-6values (ANALOG), V-8values (VCL), V-10variable to groups (VCL), V-13vector (VCL), V-15vector cycle (DEBUG), V-17vector cycle (VCL) (ITL), V-19verify (BT-BASIC), V-21verify device coverage (BT-BASIC), V-27verify faults (DEBUG), V-29verify TestJet (BT-BASIC), V-24vista (BT-BASIC), V-33

Wwait (ANALOG), W-1wait (BT-BASIC), W-2wait (VCL), W-4wait for start (BT-BASIC), W-6wait for trigger (ANALOG), W-8wait line (VCL), W-10wait terminated when (VCL), W-12warning (VCL) (ITL), W-14

wirelist (edit), W-16

Yyes (BT-BASIC), Y-1

Zzener (ANALOG), Z-1

© Agilent Technologies 20022003 Syntax Reference Non-Alpha-1

�

! (BT-BASIC) Title: COMMENTSThe exclamation point (!) is used to start a comment. A comment is text in the program, and is used to annotate the program. Comments do not affect program operation but they do appear in the program listing.

If a comment is used, it must be the last item on the line. A comment must be all on one line and can be no longer than one line (2048 characters).

Syntax

!

Parameters

Zero or more printable characters.

Non-AlphaNon-AlphaNon-AlphaNon-Alpha


Chapter : Non-Alpha �

Example

! this program tests PC Board 63455-02906H! prompt operator to prepare fixtureinput "Please mount Fixture 3455-40A and then press YES", Aprint C$ & " and " & D$ ! prints cats and dogs

General Information

When an existing program is loaded into the workspace and syntax checked, if there are any errors, the line on which the error occurred will be converted to a comment. These comments can be easily identified because they will have two exclamation marks (!!) instead of just one.



% (BT-BASIC) Title: Common DelimiterAgilent 3070 software has used the colon (:) and the percent symbol (%) as the delimiter character for panelized boards and parent/child device notation in the part description library on UNIX and MS Windows systems respectively.

Beginning with Agilent 3070 05.20p software release, Interoperability between UNIX and MS Windows unifies these delimiter characters to a common delimiter - the percent symbol (%).



Syntax

%

Examples of Common Delimiter Use

Example 0-1 Panelized Board Notation Example

analog/2%r55

Example 0-2 Parent/Child Device Part Description Example

rpack2%r3

General Information

To ensure backward compatibility, a board dependent flag will be set. For older versions of board files on UNIX, the colon will remain the panelized board character. However, this kind of board cannot be interoperable between UNIX and MS Windows without conversion.



& (BT-BASIC) Title: CONCATENATION OF STRINGSThe string operator (&) appends the second string to the first string (i.e., it concatenates them). The string operator has a priority of 6.

Syntax

&

Parameters

The strings to be concatenated.

Example

A$ = "ABC" & "XYZ" \ print A$! prints ABCXYZA$ = A$ & "qrs" \ print A$ ! prints ABCXYZqrsD$ = "dogs" \ C$ = "cats"print C$ & " and " & D$ ! prints cats and dogs

General Information

(none)



* (BT-BASIC) Title: MULTIPLICATION This arithmetic operator multiplies the expression on the left by the expression on the right. The priority is 6.

Syntax

*

Parameters

The quantities to be multiplied.

Example

print 12*4.5 ! prints 54print (2+8)*(-6) ! prints -60print 3+6*4 ! prints 27 ( * has higher priority than + )A = 25 \ print 3*A;A ! prints 75 25

General Information

(none)



+ (BT-BASIC) Title: ADDITION This arithmetic operator, Plus, adds two numeric expressions together. The priority is 5.

Syntax

+

Parameters

The quantities to be added.

Example

print 34; +34 ! prints 34 34print 10+13.62 ! prints 23.62print 8+(-5) ! prints 3print 2+8*5 ! prints 42 ( + has lower priority than * )print (2+8)*5 ! prints 50A = 21 \ print A+3;A ! prints 24 21

General Information

(none)



- (BT-BASIC) Title: SUBTRACTION This arithmetic operator, Minus, has two functions: unary minus and binary minus. The priority of both is 5.

Unary minus is a minus sign which can precede a quantity to negate that quantity.

Binary minus subtracts the numeric expression on the right from the numeric expression on the left.

Syntax

(for unary minus)

(for binary minus) -

Parameters

The quantities to be operated on.



Example

print -45 ! unary minus: prints -45Q=-6 \ print -Q ! prints 6print 13.62-10 ! binary minus: prints 3.62print 8*(-5) ! prints-40print 30-2*5 ! prints 20 ( - has lower priority than * )print (30-2)*5 ! prints 140A = 21 \ print A-3;-A ! prints 18 -21

General Information

(none)



/ (BT-BASIC) Title: DIVISIONThis arithmetic operator divides the expression on its left by the expression on its right. The priority is 6.

Syntax

numeric expression> /

Parameters


Example

print 12/4 ! prints 3print (2+8)*(-6)/5 ! prints -12print 4+6/3 ! prints 6 ( / has higher priority than + )A = 21 \ print A/3;A ! prints 7 21

General Information

(none)



< (BT-BASIC) Title: LESS THANThe less than operator compares two expressions to determine if the first is less than the second. If the relationship is true (the first is less) a value of 1 is returned; if the relationship is false (the first expression is not less) a value of zero is returned. Relational operators have a priority of 4.

Syntax

< can be numeric or string

Parameters

The quantities to be compared. Expression types cannot be mixed in the same statement; both expressions must be numeric, or both must be strings.

Numeric expressions are compared by value; strings are compared, character by character, according to the ASCII numerical equivalent of each character.



Example

A=6.25 \ B= (-32) \ C= 6.25 ! assigns values to variablesprint B < A ! prints 1print C < A ! prints 0if A



Example

A=6.25 \ B= (-32) \ C= 6.25 ! assigns values to variablesprint B



(BT-BASIC) Title: INEQUALITYThe inequality operator compares two expressions and returns a value of 1 if the relationship is true (they are not equal), or a value of zero if the relationship is false (they are equal). Relational operators have a priority of 4.

Syntax

can be numeric or string

Parameters

The quantities to be compared. Expression types cannot be mixed in the same statement; both expressions must be numeric, or both must be string.




Example

A=6.25 \ B= (-32) \ C= 6.25 ! assigns values to variablesprint A B ! prints 1print C A ! prints 0if AC then print "Not" ! "if" statement checks for inequality;print "the same" ! condition is not met, so skips to

! next line and prints "the same"Q$ = "dog"print "cat" Q$ ! prints 1

General Information

(none)



= assignment (ANALOG)

Title: ASSIGNMENTAssignment (=) assigns values to variables: numeric values to numeric variables, and strings to string variables.

See the syntax description of the = - assignment (BT-BASIC) statement.

Syntax

= =

Parameters

Id of the numeric (string) variable to which a value (string) is to be assigned. Simple variables and array

elements can be identified. An array must be dimensioned by a dim (BT-BASIC) statement and passed to the analog test.

The format to reference a complete array [(*)] cannot be used in an assignment.

The value to be assigned to the numeric variable.

The string of characters to be assigned to the string variable. This string can be different in length from the current length of the variable to which it is to be assigned; but it cannot be longer than that variable's dimensioned length.



Example

A = 1A$ = "abc"A = B*(C+2)

General Information

(none)



= assignment (BT-BASIC)

Title: ASSIGNMENT Assignment (=) assigns values to variables: numeric values to numeric variables, and strings to string variables.

The equals sign is also used as the equality operator; see = equality.

Syntax

= =

Parameters

Id of the numeric (string) variable to which a value (string) is to be assigned. Simple variables, array elements and substrings can be

identified. An array must be dimensioned by a dim statement before any of its elements can be referenced.

The format to reference a complete array [(*)] cannot be used in an assignment.

The value to be assigned to the numeric variable.

The string of characters to be assigned to the string variable. This string can be different in length from the current length of the variable to which it is to be assigned; but it cannot be longer than that variable's dimensioned length.



Example

A=100 ! assigns value of 100 to variable "A"Omega = 2*pi*F ! assigns value of the expression to "Omega"Math_score(12)=Test_scores(5,12)! both arrays must have been dimensionedA=100 \ B=A \ C=A ! multiple assignmentsA=B=C=100 ! assigns result of a logical evaluation to A:

! A is set to 1 if B and C both equal 100;! A is reset to 0 if they do not.

Alpha$="ABC------XYZ" ! assigns string to a string variableQ$="Average time of testing."T$ = Q$[9;4] ! assigns a substring to a string variableprint T$ ! prints timeTim$="The time is"Time = len(Tim$)+2 ! numeric assignmentprint Time ! prints13dim Shorts$[10]Shorts$ = "Test for shorts"! error, string too long

General Information

Note that the use of the equals sign (=) in the assignment is not the same as its use as a relational operator. For example, A=B means that variable A is given (assigned) the same value as B; but if A=B then means that As current value is to be compared to Bs current value to determine if they are equal [see = equality].



= equality (BT-BASIC)

Title: EQUALITYThe equality operator compares two expressions and returns a value of 1 if the relationship is true (they are equal), or a value of zero if the relationship is false (they are not equal). Relational operators have a priority of 4.

The equals sign is also used for assignment (see = assignment).

Syntax

= can be numeric or string

Parameters

The quantities to be compared. Expression types cannot be mixed in the same statement; both expressions must be numeric, or both must be string.




Example

A=6.25 \ B= (-32) \ C= 6.25 ! assigns values to variablesprint A = B ! prints 0print C = A ! prints 1if A=B then print "same" ! "if" statement checks for equality;print "different" ! condition is not met, so skips to

! next line and prints "different"Q$ = "dog" ! assigns string to variable Q$print Q$ = "dog" ! prints 1print "cat" = Q$ ! prints 0

General Information

(none)



> (BT-BASIC) Title: GREATER THANThe greater than operator compares two expressions to determine if the first is greater than the second. If the relationship is true (the first is greater) a value of 1 is returned; if the relationship is false (the first expression is not greater) a value of zero is returned. Relational operators have a priority of 4.

Syntax

> can be numeric or string

Parameters





Example

A=6.25 \ B= (-32) \ C= 6.25! assigns values to variablesprint B > A ! prints 0print C > B ! prints 1if C>A then print "larger" ! "if" statement checks relationship;print "same" ! condition is not met, so skips to

! next line and printssameQ$ = "dog"print "cat" > Q$ ! prints 0N$ = "7401" \ P$ = "74001"print N$ > P$ ! prints 1 (remember, this is a string evaluation)

General Information

(none)



>= (BT-BASIC) Title: GREATER THAN OR EQUAL TOThe greater than or equal to operator compares two expressions to determine if the first is greater than, or equal to, the second. If the relationship is true (the first is greater than, or equal to, the second), a value of 1 is returned; if the relationship is false (the first expression is less), a value of zero is returned. Relational operators have a priority of 4.

Syntax

>= can be numeric or string

Parameters





Example

A=6.25 \ B= (-32) \ C= 6.25! assigns values to variablesprint B >= A ! prints 0print C >= A ! prints 1if B>=C then print "not less"! "if" statement checks relationship;print "less" ! condition is not met, so skips to

! next line and printslessQ$ = "dog" \ D$ = "dog"print "cat" >= Q$ ! prints 0print D$ >= Q$ ! prints 1N$ = "7401" \ P$ = "74001"print N$ >= P$ ! prints 1 (remember, this is a string evaluation)

General Information

(none)



[ ] (BT-BASIC) Title: SUBSTRING OPERATORThe substring operator ([]) defines a substring in a string expression. The operator has a priority of 7.

Syntax

[][;]

& are

Parameters

The parent string of which the substring is a part.

For output: can be any type of string (a constant, a variable, or an expression).

For input: must be a string variable or an element from a string array.

Integer specifies the position in the parent string of the first character of the substring. Characters are numbered in ascending order from the left, beginning with 1. can be any character in the parent string; if the parent is a variable whose dimensioned length is greater than its current length, then can range from 1 to the current length plus 1.

Integer specifies the length of (i.e., the number of characters in) the substring. The maximum length depends on the length of the parent string and the value of .



If length is omitted, it defaults to the length of the parent string minus the number of characters which precede the character in the parent. The substring must lie within the parent string; an error occurs if a substring which would extend beyond the parent string is specified. The length of the parent string is defined as:

For output: The length of the parent string is the number of characters contained in that string; however, for a variable the length is the dimensioned length.

For input: Since input can be made only to variables, the length of the parent string is the dimensioned length of that variable. When a string of characters is input to a substring, characters in the parent variable are changed. The current length of the parent variable may also be changed (refer to General Information, below).



Example

print "Average time of testing"[9;4]! printstimeprint "Average time of testing"[9]! printstime of testingB$ = "Test" | C$ = "Records"print (B$ & " " & C$)[4;3] ! prints t Rprint B$ & " " & C$[4;3] ! prints Test ord

! note - "[ ]" has higher priority than "&"Q$="Average time of testing."print Q$[9;4] ! prints timeQ$[9] = "test time" ! input to a substringprint Q$ ! prints Average test timeA$ = Scores$(3,8,5)[7;6] ! specifies a substring from an array element

General Information

Input to a substring can change the length of the parent variable in various ways, depending on the length of the input string and the way it is specified. Refer to BT- BASIC, Chapter 1 to the section titled Substring Input for details and for more examples.



^ (BT-BASIC) Title: EXPONENTIATION The exponentiation operator raises the quantity on its left to the power of the quantity on its right. The priority is 7.

Syntax

^

Parameters




Example

print 5^2 ! prints 25print 3*6^2 ! prints 108 ( ^ has higher priority than * )print (3*6)^2 ! prints 324print -5^4 ! prints -625print 4^(-2) ! prints .0625print 9^(1/2) ! prints 3A = 10 \ print A^2;A ! prints 100 10

General Information

(none)

© Agilent Technologies 2001, 2003 Syntax Reference A-106/2003

�

abort (BT-BASIC) Title: ABORT (CLEAR) GPIB INTERFACEThe abort function resets the GPIB interface to its initialized state. The function activates the IFC line on the bus for 100 microseconds. This also has the effect of aborting any current bus activity.

Syntax

abort can be a or an @

is a is a

Parameters

The address of the bus. The function pulls IFC (0), clears ATN (1) and sets REN (0).

AAAA

© Agilent Technologies 2001, 2003 Syntax Reference A-2

Chapter : A �

Examples

Shortcut Method:abort "/dev/hpib1" !Activates IFC on the GPIB interface addressedassign @LINE to "/dev/hpib1"abort @LINE

Absolute Path Method:Bus$ = btgetenv$("AGILENT3070_ROOT")abort Bus$&"/dev/hpib1" ! Activates IFC on the GPIB interface addressedassign @LINE to Bus$&"/dev/hpib1"abort @LINE

General Information

NOTE: These examples assume the dev file hpib1 contains the SICL interface name hpib7.


Chapter : A �

abs (BT-BASIC) Title: ABSOLUTE VALUEThe abs function returns the absolute value of the function's argument.

Syntax

abs()

Parameters

The argument of the function.

Examples

print abs(-8.65) ! prints8.65print abs(8.65) ! prints8.65E=5 \ I=-0.006 \ Power=E*abs(I)print Power; "watts" ! prints.03 watts

General Information

(none)


Chapter : A �

access ports (CONFIGURATION)

Title: ENUMERATE ACCESS PORTSAn access ports function declares the existence of ports on an AccessPlus Card that has one or more of its access ports connected to external instruments. This function is valid only in the standard configuration file or in board configuration files; it must not appear in the testhead configuration file.

Use one access ports function for each AccessPlus Card to which external instruments are connected. access ports statements must appear between the module and end module statements that delimit a module configuration block for whichever module contains the corresponding AccessPlus Card. Within a module configuration block, access ports statements always appear somewhere after the cards statements.

The access ports on AccessPlus Cards are allocated in ranges of 18, as follows:

� The first eight ports on a cardacc1 through acc8are high-frequency coaxial ports.

� The next four ports on a cardacc9 through acc12are general-purpose ports.

� The last six ports on a cardacc13 through acc18are general-purpose (GP) ports that are multiplexed 4:1 at the module interface pins.

If you use the access ports on more than one AccessPlus Card, you must declare more than one range of 18 ports. For example, you might allocate the ports on the first AccessPlus Card as acc1 through acc18, on the second card as acc19 through acc36, etc.


Chapter : A �

Syntax

access ports on card is to

is acc is an integer

Parameters

A range of 18 access port identifiers associated with a single AccessPlus Card.

The identifier of an access port. An consists of the characters acc followed by an integer that uniquely identifies an individual access port within a range of 18 ports.

The identifier of the module slot that contains the AccessPlus Card.


Chapter : A �

Examples

module 3cards 1 asrucards 2 to 5 hybridcards 6 controlcards 7, 9 to 10 hybridcards 11 accesssupplies 1 to 4ports ext1, ext2connect "Digital_Scope" signal to ext1connect "Digital_Scope" trigger to ext2access ports acc1 to acc18 on card 11connect "Digital_VM" access to acc1

end module

General Information

(none)


Chapter : A �

acknowledge all failures (BT-BASIC)

Title: RESUME FAILURE PROCESSINGThe acknowledge all failures function resumes failure processing of device test failures which was halted by the ignore all failures function.

See the syntax description of the ignore allfailures function.

Syntax

acknowledge all failures

Parameters

(none)

Examples

acknowledge all failures

General Information

(none)


Chapter : A �

acknowledge digital failures (BT-BASIC)

Title: SET DIGITAL ERROR FLAGThe acknowledge digital failures function sets a flag that causes the failures to be reported if a digital test failsfailure information is sent to the report is device, the dutfailed function is set, and the appropriate log records are generated.

The flag is turned off by the ignore digitalfailures function. If not specified, the flag defaults to on (acknowledge). When a failure does occur, the test halts, the drivers are set to the high-impedance state and control is returned to the testplan.

Syntax

acknowledge digital failures

Parameters

(none)

Example

acknowledge digital failures

General Information

(none)


Chapter : A �

acs (BT-BASIC) Title: ARCCOSINEThe acs function returns the arccosine of the function's argument. The result is the principal value of the angle, in radians.

Syntax

acs()

Parameters

The argument of the function: 1


Chapter : A �

add crc to node (AUTOLEARN)

NOTEAUTOLEARN is not supported in MS Windows systems.

Title: ADD A CRC TO A NODE IN THE STATES FILEThis function adds a CRC to the list of existing CRCs for a specified node in the states file. You can use it to add a CRC value found by confirming the node and noting that more than one CRC value is valid.

After adding the CRC to a node, the function indicates the number of CRCs currently stored for that node.

Syntax

add crc to node , and are

Parameters

The name of the node to which the CRC is added.

A 4-digit hexadecimal value representing the CRC for the specified node.


Chapter : A �

Examples

add crc to node "Add_3", "4AD7"

General Information

(none)


Chapter : A �

add driver on (DEBUG)

Title: ADD A DRIVERThe add driver on function adds a driver to the node or device pin specified. An error occurs if the driver/receiver channel connected to the node has no driver available, or if the node has no fixture wire connected. The actual state of the driver is set to Z, which means the driver is off. The actual state of the driver can be modified by using the digital debug

function set driver state on. Parameters for the added driver, such as timing offsets and reference levels, are derived from the debug object file. These parameters can be seen using the s parameter with the display function. To change any of these parameters use the appropriate debug statements.

Syntax

add driver on can be: node

device pin pin

is a is a can be:

Parameters

The node or device pin to which the driver should be added.


Chapter : A �

Examples

add driver on node "OSC_ENABLE"add driver on device "U25" pin "7"add driver on pin "12" ! Adds a driver to pin 12 of the device being debugged.

General Information

(none)


Chapter : A �

add receiver on (DEBUG)

Title: ADD A RECEIVERThe add receiver on function adds a receiver to the node or device pin specified. An error occurs if the driver/receiver channel connected to the node has no receiver available, or if the node has no fixture wire connected. The expected state of the receiver is set to X, which means the receiver is not expecting a 1 or a 0. The expected state of the receiver can be modified by using

the digital debug function set receiver state on. Parameters for the added receiver, such as timing offsets and reference levels, are derived from the debug object file. These parameters can be seen using the s parameter with the display function. To change any of these parameters use the appropriate debug statements.

Syntax

add receiver on can be: node

device pin pin

is a is a can be:

Parameters

The node or device pin to which the receiver should be added.


Chapter : A �

Examples

add receiver on node "DATA_1"add receiver on device "U25" pin "7"add receiver on pin "12"! Adds a receiver to pin 12 of the device being debugged.

General Information

(none)


Chapter : A �

address (VCL) Title: ASSIGN ADDRESS BUS ID TO DYNAMIC VECTORSThe address function assigns the bus id to a group of dynamic vectors representing the address bus. This is used for Flash ISP programming.

Syntax

address to groups address to groups [step ]address to groups [step automatic]

Parameters

The name of the address bus id. The address bus to which data from the file image will be assigned.

The name of the group of pins that are driven or received by the states in the data block.

The step size of the address bus. This parameter is optional.

step automatic This statement indicates that the step size will be determined by the byte width of the data bus. This parameter is optional


Chapter : A �

Examples

address Address to groups AddressBus

General Information

(none)


Chapter : A �

add sync at (DEBUG)

Title: ADD A SYNC PULSE TO A VECTORThe add sync at function associates the debug sync signal with a specific vector. There is only one debug sync. This function does not affect the syncs programmed into the test using the VCL sync keyword. The debug sync is cancelled by the remove sync

function; alternatively, executing another add sync at function removes the sync from the current vector and associates it with the new one.

Use the dbconnect function to connect the pulse to the debug sync port on the side of the testhead.

Syntax

add sync at is a

Parameters

The number of the vector where the sync is to occur.


Chapter : A �

Examples

add sync at 125 ! associates sync with vector 125dbconnect sync to debug syncexecute to endadd sync at 69 ! moves sync from vector 125 to vector 69remove sync ! cancels sync from vector 69add sync at Fail_Vector

General Information

The sync pulse is the same as the sync in the VCL test. The pulse does not occur if the test is executed by the debug display failure function.


Chapter : A �

add vector at (DEBUG)

Title: ADD A VECTORThe add vector at function adds vectors to the digital test being debugged by duplicating the specified machine vector a number of times. The added vectors are executed after the specified machine vector. Initially the vector states for all added vectors are set to K which keeps the state from the previous vector. After adding the vectors, the set driver state on and setreceiver state on statements can be used to create a desired waveform. Vectors cannot be added after no-op vectors or after vectors that cause a branch (as in a loop).

See the section The Pipe in Test Methods: Digital for an explanation of no-op vectors.

If the digital test disables any devices, the disabling is retained for the execution of the added vectors. For digital tests which have been translated into machine vectors using the paired mode strategy, only an even number of machine vectors should be added, otherwise a warning is generated.

Syntax

add vector at add vector at ,

is a is a

Parameters

The number of the machine vector to duplicate. Duplicated vectors are added after the vector number specified.

The number of vectors to add. If a count is not specified, only a single vector is added.


Chapter : A �

Examples

add vector at 22 ! adds a single vector after machine vector number 22add vector at 22, 10 ! adds ten vectors after machine vector number 22

General Information

Sufficient memory must be available in the directory RAM, sequence RAM and pin RAM to add vectors. Use the debug status function to determine how much memory is available in each of the RAMs.


Chapter : A �

analog (edit) Title: INVOKE ANALOG MODEThe analog function clears the workspace and sets the workstation into analog mode. This mode must be selected to edit or write analog in-circuit component device tests, which are called analog in-circuit test blocks.

Statements entered in analog mode are syntax-checked to ensure that they are valid analog programming statements. Editing statements and other mode selection statements can be executed as usual while in the analog mode.

Syntax

analoganalog;

can be:windownowindow

Parameters

Either window or nowindow. Specifying window opens a new window in analog mode, while nowindow suppresses the opening of a new window (if your test system is configured to automatically open a new window whenever a mode change is specified).


Chapter : A �

Examples

analog ! Invokes the "analog" mode.analog;window ! Opens a new window and sets it to "analog" mode.

General Information

The analog function is not programmable.


Chapter : A �

and (BT-BASIC) Title: CONJUNCTIONThe and operator is used to evaluate Boolean expressions. It returns a value of 1 if the expression on the left and the expression on the right are both true (non-zero). If one or both of the expressions are false (zero), the operator returns a value of zero. This operator has a priority of 2.

Syntax

and

Parameters

The quantities to be evaluated.


Chapter : A �

Examples

print 12 and -123.4 ! prints 1print 0 and 345 ! prints 0print 4*3 and .000001 ! prints 1print 20 and 10 -10 ! prints 0 ! "and" has lower priority than -print (20 and 10) -10 ! prints- 9A = 25 \ print A and 7 ! prints 1

General Information

(none)


Chapter : A �

andtree (VCL) Title: AND TREE DEVICE TESTThe andtree statement appears in the Declaration section of the test to indicate that the device to be tested contains an AND tree testability structure.

The andtree statement provides information to the program generators for completing the Vector Execution section of the test.

The andtree statement must precede the assign to statements in the test (See Chapter 2, Vector Control Language (VCL) in Test Methods: Digital).

Syntax

andtree

Parameters

(none)

Examples

andtree


Chapter : A �

General Information

(none)


Chapter : A �

append (BT-BASIC)

Title: APPEND SYSTEM FILESThe append function is used to append one or more source files (or portions of files) to a destination file. All files specified must be local system files of the same type (BASIC, text, etc.). The source file(s) is left unaltered. The destination file cannot be a source file or a device.

When multiple source files are specified, they are appended in the order of their appearance in the function, left to right.

When first and/or last line numbers are included in a source file, only the specified lines are appended. If only a first line number is specified, the system appends from that line to the end of the file. (However, do not specify a first line number that is beyond the end of the file or an error results.) If only a last line number is included, the system appends from the beginning of the file to that line number. If you specify a last line number that is beyond the end of the file, the entire file is appended.


Chapter : A �

Syntax

append to append to ,

is a is a can be:

;;; . . .

can be: ,,,,,

and are

Parameters

A string expression that identifies a system file.

Numeric expression which delineates a partial file to be appended. It must evaluate to positive number.

Numeric expression which delineates a partial file to be appended. It must evaluate to positive number.

The identifier of an error variable.


Chapter : A �

Examples

append "/board/part2" to "/board/part1"append "file1",10,300 to "file2", Errappend "file2";"file3",,200 to "file1"

General Information

(none)


Chapter : A �

arm (ANALOG) Title: ARM DETECTORSThe arm detector function triggers the detector that was previously setup by the detector function. The detectors that can be triggered are the: frequency, pulse, and interval detectors.

The arm trigger function can arm the external trigger input. Once armed, the wait for trigger function causes the test to wait for the trigger from the external device. The external device providing the trigger is specified in the trigger analog from form of the trigger function.

Syntax

arm detectorarm trigger

Parameters

(none)


Chapter : A �

Examples

detector frequencyarm detectorarm triggerwait for trigger 1

General Information

(none)


Chapter : A �

asn (BT-BASIC) Title: ARCSINE The asn function returns the arcsine of the function's argument. The result is the principal value of the angle, in radians.

Syntax

asn()

Parameters

The argument of the function:

-1


Chapter : A �

Examples

print asn(0.8) ! prints .927295218002print asn(-.56) ! prints -.594385800001print 10+4*asn(.5) ! prints 12.0943951024

General Information

(none)


Chapter : A �

assign to (BT-BASIC)

Title: ASSIGN AT-NAME TO FILE OR I/O DEVICEThe assign to function associates an @ (pronounced at-name) with a file (or device) so that the file (or device) can be accessed serially. The I/O statements then reference the file by its @ instead of by its file id. When a file is referenced by its @, the file remains open after each access, so that the accesses are serial. When the file is referenced by its file id, it closes after each access, so that every access starts at the beginning.

If a file is to be opened for reading, then that file must exist or an error occurs. If the file is to be opened for writing, then it is automatically created if it does not exist. However, if the new parameter is specified, then an error occurs if the file already exists.

The function's parameters determine how a file is opened. Usually, a file is opened for read-only (read), or for write-only (write). Then, after all I/O accesses have been made, the file is closed. However, there is a read-and-write option (read, write) for use with files which represent two-way devices, such as voltmeters. These devices can be both written to, and read from, without having to be closed between the different operations.

If a disk filei.e., not a deviceis opened for read-and-write, then the first I/O function which accesses that file determines how the file is to be usedeither for reading or for writing. Subsequent accesses must then be for the same purpose, until the file is closed.

The parameter (append, new, over) applies only to writing. With over, writing starts at the beginning of the file and the existing data in the file is lost. With append, any existing data in the file is retained and the new data is written at the end of the file. In either case, if the file does not exist, it is created. If new is specified, a new file is created. An error results if the file already exists.

A file can be opened for exclusive use or for shared use. Exclusive allows only one person to access the file until it is closed, and shared allows more that one user to open the file at the same time. This could be from different workstations, or from the same workstation but opening the file with more than one @.


Chapter : A �

Shared access allows one person to write to, and the others to read from, a file. However, it is possible for more than one person to write to the same shared file and to access it differently; e.g., one writes over and the other writes append. It is, therefore, necessary for users to ensure that their activities do not conflict and thus destroy each other's data.

A file is closed when its @ is assigned to another file or to an asterisk (*).

An @ is local to the environment in which it is assigned. However, an @ can be referenced globally in a subprogram, or it can be passed to the subprogram when it is called. This applies both to subroutines and to user-definable functions. If the @ is local to a subprogram, then the file is automatically closed when an exit is made from that subprogram.

Be aware that not all I/O statements can reference an @. Those that can are control, enter and enterusing, output and output using, status, and the GPIB statements.


Chapter : A �

Syntax

assign @ to assign @ to ;assign @ to *assign @, to assign @, to ;assign @, to *

is a is a is a

can be:

, read,read,write,write,,

can be:exclusiveshared

can be:appendnewover

NOTENote that the parameters do not have to be in the order shown. They can be arranged in any order; see Example on page A-39.


Chapter : A �

Parameters

@ The at-name to be assigned to the file or device, where is a .

If the file or device is shared, any number of @ can be assigned to it. But any one @ cannot be assigned to more than one file or device. If the @ is already assigned, then the previous assignment is cancelled and the new one established.

The identifier of the file or device to be associated with the @. The must not already exist if new is specified.

The file opens when the @ is assigned. It remains open until closed by assigning the @ either to another file or to an asterisk (*). If the file is shared, it does not close to other users.

* An asterisk cancels the @ and closes the file or device.

The identifier of an error variable.

Determines how the file or device is opened. The permissible values are:

� read: Subsequent I/O statements must read from the file.

� write: Subsequent I/O statements must write to the file.

� read, write: For devices, I/O statements can read and write. For disk files, the first I/O function to access the file determines whether read or write is selected.

See General Information on page A-39 for the defaults which take effect if no explicit values are specified.

Determines whether the file is for exclusive or shared use.

Determines how the data is to be written. The file is created if it does not already exist. The permissible values are:


Chapter : A �

append: Adds data below any existing data in the file. If none is present, writes from the beginning of the file.

new: Creates a new file and writes from the beginning. An error occurs if the file already exists.

over: Writes from the beginning of the file and destroys any existing data.

Example

! Creates a new file for writing and for shared access, and includes an error variableassign @Test, Err2 to "/boardtest/power_amp" ; shared, write, newP$ = "/board/a346_12c/notes"assign @Notes to P$; write, exclusive, appendoutput @Notes; A$, B, C ! Adds data to existing data in fileassign @Notes to * ! Closes fileassign @DVM to "/dev/dvm2"; read, write, exclusiveassign @Tape to "/dev/tape" ! Opens tape reader exclusively and for

! read-and-write access; uses default values! (see below)

General Information

If values are not specified for the parameters, they default to the following:


Chapter : A �

DEFAULT OPTIONSNo parameters defaults to: "read , "write" & "exclusive"If neither "read" nor "write" is specified :

If is specified, defaults to: "write"If is not specified, defaults to: "read, write"

not specified defaults to: "over" not specified defaults to: "exclusive"

Although any or all of the parameters can be omitted from the function and allowed to default, we recommended that you do not do this because it makes your program harder to read and debug for someone who is unfamiliar with the default values.


Chapter : A �

assign to (VCL) Title: ASSIGN PINS TO GROUPSThe assign to function appears in the Declaration section of the test to assign device pins or circuit pins to groups, and to name the groups. Other statements then refer to the pins by their group names.

In library tests, the assign to function can reference pins either by pin numbers or by node names. In device tests, pins are usually referenced by the pin numbers shown in the manufacturer's specifications. In cluster tests, the pins are usually referenced by the node names from the board under test.

In executable tests, pins can be referenced as device-pins, as nodes on the PC board, or as relays. Relays are 5-character designators in brrcc format (bank, row, row, column, column) representing interface pins in the testhead.

A VCL test can have any number of assign to statements and they must precede all other statements which reference group names (see Order of Statements in Test Methods: Digital).

The assign to function looks complicated because of all of its options, but the general use of the function is relatively straightforward. Therefore, we recommend that you look at the examples before reading this material.

Except for the pins that are not to be tested, pins assigned to any one group must all be of the same type: types are inputs (system drivers) to the device, outputs (system receivers) from the device, and bidirectional pins. Pins to be tied to a power nodeVCC, or GND, for examplemust also be assigned to their own group(s).

When you are deciding how to group pins in library tests, you should consider how the program generators might treat the test when there are topology conflicts. It is better to have many small groups rather than a few large groups, and to reference as few groups as possible in each vector. This gives the program generators more flexibility in arranging the test to suit the topology of the specific device being tested (see Resolving Topology Conflicts in Test Methods: Digital).

All of the pins that a test uses must be assigned to a group. Any one pin may be assigned to more than one group; however, you must be careful to avoid generating conflicting vectors as a result. Assignment statements which reference the same group are cumulative; this allows any number of pins to be assigned to the same group. However, any one pin must not be assigned to the same group more than once.


Chapter : A �

The parameter allows you to consolidate several groups into one larger group and assign a name to that group. Other statements can then reference the consolidated groups either singly, using their individual group names, or all at once, using the consolidated-group name. Any one pin can be assigned to only one of the groups which were consolidated.

Relays are used only in executable tests because those tests can reference a specific PC board. Device designators cannot be used in library tests because they reference specific devices (e.g., U43) on the PC board. The device designator must be used in the executable test, either in the assign to statements or in a default device function. If more than one device designator is required, then the appropriate designator must appear in each assign to function.

The assign to function also has an optional default parameter which can be used to assign default pin states to the pins in a group. During test execution, when a vector is executed, if that vector does not reference that pin group, then the pins in that group have these default states. Pins not referenced in a vector, and not assigned default states, automatically default to X (off) when that vector is executed. Typically, you would not use the default option: its purpose is to enable the program generators to adapt the program to some specific board topology.


Chapter : A �

Syntax

assign to assign to default assign to groups

is a is a the format of is:

,,, . . . .

can be:device pins pins nodes relays

is a the format of the s is:

,,, . . . . s can be:

a. for — can be:

*

b. for — is a

c. for — is a 5-digit numeric constant (brrcc)


Chapter : A �

Parameters

The identifier (see the definition of ) assigned to a group of pins. Each of the assigned in the VCL test must be unique. The identifier Disablegroup cannot be used in a library test: it is reserved for use by the program generators.

The pins to be included in a specific group. The is composed of the following parameters:

�

�

�

�

Refer to the syntax, to the examples, and to the descriptions (below) of the listed parameters, to see how these items fit into the .

Pins can be assigned to the group in any order; all statements that subsequently reference that group assume the same pin-order.

A list of previously assigned , designating pin groups which are to be consolidated into one group. The pin groups in a consolidated group can then be referenced either all at once, by the name of the consolidated group, or individually, by their individual group names.

The groups can be listed in any order; all statements that subsequently reference that consolidated group assume the same group-order. Note that the order of the pins in the consolidated group are, therefore, determined first by the order of the groups, and secondly by the order of the pins in each individual group.


Chapter : A �

A string of characters indicating the default states to be assigned to the pins. The pin states are the same as those used by the set to (VCL) function, except that only the binary format (i.e., one state per pin) can be usedsee the description of the set to function for details. The assigned states must be consistent with the type and direction of the pinsdriver, receiver, and bidirectionalas they are referenced in the vectors.

The string constant containing the reference designator of the device to be tested. This is the same as the designator entered into the board forms; it can contain up to forty-eight printable characters, except a space. The designator must not be used in a library test.

The designator must appear in executable tests, either in the assign to statements or in default device statements. The designator must be unique on the PC board under test.

Identifier of a device pin to be assigned to the group. The can have three forms:

� Pin numbers can be used in either library or executable tests. But they cannot be used in an executable test unless the device designator is specified (see , above). A pin number must be a positive integer, and it can have up to eight digits. Leading zeros are ignored, so that pin numbers 01 and 1 are the same. (Note that, internally, the software converts pin numbers to strings so that pin 01, pin 1 and pin 1 are all the same pinsee , next.)

� This form can have up to eight printable characters, with no spaces. Note that, because they are strings, pin id 01 is not the same as pin id 1also see above. The can be used only in executable tests.

� * (asterisk) This form is not used by the programmer. In executable tests, the program generators replace the pin identifier with an asterisk if the pin is connected to a power node or is not used. They do not assign drivers or receivers to unused pins, but they do assign them to pins that are connected to power nodes.

This is a string constant representing a specific node on the PC board; each node in a VCL test must be unique. The has the same form as the , described above, except that can have up to forty characters, with no spaces.


Chapter : A �

Five numeric digits identify specific interface pins in the testhead; this format can be used only in executable tests.

The has the form brrcc (bank row row column column), to identify the pin by its coordinatese.g., 10625 is in bank 1, row 6, column 25:

� urth and fifth digits represent the vertical column, from right to left in each bank01 through 78; the leading zeros are required.


Chapter : A �

Examples

assign Reset to pins 7, 2, 13 ! used in a library testassign Flag to device "U45" pins 2, 3 ! used in an executable testassign Cntl to pins 1, "01" ! two different pinsassign Control to pins 1, 01, "1" ! error — all the same pin designatorassign Databus to device "U6" pins 3, 4, 5, 6! two statements assign pins to theassign Databus to device "U6" pins 12, 13, 14! same group; order is 3, 4, 5, 6,

! 12, 13, 14assign CLEAR to nodes "Reset1", "Reset2"assign ET10 to relays 12102, 12202, 12105, 12205assign Data to pins "D0", "D1", 6, "D2", "D3" , "D4", 15! types of ids can be mixedassign Enable to pins 12, 13 default "10"! default statesassign Presets to pins 6, 5, *, 3 ! asterisk inserted by the program generators

! because of a topology conflict

The following example shows how to consolidate groups, and how the groups can then be referenced by other statements.

! in the Declaration section. . . .

assign Clock to nodes "U1-3"assign Preset to nodes "U1-4" ,"U1-6"assign Cntl to nodes "U1-1", "U1-5"

!! the next function consolidates all three groups into one group!

assign Control to groups Cntl, Clock, Preset. . . .

! in the Vector Definition section. . . .

set Preset to "00" ! sets states on U1, pins 4,6. . . .


Chapter : A �

set Control to "11010"! sets states on U1, pins! 1,5,3,4,6 — in that order

. . . .

General Information

(none)


Chapter : A �

at event set to (VCL)

Title: SET STATES ON FORMATTED PINSThe at event set to statements are used in timing sets to define state changes on formatted pin groups. The statements can be in any event-order, although ascending order is recommended, for readability. Two or more at event set to statements can reference the same event. There does not have to be an at event setto function for every event in a timing set.

A timing set can be defined without any at event setto statements if it is needed to execute just the vector (drive/receive vector at event statements).

Syntax

at event set to at event offset set to

is an is a is a is a

Parameters

The number of the event at which the changes of state are to occur. The range of values is:

0


Chapter : A �

The identifier of a group of formatted nodes (see the definition of in Chapter 2, Syntax Conventions and Definitions in the Board Test Fundamentals documentation).

The states for the specified pin group; the states are subject to the current format for the group. The changes of state occur at the same time as the event. Only the following characters can be used:

0, 1, K, X, Z

Formatted pins that are not set to some state at event 0, usually hold their current states until specifically changed. However, if a pin is not scheduled to changestates until late in the timing set, that pin might first go to its default state earlier in that timing set; also, pins that are not scheduled to change states in the timing set, go to their default states early in that timing set (see Chapter 3, Advanced Testing With VCL in the Test Methods: Digital documentation for more information).

If one or more statements set conflicting states on a pin, the last of the conflicting states is used.

The offset, in seconds, from the event on which the activity is to occur. The value can range from -30 ns to 100 ns. A value cannot be used if it would place two transistions (state changes) on the same pin closer than 50 ns, or if the transition would then occur in the next vector.

When an offset is specified for a pin, that offset applies to all activities which occur on that pin throughout the VCL test. However, the offset can be overridden by the setdriver offset and set receiver offset statements.


Chapter : A �

Examples

! CS1 is set to "1" at event 0; ACK and RDWR hold their current states! ACK is set to "01" 25 ns after event 3! RDWR is set to "1" 15 ns before event 5

. . .timing set T1 is 10 events

at event 0 set CS1 to "1"at event 3 offset 25n set ACK to "01"at event 5 offset -15n set RDWR to "1"

. . .end timing set

. . .

General Information

In a timing set, if an activity is scheduled to occur at the same time as a wait, then that activity occurs at the end of the wait (see the at event wait function). If the activity has an offset (positive or negative), the offset is applied with respect to the end of the wait.


Chapter : A �

at event wait for (VCL)

Title: SOFTWARE WAIT IN A TIMING SETThe at event wait for function can be used in a timing set to execute a software wait. A software wait cannot be used in a VCL test that uses hardware waits. The wait suspend tests execution and waits for the specified trigger. During the wait, the states of all drivers are held, except the DUT clock driver, if there is one, which continues to run. When the triggering states are received, the test resumes.

Any group of formatted receivers can be specified as the group to trigger termination of the wait (non-formatted groups cannot be used).

Execution of the test resumes twenty-six events after the sample which detects that the trigger conditions are true. If the triggering conditions are already met when the wait starts, the wait lasts for twenty-six event spaces.

A timing set can have only one wait. If required, each timing set can use a different formatted group as its trigger.

Any activities scheduled to occur at the same event as the wait occurs at the end of the wait. If any of those activities has an offset (positive or negative), the offset is applied with respect to the end of the wait.


Chapter : A �

Syntax

at event wait for to at event offset wait for to

is an is a is a is a

Parameters

The number of the event at which the wait is to start. The wait can start on any event in the timing set, except the last event.

The identifier of the formatted pin group which is to trigger the end of the wait (see the definition of in Chapter 2, Syntax Conventions and Definitions in Board Test Fundamentals).

The states that terminate the wait. The states are subject to the current format for the group. Only absolute (1, 0) states are allowed.

The offset, in seconds, applied to the receive strobe on the group of formatted pins which are to trigger the end of the wait. (The offset does not affect the start of the wait itself.) The offset value can range from -30 ns to 100 ns. A value cannot be used if it would place two transitions (state changes) on the same pin closer than 50 ns, or if the transition would then occur in the next vector.

Because the offset is applied to the group of triggering pins, the offset applies to all activities on those pins throughout the VCL test.


Chapter : A �

Examples

! the wait starts at event 7;! when the trigger is acknowledged (Trigger to "111"), the test resumes! twenty-six event spaces later, again at event 7; ACK is set to "01" at that time.! The receivers are strobed at the next event (8).

. . .timing set T1 is 10 events

at event 0 set CS1 to "1"at event 7 set ACK to "01"

drive vector at event 2receive vector at event 8

at event 7 wait for Trigger to "111"end timing set

. . .

General Information

If waits are used in a VCL test, there should be a testtime function in the Declaration section of that test because the SAFEGUARD safety analysis routines cannot know how long a wait lasts.


Chapter : A �

atn (bt-basic) Title: ARCTANGENT The atn function returns the arctangent of the function's argument. The result is the principal value of the angle, in radians.

Syntax

atn ()

Parameters

The argument of the function:

-pi/2


Chapter : A �

autoadjust (BT-BASIC)

Title: AUTOADJUST THE SYSTEMThe system is automatically calibrated approximately every 1000 hours of CPU time, or whenever the temperature changes, up or down, by 5 degrees centigrade. If autoadjust is needed, the unpowered and powered statements set up the autoadjust to be executed in the next fxoff function. However, you can specify an adjustment cycle when desired (for a critical measurement), with the autoadjust function.

If autoadjust is on, the adjustment occurs on the first vacuum off function after the time or temperature limit is exceeded. The autoadjust cycle requires that no fixture be locked on the testhead during the cycle. The system automatically unlocks any fixture at the start of the cycle, and relock it at the end.

If autoadjust is off, no automatic adjustment occurs. The autoadjust parameter of the testhead status function is 0 (false), if an adjustment is required.

The autoadjust cycle takes less than five minutes to complete.

If a failure on the ASRU Card, or in the digital subsystem, is detected during an autoadjust cycle, the testhead status icon displays caution. The adjustedhardware parameter of the testhead status function is 0 (false). Testing is allowed to continue and the system uses the most recent valid adjustment tables.

Syntax

autoadjustautoadjust

can be: onoff

Parameters

(none)


Chapter : A �

Examples

autoadjust ! Initiate an adjustment.autoadjust off ! Turn autoadjust off.autoadjust on ! Turn autoadjust on.

General Information

(none)


Chapter : A �

autofile (BT-BASIC)

Title: FIXTURE IDENTIFICATIONThe autofile function returns the value of the current autofile code.

The autofile function identifies the fixture currently on the testhead by reading the autofile code wired into the fixture. The autofile function points to the corresponding board directory so that the proper files can be automatically loaded. The valid range of autofile codes is 11 to 4094.

Syntax

autofile

Parameters

(none)


Chapter : A �

Examples

autofile ! Return the value of the autofile bits.A = autofileprint A ! Print the value of the autofile bits.

General Information

(none)


Chapter : A �

autolearn (BT-BASIC)

Title: START AUTOLEARN ON A TESTThe autolearn function clears all current autolearn d

Syntax Reference - Keysight · confirm all nodes (AUTOLEARN), C-98 confirm crc for node...

Documents

Transcript of Syntax Reference - Keysight · confirm all nodes (AUTOLEARN), C-98 confirm crc for node...