PRACTICE Script Language Reference Guide - Lauterbach

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 (*.)

2 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 (*.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.

3 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 (*.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

4 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 .. 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.

5 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.

6 , 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.

7 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.

8 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 .

9 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. 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 (*.)

10 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 *.