PRACTICE Script Language Reference Guide

1 MANUAL Release Script Language Reference GuidePRACTICE Script Language Reference Guide | 2 1989-2021 Lauterbach GmbH PRACTICE Script Language Reference Guide trace32 Online Help trace32 Directory trace32 Index trace32 Documents .. PRACTICE Script Language .. PRACTICE Script Language Reference Guide ..1 Related Documents ..5 A .. D ..6 APPENDA ppend to file6 BEEPA coustic signal6 CLOSEC lose file7 CONT inueContinue PRACTICE script7 DECRYPTD ecrypts a text or binary file8 DOStart PRACTICE script9 DODECRYPTE xecute encrypted PRACTICE Script (*.cmm)10 E .. F ..11 ECHOW rite text and data to an AREA window (with format decoration)11 ELSEC onditional Script execution13 ENCRYPTE ncrypt a text or binary file14 ENCRYPTDOE ncrypt a PRACTICE Script (*.)

2 Cmm)15 ENCRYPTPERE ncrypt a PER file (*.per)16 ENDT erminate PRACTICE scripts, ENDDOR eturn from a PRACTICE script18 ENTERW indow-based input19 ENTRYP arameter passing21 G .. H ..22 GLOBALC reate global PRACTICE macro22 GLOBALONG lobal event-controlled PRACTICE Script execution23 GOSUBS ubroutine call29 GOTOL ocal Script jump31 I .. L ..32 IFConditional Script execution32 INKEYC haracter input33 JUMPTOG lobal Script jump33 LOCALC reate local PRACTICE macro34 M .. O ..36 PRACTICE Script Language Reference Guide | 3 1989-2021 Lauterbach GmbH ONEvent-controlled PRACTICE Script execution36 OPENOpen data file41 P ..42 PARAMETERSP arameter fetching42 PBREAKB reakpoints in PRACTICE Script files (*.

3 Cmm)43 command - for backward compatibility reasons43 breakpoint44 breakpoint44 breakpoint45 breakpoint list46 disables breakpoint handling47 re-enables breakpoint handling48 all breakpoints48 breakpoint49 PEDITEdit PRACTICE script52 PLISTList PRACTICE script55 PMACROPRACTICE macros56 explicit PRACTICE macro declaration56 PRACTICE macro declaration58 PRACTICE macros59 PRACTICE macros59 current PRACTICE macros60 PRACTICE macros61 PRINTW rite text and data to an AREA window (without format decoration)62 PRINTFW rite formatted data to an AREA window66 PRIVATEC reate private PRACTICE macro74 PSKIPSkip command or block in PRACTICE script76 PSTEPE xecute single line77 PSTEPOUTBack to caller78 PSTEPOVERStep over callee and stop at the next Script line79 Q.

4 R ..80 READRead from data file80 RePeaTLoop with check at end of loop81 RETURNR eturn from subroutine83 RETURNVALUESTake return values84 RUNS tart PRACTICE script85 S .. T ..86 SCREENS creen updating86 always86 screen87 refresh87 when printing87 PRACTICE Script Language Reference Guide | 4 1989-2021 Lauterbach GmbH screen while waiting88 SPRINTFW rite formatted data to a PRACTICE macro90 STOPI nterrupt PRACTICE script91 SUBROUTINED efine a subroutine92 W .. Z ..93 WAITWait until a condition is true or a period has elapsed93 WHILELoop with check at start of loop95 WRITEW rite to data file96 WRITEBW rite binary data to file97 PRACTICE Script Language Reference Guide | 5 1989-2021 Lauterbach GmbH PRACTICE Script Language Reference GuideVersion 04-Nov-2021 Related DocumentsFor information about how to pass parameters, PRACTICE macros, etc.

5 , refer to: PRACTICE Script Language User s Guide ( )For information about literals, operands, operators, and operator precedence, refer to: PowerView User s Guide ( ). Alternatively, choose Help menu > Index, and then enter the search information about functions, refer to: PowerView Function Reference ( ) General Function Reference ( )For information about the purpose of functions in trace32 , how to use functions, and the difference between functions and commands, refer to: General Function Reference ( );To retrieve the same information via the trace32 command "scripting" "literals" "parameter types" "operands" "operators" "operator precedence" "functions" PRACTICE Script Language Reference Guide | 6 1989-2021 Lauterbach GmbH Append to fileAppends data to a file. The file is created if it does not syntax of the command is similar to the PRINT : See also CLOSE MKTEMP OPEN WRITE Release Information in Release History BEEP Acoustic signalGenerates an acoustic signal on the host also Format:APPEND <file> <parameter_list>APPEND "Test"Format:BEEPPRACTICE Script Language Reference Guide | 7 1989-2021 Lauterbach GmbH CLOSE Close fileCloses an input or output : The path prefix ~~~ expands to the temporary directory of also APPEND OPEN READ WRITE WRITEB CONT inue Continue PRACTICE scriptA PRACTICE Script which has been stopped will be restarted at the current PRACTICE command.

6 PRACTICE scripts will be stopped by the STOP command or by a breakpoint within the Script . The CONT inue command can also be used to resume a Script that has been halted due to an error condition. The wrong command may be replaced by an interactive :CLOSE #<buffer_number>OPEN #1 ~~~ /Write ; open file for writingWRITE #1 "Test data" ; write data to fileCLOSE #1 ; close fileTYPE ~~~ ; optional: open file in TYPE windowFormat:CONT inue [[<line>] [<file>]]<line>Line number. Go till <line> in the active PRACTICE Script (*.cmm)., <file>Line number is omitted. Path and file name of PRACTICE Script . Go till first executable line in the PRACTICE Script <file>.<line> <file>Go till <line> in the PRACTICE Script <file>. PRACTICE Script Language Reference Guide | 8 1989-2021 Lauterbach GmbH Example 1: Example 2: See also END PBREAK STOP DECRYPT Decrypts a text or binary fileUses the original key string to decrypt a text or binary file previously encrypted with the ENCRYPT command.

7 The resulting file can get a new name or replace the old also ENCRYPT Encrypt/Execute Encrypted Files in PowerView User s Guide DO ; start Script ; Script stopped at breakpoint; ; stop Script by STOP command; continueFormat:DECRYPT <keystring> <encrypted_file> [<decrypted_file>] PRACTICE Script Language Reference Guide | 9 1989-2021 Lauterbach GmbH DO Start PRACTICE scriptStarts a PRACTICE Script (*.cmm). The DO command can be used on the command level to start a PRACTICE Script or within a Script to run another file like a subroutine. PRACTICE files started by a DO command should be terminated by the ENDDO command. Additional parameters may be defined which are passed to the subroutine. The subroutine reads the parameter list using the ENTRY the DO command even those settings saved by the STOre command can be retrieved. Examples: See also DODECRYPT ChDir END ENDDO ENTRY GLOBALON GOSUB JUMPTO ON PSTEP RePeaT RUN STOre Release Information in Release History Introduction to Script Language PRACTICE in Training Script Language PRACTICE Format:DO <file> [<parameter_list>]<file> The default extension for <file> is *.

8 Cmm. The default extension can be changed with the command PRACTICE .; store window setting to the PRACTICE file ' 'STOre Win; set up window setting by executing the Script ' 'DO ; Endless loop with subroutine call&count=1 WHILE TRUE() ( DO mem_test PRINT "MEMTEST " &count &count=&count+1) c:\sample\ ; change to c:\sample and execute the ; file Script Language Reference Guide | 10 1989-2021 Lauterbach GmbH DODECRYPT Execute encrypted PRACTICE Script (*.cmm)Executes a PRACTICE Script (*.cmm) that was encrypted with same key string by the command ENCRYPTDO. The key string is necessary for execution. The PRACTICE Script file stays also DO Encrypt/Execute Encrypted Files in PowerView User s Guide Format:DODECRYPT <keystring> <encrypted_file> [<parameter_list>] PRACTICE Script Language Reference Guide | 11 1989-2021 Lauterbach GmbH E.

9 FECHO Write text and data to an AREA window (with format decoration)[Examples]Writes the given arguments to the default AREA A000 or the selected AREA window. When writing to the default AREA A000, the written data is also shown in the trace32 message is the difference between the commands ..? Format:ECHO [{%<attribute>}] [{{%<format>} <data>}]<attribute>:AREA <area_name>CONT inueHOME<format>:<type>COLOR.<color>ERRORWARNING<type>:Ascii | BINary | Decimal | Hex | String<color>:NORMAL | BLACK | MAROON | GREEN | OLIVE | NAVY | PURPLETEAL | SILVER | GREY | RED | LIME | YELLOW | BLUE | FUCHSIAAQUA | WHITEECHO PRINT Writes all data decorated to indicate the format of the all data without any format decoration ( without the prefix 0x for hexadecimal numbers).For a comparison of the different outputs, see examples. <attribute>, <format>, descriptions of the command arguments, see Script Language Reference Guide | 12 1989-2021 Lauterbach GmbH ExamplesThe following table shows the output in a message area for the same data written with ECHO and PRINT:See also PRINT PRINTF SPRINTF Release Information in Release History <data>AREA output withECHOAREA output withPRINT0x0420x42 42%Hex 23%Decimal 0x1723.

10 230y1100110y00110011 110011%BINary 0x330y00110011 00110011'X''X' X%Ascii 0x58'X' X5==5 TRUE() TRUE5==3 FALSE() FALSE"text"text textP:0x001000P:0x1000 (1990.,10.,3,0,0,0) (23 * 47)0x439439 PRACTICE Script Language Reference Guide | 13 1989-2021 Lauterbach GmbH ELSE Conditional Script executionThe command or Script block following an ELSE statement will be executed, if the condition in the previous IF statement is : See also IF Format:ELSE [IF <condition>]IF Register(PC)== (main) PRINT "PC on start position"ELSE PRINT "PC not on start position"..IF Register(PC)== (main)( PRINT "PC on start position" STOP)ELSE IF Register(PC)== (end)( PRINT "PC on end position" STOP)ELSE( PRINT "PC neither on start nor on end position" PC main STOP) PRACTICE Script Language Reference Guide | 14 1989-2021 Lauterbach GmbH ENCRYPT Encrypt a text or binary fileEncrypts the contents of a text or binary file using the specified key string.