Scripting test preferences

Top  Previous  Next

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.

 

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>

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)

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 %

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 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 – ADD12: 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 ADD12 "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-3]<parameter>

Parameters:

PLUGIN1 - PLUGIN5 (specify plug-in application): specify the plug-in path within double quotes.

PRETEST1 - PRETEST3 (run as pre-test Plugin option available for Plugins 1-3): [ YES | NO ]

Examples:

SETPLUGIN PLUGIN1 "c:\plugin1.exe" PRETEST1 yes

SETPLUGIN PLUGIN2 "C:\plugin2.exe"   PRETEST2 no

 

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>

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

Examples:

SETSOUND TEST standard WAV "myfile.wav" MIDI "myfile.midi" MP3 "myfile.mp3"

SETSOUND TEST loopback DISTORTION  7

 

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>

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 ]

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"