Scripting test preferences |

This section describes scripting many of the user settings available from the BurnInTest Preferences Windows. Notes:
• | All commands are case insensitive. They are written in upper case for illustration.
• | Scripting of the 3D, tape and Printer preferences are not supported in the current version of BurnInTest.
SETBATTERY COMMAND Overview: Set the test preferences for the Battery test. Syntax: SETBATTERY PRE_TEST <parameter> MAIN_TEST <parameter> [USE_THRESHOLD <parameter> THRESHOLD <parameter> | USE_PERC_THRESHOLD <parameter> PERC_THRESHOLD <parameter>] USE_FULL_CHARGE <parameter> Parameters: PRE_TEST (run the test as a pre-test): [ YES | NO ] MAIN_TEST (run the test with the main set of tests): [ YES | NO ] USE_THRESHOLD: Use an absolute threshold THRESHOLD: The absolute threshold value (e.g. 30000 mA) USE_PERC_THRESHOLD: Use a percentage threshold PERC_THRESHOLD: The percentage threshold value (e.g. 80%) USE_FULL_CHARGE: [ YES | NO ] Note: only USE_THRESHOLD or USE_PERC_THRESHOLD may be specified, not both. Example: SETBATTERY PRE_TEST YES MAIN_TEST YES USE_THRESHOLD YES THRESHOLD 30000 SETBATTERY PRE_TEST YES MAIN_TEST NO USE_PERC_THRESHOLD YES PERC_THRESHOLD 95 SETDEFAULTPREFERENCES COMMAND Overview: Set the test preferences to the initial installation state. Syntax: SETDEFAULTPREFERENCES Parameters: This command does not require any parameters. Example: SETDEFAULTPREFERENCES SETDISK COMMAND Overview: Set the disk test options. The first parameter for the command is always disk name except for ‘ALL’ parameter which tests all drives. Syntax: SETDISK DISK <parameter> MODE <parameter> SLOW <parameter> FILE <parameter> BLOCK <parameter> SMART <parameter> SEEK <parameter> BADSECTOR <parameter> THRESHOLD <parameter> DUTY <parameter> USERPATTERN <parameter> SETDISK ALL <parameter> Parameters: DISK: Disk Name (volume letter) This parameter must be specified first. MODE (Test Mode): 1.CYCLIC (Cyclic) 2.SEQUENTIAL (Sequential data pattern) 3.SEEKING (Random data with random seeking) 4.HIGHLOW (High low frequency data overwrite) 5.BUTTERFLY (Butterfly seeking) 6.BINARY1 (Binary data pattern 1) 7.BINARY2 (Binary data pattern 2) 8.ZEROS (Zeros data pattern) 9.ONES (Ones data pattern) 10.RANDOM (Random data pattern) 11.USERDEFINED (User defined pattern) SLOW (Slow drive threshold): Value in MB/sec FILE (File Size): Value in % of disk space BLOCK (Block size): Value in KB SMART (Log SMART errors): [ YES | NO ] SEEK (Seek count): Value BADSECTOR (Log bad sector increase): [ YES | NO ] THRESHOLD (Bad sector threshold): Value DUTY (Duty cycle override): Value in % USERPATTERN (the 8-byte hexadecimal user pattern): Value (e.g. 00AA00AA00AA00AA) The following parameters are global (i.e. not for a particular disk): ALL (Select all hard drives): [ YES | NO ] Examples: SETDISK DISK c: MODE binary1 SLOW 4 FILE 2 BLOCK 512 SMART no SETDISK DISK d: SEEK 10 BADSECTOR yes THRESHOLD 25 DUTY 5 SETDISK DISK c: MODE userdefined USERPATTERN 00AA00AA00AA00AA BLOCK 65536 SETDISK ALL yes SETOPTICALDISK COMMAND Overview: Set the Optical disk test preferences. The first parameter for this command is always optical disk name except for ‘ALL’ parameter which tests all drives. The Burn CD and Burn DVD test modes cannot be scripted. Syntax: SETOPTICALDISK DRIVE <parameter> MODE <parameter> SEEK <parameter> SEEK_VAL <parameter> BLOCK_AUTO <parameter> SETOPTICALDISK ALL <parameter> Parameters: DRIVE: Drive Name This parameter must be specified first. MODE (Test mode): 1. NO_TEST (No test) 2. MUSIC (Music CD playback) 3. DATA (Data disk read and verify) 4. PASSMARK (Passmark test CD/DVD/BD) 5. NO_CD (No media in drive) SEEK (Seek count): [ YES | NO ] COUNT (Seek count value): Value of seek count BLOCK_AUTO (Autoplay configuration): [ YES | NO ] The following parameters are global (i.e. not for a particular disk): ALL (Select all optical drives): [ YES | NO ] Example: SETOPTICALDISK DRIVE d: MODE passmark SEEK yes SEEK_VAL 5 BLOCK_AUTO yes SETOPTICALDISK ALL yes SETLOG COMMAND Overview: Set the Logging test options. Syntax: SETLOG LOG <parameter> NAME <parameter> PREFIX <parameter> TIME <parameter> REPORT <parameter> LOGLEVEL <parameter> TRACELEVEL <parameter> SUM <parameter> LINES <parameter> PERIODIC <parameter> FILE <parameter> Parameters: LOG (Turn automatic logging on): [ YES | NO ] NAME (Log file name): File path within double quotes PREFIX (Log file prefix): File prefix within double quotes TIME (Time Stamped files): [ YES | NO ] REPORT (Report type) (only one selectable): 1. TEXT (Text) 2. HTML (HTML) 3. CERT (Customer certificate) LOGLEVEL (Log file detail level): 1. NO (result summary) 2. Yes (normal) TRACELEVEL (Trace file detail level), the trace file format will be set to text: 1. No (no trace) 2. A1 (Activity trace 1) 3. A2 (Activity trace 2) SUM (Summarize): [ YES | NO ] LINES (Max file size): Maximum number of lines PERIODIC (Periodic result summary logging interval): Value in minutes FILE (Pre-test logging Options): 1. NEW(Clear the test result and create a new log file) 2. APPEND(Clear the test result and append the next test to the existing log file) 3. ACCUMULATE (Accumulate test result across test runs and append to existing log Examples: SETLOG LOG yes NAME "file1.html" PREFIX "computername" TIME yes SETLOG REPORT html REPORT cert LOGLEVEL yes TRACELEVEL a2 SUM yes LINES 10000 SETLOG PERIODIC 2 FILE append Notes: For convenience, the BurnInTest V6.0 syntax for SETLOG is still supported, however new scripts should not use the V6.0 syntax: SETLOG COMMAND Syntax: SETLOG <Filename> Parameters:
<Filename> | The name of the log file. The file name must be enclosed in double quotes (“”).
SETERRORS COMMAND Overview: Sets the errors test preferences Syntax: SETERRORS ACTION <parameter> WINDOWS <parameter> Parameters: ACTION (Action on Error): 1. CONTINUE 2. SOUND (Play sound and continue) 3. BEEP (System beep and continue) 4. STOP (Auto stop tests) WINDOWS: 1. BLOCK (Block critical window errors) 2. ALLOW (Allow critical window errors) Example: SETERRORS ACTION beep WINDOWS allow SETNETWORK COMMAND Overview: Set the network preferences for test. The advanced network test options cannot be scripted. Syntax: SETNETWORK ADD[1-12] <parameter> SETNETWORK ERROR <parameter> TIMEOUT <Parameter> RATIO <parameter> SETNETWORK ALL <parameter> SETNETWORK BLUETOOTH <parameter> NAME <parameter> Parameters: ADD1 – ADD20: Supply the network address The following parameters are global (i.e. not for a network port test disk): ERROR (Error setting for bad packet): 1. EVERYPACKET (Every bad packet generated an error) 2. HIGHRATIO (High bad packet ratio generated an error) TIMEOUT (Timeout): value in msec. RATIO (Bad Packet Ratio): Ratio of Bad packet to total packets ALL (Test mode): [LOOPBACK | YES | ETHERNET | WIRELESS ] BLUETOOTH (bluetooth_active): [ YES | NO ] NAME (Remote device name): Name of the remote Bluetooth device Examples: SETNETWORK ADD1 "192.1.1.1" SETNETWORK ADD2 "192.1.1.2" SETNETWORK ADD13 "192.1.1.2" SETNETWORK ALL yes SETNETWORK ERROR everypacket TIMEOUT 3 RATIO 2 SETNETWORK BLUETOOTH yes NAME " My test device " SET2DGRAPHICS COMMAND Overview: Sets the 2D graphics test options. The scrolling ‘H’ EMC test and multiple monitor testing option cannot be scripted. Syntax: SET2DGRAPHICS TYPE <parameter> IGNORE <parameter> Parameters: TYPE: 1. LOCAL(Local video memory only) 2. ALL(All available video memory) 3. LINES(Lines and Bitmap ) IGNORE (Ignore skipped frames): [ YES | NO ] Example: SET2DGRAPHICS TYPE all IGNORE yes SETUSB COMMAND Overview: Set the USB test options. Script currently support change in maximum number of ports Syntax: SETUSB <number> Parameters: number: Value of ports to be tested Example: SETUSB 3 SETRAM COMMAND Overview: Set the RAM test options. Multi-Process Torture test and AWE tests options cannot be scripted. Syntax: SETRAM TYPE <parameter> PATTERN <parameter> PRETEST <parameter> LOG <parameter> Parameters: TYPE (Ram test mode): 1. STANDRAD (Standard) PATTERN: [CYCLIC | SEQUENCE | BINARY1 | BINARY2 | ZEROS | ONES | ADJACENCY ] PRETEST (run the standard test as pre-test): [ YES | NO ] LOG (Log memory applications): [ YES | NO ] Example: SETRAM TYPE standard PATTERN binary1 PRETEST no LOG yes SETPLUGIN COMMAND Overview: Set the plug-in preferences for test. Syntax: SETPLUGIN PLUGIN[1-5] <parameter> PRETEST[1-5]<parameter> SETPLUGIN SIMULTANEOUS <parameter> SETPLUGIN IGNORE_NO_OPS <parameter> Parameters: PLUGIN1 - PLUGIN5 (specify plug-in application): specify the plug-in path within double quotes. PRETEST1 - PRETEST5: [ YES | NO ] SIMULTANEOUS: [ YES | NO ] IGNORE_NO_OPS: [ YES | NO ] Examples: SETPLUGIN PLUGIN1 "c:\plugin1.exe" PRETEST1 yes SETPLUGIN PLUGIN2 "C:\plugin2.exe" PRETEST2 no SETPLUGIN SIMULTANEOUS yes SETPLUGIN IGNORE_NO_OPS yes SETVIDEOPLAYBACK COMMAND Overview: Set the Video playback files for test. Multiple monitor testing options cannot be scripted. Syntax: SETVIDEOPLAYBACK VIDEO[1-4] <parameter> Parameters: VIDEO1 - VIDEO4: Video file path within double quotes Example: SETVIDEOPLAYBACK VIDEO1 "c:\video1.avi" VIDEO2 "c:\video2.mpg" VIDEO3 "c:\video3.wmv" VIDEO4 "c:\video4.mpeg" SETSERIALPORTS COMMAND Overview: Set the serial test options. Syntax: SETSERIALPORTS COM<0-63> <parameter> SETSERIALPORTS DISABLE <parameter> FLOWCONTROL <parameter> TIMEOUT <parameter> SPEED <parameter> Parameters: COM0 – COM63: Com port selection 1. DETECT_LOOP (Detect and loop test) 2. DETECT (Detect test only) 3. NONE (remove from comp port selected ) The following are global COM port test parameters (i.e. not specific to a COM port): DISABLE (Disable RTS/CTS and DSR/DTR test phase): [ YES | NO ] FLOWCONTROL (Use RTS/CTS flow control during loopback): [ YES | NO ] TIMEOUT (Send and recv Timeout): Value in ms PORT_SPEED (Kb/s): [ 110 | 300 | 600 | 1200 | 2400 | 4800 | 9600 | 14400 | 19200 | 38400 | 56000 | 57600 | 115200 | CYCLE_115K | 128000 | 256000 | CYCLE_256K | 921600 ] Examples: SETSERIALPORTS COM1 detect_loop COM2 detect_loop COM3 detect SETSERIALPORTS DISABLE no TIMEOUT 20 SPEED 19200 SETPARALLELPORTS COMMAND Overview: Set the Parallel test options. Syntax: SETPARALLELPORTS PORT <parameter> TEST <parameter> Parameters: PORT (Parallel port number): Value of port number TEST (Test type): 1. DETECT_LOOP (Detection and loopback test) 2. DETECT (Port detection only) Note: Only 1 parallel port can be tested at a time. Example: SETPARALLELPORTS PORT lpt1 TEST detect SETSOUND COMMAND Overview: Set the Sound test options. Syntax: SETSOUND TEST STANDARD WAV <parameter> MIDI<parameter> MP3 <parameter> SETSOUND TEST LOOPBACK DISTORTION <parameter> DEVICEOUT <parameter> Parameters: TEST(Sound test type): 1. STANDARD (Standard test) 2. LOOPBACK (Loopback test) WAV : File path MIDI: File path MP3 : File path DISTORTION (Max Distortion) : value DEVICEOUT: A substring to match the output audio device (as can be viewed in Preferences->Sound). Examples: SETSOUND TEST standard WAV "myfile.wav" MIDI "myfile.midi" MP3 "myfile.mp3" SETSOUND TEST loopback DISTORTION 7 SETSOUND TEST loopback DISTORTION 7 DEVICEOUT "Speaker" SETCPU COMMAND Overview: Set the CPU test options. The CPU affinity options cannot be scripted. Syntax: SETCPU GP <parameter> FPI <parameter> PRIME <parameter> MAX_HEAT <parameter> MMX <parameter> 3DNOW <parameter> SSE <parameter> SSE2 <parameter> SSE3 <parameter> SSE4_1 <parameter> SSE4_2 <parameter> SSE4A <parameter> AES <parameter> Parameters: GP (General Purpose Instructions): [ YES | NO ] FPU (Floating Point unit Instructions): [ YES | NO ] PRIME (Prime number test): [ YES | NO ] MAX_HEAT: [ YES | NO ] MMX: [ YES | NO ] 3DNOW: [ YES | NO ] SSE: [ YES | NO ] SSE2: [ YES | NO ] SSE3: [ YES | NO ] SSE4_1: [ YES | NO ] SSE4_2: [ YES | NO ] SSE4A: [ YES | NO ] AES: [ YES | NO ] Examples: SETCPU GP yes FPU yes PRIME yes MAX_HEAT yes MMX yes 3DNOW yes SSE yes SSE2 yes SETCPU SSE3 yes SSE4_1 yes SSE4_2 yes SSE4A yes SETPRETEST COMMAND Overview: Sets the test preferences for Pre-Test options Syntax: SETPRETEST ACTION <parameter> PATH <parameter> Parameters: ACTION (Action before running tests): 1. NONE (start immediately) 2. WARNING (display warning messages) 3. RUN (run external application) 4. WAIT (run external application and wait) PATH (External application): Specify the application path within double quotes Example: SETPRETEST ACTION run PATH "c:\filename.exe" SETPOSTTEST COMMAND Overview: Set the Post-Test options. The reboot options cannot be scripted. Syntax: SETPOSTTEST AUTO_STOP_P <parameter> MAN_STOP_P <parameter> RESULT_P <parameter> SYSTEM_BEEP_P <parameter> RUN_P <parameter> SETPOSTTEST AUTO_STOP_F <parameter> MAN_STOP_F <parameter> RESULT_F <parameter> SYSTEM_BEEP_P <parameter> RUN_F <parameter> Parameters: AUTO_STOP_P /AUTO_STOP_F (auto stop options): 1. NORMAL ( Stop tests ) 2. PRINT (Stop test and print result) 3. RUNAPP (Run extern app and exit) 4. REBOOT (Exit and reboot PC) MAN_STOP_P/MAN_STOP_F (Manual stop options) 1. NORMAL (Stop tests) 2. RUNEXTERNAL (Display option to run application) RESULT_P/RESULT_F (Always display result window): [ YES | NO ] SYSTEM_BEEP_P/SYSTEM_BEEP_F (Use System Beep on autostop): [ YES | NO ] RUN_P/RUN_F (run external application): Specify the application path within double quotes. Examples: SETPOSTTEST AUTO_STOP_P runapp MAN_STOP_P normal RESULT_P no RUN_P "pass_app.exe" SETPOSTTEST AUTO_STOP_F runapp MAN_STOP_F normal RESULT_F no RUN_F "fail_app.exe" SETMANAGEMENT COMMAND Overview: Set the BurnInTest Management Console preferences. Syntax: SETMANAGEMENT MANAGE <parameter> SERVER_ADDRESS <parameter> Parameters: MANAGE (Turn BurnInTest Management Console usage on/off): [ YES | NO ] SERVER_ADDRESS: specify the BurnInTest Management Console URL within double quotes. Examples: SETMANAGEMENT MANAGE yes SERVER_ADDRESS "http://www.passmark.com/burnintest/management/BITConsoleMsgHandler.php" SETTEMP COMMAND Overview: Set the temperature preferences. Currently scripting supports the configuration of the temperature scale preferences and allows the Automatic temperature monitoring to be turned on or off. The Battery/UPS Monitoring options cannot be scripted. Syntax: SETTEMP SCALE <parameter> SETTEMP AUTO <parameter> SETTEMP THRESHOLD <parameter> SETTEMP AUTO_CPU <parameter> AUTO_GPU <parameter> AUTO_DISK <parameter> SETTEMP SAMPLE <parameter> Parameters: SCALE: [C|F] for Celcius or Fahrenheit AUTO: [YES|NO]. Specify YES to turn on automatic BurnInTest temperature monitoring at the start of testing. Specify NO to turn off automatic temperature monitoring and set the temperature monitoring application to no monitoring. THRESHOLD: [YES|NO]. Specify YES to stop testing on temperature threshold exceeded. AUTO_CPU, AUTO_GPU, AUTO_DISK: The temperature threshold for the CPU, GPU and disk when AUTO temperature monitoring is turned on. SAMPLE: Temperature sample interval in seconds. Examples: SETTEMP SCALE c SETTEMP AUTO yes SETTEMP THRESHOLD YES SETTEMP AUTO_CPU 90 AUTO_GPU 80 AUTO_DISK 60 SETTEMP SAMPLE 10