Show TOC

Creating and Executing a ScriptLocate this document in the navigation structure

Procedure

  1. To create a script, perform one of the following:

    • To start a new script, choose with the quick info text, Create Script.

    • If you start a new script, the editor automatically displays the Local Debugger Script Class, which you can manipulate and use as a template.

    • To use an existing script, choose Load Script. A dialog box appears.

      • Choose whether you want to load the script from the Database or from a Local File.

      • Enter the name of the script and choose Continue.

      Note

      By choosing with the quick info text Overview of the debugger scripts, you can use a library of reusable scripts that are divided into categories.

  2. In the Trigger screen area, you choose between the following:

    • Execute Directly

      The script runs immediately and is executed only once.

    • After Debugging Events.

      Select one of the following triggers:

      • Single Step in Debugger

        The script runs after each Debugger step.

      • Breakpoint Reached

        If you select this option, with the quick info text Change appears.

        You can choose it and create the triggering breakpoint in the Breakpoints tool that appears, or you can define the trigger statically in the script editor.

      • Watchpoint Reached

        If you select this option, with the quick info text Change appears.

        You must choose it and create the triggering watchpoint in the Breakpoints tool that appears, or you can define the trigger statically in the script editor.

  3. To save the script, choose between the following:

    • To save the script directly, choose with the quick info text Save.

    • To save the script under a different name, choose Save As.

      A dialog box appears.

  4. To execute the script, choose Start Script.

    One of the following situations will happen:

    • The program will stop in the debugger at a breakpoint or watchpoint that you have set or that your script has observed.

      In this case, you can use all of the features of the debugger freely to analyze the program that you are debugging. When you are ready, switch to the Script tab to continue or end the script.

    • The program will run to the end. Control will return to the screen from which you started the debugging session.

      In this case, you need to return control to the debugger session in order to end the script and display any traces it generated. To return control to the debugger, enter /h in the OK Code field in your present session. Press F3 ( Back) to return to the debugger on the Script screen. You will see the buttons for continuing or ending the script and for other tasks, such as displaying traces.