ASNA EXTERMIN8 PLUS Release 4.01

Transcription

1 ASNA EXTERMIN8 PLUS Release 4.01 User s Guide and Reference Manual

2 Information in this document is subject to change without notice. Names and data used in examples are fictitious unless otherwise noted. No component of EXTERMIN8 PLUS, including the software and the documentation may be reproduced, disassembled, transmitted, transcribed, stored in a retrieval system, or translated into any language in any form without the written permission of ASNA (Amalgamated Software of North America). Copyright ASNA - Amalgamated Software of North America. All rights reserved. Release 4.01 May, 2001 (Updated Preparing Programs and OPM Programs for Debugging on Page 10) Amalgamated Software of North America, Inc. UNITED STATES Blanco Road Suite 300 San Antonio, TX (210) (210) Fax UNITED KINGDOM 31 Frederick Sanger Road Surrey Research Park Guildford Surrey GU2 5YD United Kingdom Tel: (01483) International:

3 i Contents Chapter 1 - Introduction to EXTERMIN8 PLUS...1 The EXTERMIN8 PLUS Package... 2 Installing EXTERMIN8 PLUS... 2 What the Installation Will Do... 2 To Install from AS/400 Tape Media... 3 License Code... 3 Entering the License Code on the AS/ Removing EXTERMIN8 PLUS from the AS/ Documentation Included... 5 Accessing On-Line Help... 6 ASNA s Support... 6 Maintenance Support Programs... 7 Internet Access... 7 Chapter 2 - EXTERMIN8 PLUS Quick Start...9 Preparing Programs for Debugging...10 Preparing OPM Programs for Debugging OPM...10 EXTERMIN8 PLUS Quick Start...10 EXTERMIN8 PLUS Commands...11 Ending EXTERMIN8 PLUS...11 Chapter 3 - Comparison of EXTERMIN8 PLUS to EXTERMIN Major Differences...14 New Screen Layout...15 Resizing the Windows...15 Speed Menu...15 Breakpoints on Conditioned Lines...16 Chapter 4 - Using EXTERMIN8 PLUS...17 Starting a Debug Session...18 Preparing Programs to be Debugged...18 EXTERMIN8 PLUS Command Parameters...18 Program (PGM)...18 Job (JOB)...18 Update Production File (UPPROD)...19 Clear Log (CLRLOG)...19 Debugging OPM Programs (OPMPGM)...19 Debugging Linked Service Programs (SRVPGM)...19 The EXTERMIN8 PLUS Screen...19 The Status Bar...20 The Command Line...21 Actions...21 Object Types...22 The Window Title Bar...23 The Source Window...23 SEU Type Browse Commands...24

4 ii Function Keys within the Source Window...24 The Log Window...25 The Command Log File...25 Function Keys within the Log Window...25 The Watch Window...26 Function Keys within the Watch Window...26 The Help Window...27 Function Keys within the Help Window...28 Conditional Expressions...28 Example of a Conditional Expression...29 Chapter 5 - Advanced Debugging Features...31 Debugging Jobs that are Currently Executing...32 Debugging OPM Programs...32 Debugging Linked Service Programs...32 Debugging a Batch Job that is Not Yet Running...32 Automatic Watches...34 Debugging Service Programs...35 Chapter 6 - Debugging Function Keys...37 Common Function Keys to ALL of EXTERMIN8 PLUS...38 ROLLUP/ROLLDN - Roll Keys...38 TAB - Tab Key...38 F1/Help - Help Key...38 F3 - Exit EXTERMIN8 PLUS Window...38 F5 - Display Current Location...39 F6 - Display Speed Menu...39 F11 - Single Step Execution...40 F12 - Resume Execution...42 F13 - Display Window List...42 F14 - Focus To Next Window...43 F23 - Step Over...43 F24 - Step Out...43 Command Line Function Keys...44 F4 - Prompt a Command...44 F9 - Retrieve a Prior Command...44 F16 - Find a String in Active Window...44 F17 - Top of Active Window...45 F18 - Bottom of Active Window...45 F19 - Show Left of Active Window...45 F20 - Show Right of Active Window...45 Function Keys available to ALL EXTERMIN8 PLUS Windows...46 F2 - Resize Window...46 F16 - Find a String...47 F17 - Top of Source...47 F18 - Bottom of Source...47 F19 - Show Left of Source...48 F20 - Show Right of Source...48 Source Window Function Keys...48 F4 - Prompt a Variable Change...48 F6 - Display Source Window Speed Browser Menu...49 F7 - Find Top of Structure...50 F8 - Find End of Structure...50 F9 - Retrieve Variable or Program Source...50

5 Contents iii F9 - Retrieve Program Source (RPG Only)...51 F9 - Retrieve Program Source (COBOL Only)...52 F10 - Add/Remove Breakpoint...52 F21 - Run To...53 F22 - Add/Remove Breakpoints up to Cursor Position...53 Log Window Function Keys...54 F6 - Display Log Window Speed Menu...54 F9 - Retrieve a Command...55 Watch Window Function Keys...55 F6 - Display Watch Window Speed Menu...55 Help Window Function Keys...56 F6 - Display Help Window Speed Menu...56 F7 - Go Backward...56 F8 - Go Forward...57 F9 - Retrieve Link Topic...57 Chapter 7 - Debugging Commands...59 Priority of Operators...60 AB - Add Breakpoint...62 AE - Add Expression to be Monitored...64 AM - Add Module (ILE Only)...64 AP - Add Program...64 AW - Add Watch...65 B - Bottom...65 CB - Change Breakpoint...65 CC - Change Contents...66 CE - Change Expression to be Monitored...67 CO - Change Occurrence (RPG Only)...67 CS - Change Source Views...67 D@ - (RPG Only)...68 D@ - Display Calling Stack (COBOL Only)...68 DB - Display Breakpoint...68 DC - Display Contents...69 DE - Display Expression to be Monitored...70 DI - Display Indicators...70 DL - Display List (RPG Only)...71 DM - Display Module...71 DN - Show/Hide/Reset a window or All Windows...72 DO - Display Occurrence (RPG Only)...72 DP - Display Program...72 DW - Display Watch...73 F - Find...73 FT - Find Type (RPG Only)...73 FT - Find Type (COBOL Only)...74 FU - Find SEU Related Object...74 LB - List Breakpoints...74 LE - List Expression to be Monitored...75 LF - List Files...75 LK - List Constants...76

6 iv LM - List Modules...76 LP - List Programs...77 LR - List SubRoutines...77 LS - List Source Views...78 LV - List Variable...79 LW - List Watch...79 RB - Remove Breakpoint...80 RE - Remove Expression to be Monitored...80 RP - Remove Program...81 RW - Remove Watch...81 SA - Set Attributes...81 T - Top...84 OS/400 Command Processor...84 Appendix A - Error Messages...85 Appendix B - Quick Reference...87 EXTERMIN8 PLUS Function Keys...88 EXTERMIN8 PLUS Commands...89 Index...91

7 1 C H A P T E R 1 Introduction to EXTERMIN8 PLUS EXTERMIN8 PLUS is truly an interactive source level debugger that allows access to RPG, COBOL, and CL programs to quickly find those subtle bugs. It can: Stop execution at predefined breakpoints. Invoke single step execution. Monitor for specified conditions. Display and modify fields and indicators. Provide context-sensitive help through the Speed Browser menu option. EXTERMIN8 PLUS, as a source level debugger, opens the door to debug OPM RPG, OPM CL and ILE RPG, ILE CL and OPM Cobol and ILE Cobol program(s) interactively through commands issued against the source statements. For instance, to stop the execution of a program at a particular statement (breakpoint), simply position the cursor at that statement and press F10. The statement is underlined directly on the source to display that the execution will stop at that statement. When a breakpoint is reached during the execution of any program in the debug mode, the source of that program is shown, and the statement is highlighted. A particular variable, record, or Data Structure, may be displayed or modified by positioning the cursor on the name of the item in the source and processing a single command key. EXTERMIN8 PLUS is very simple to use. The most commonly used commands are executed by function keys. Merely point the cursor and press the appropriate function key. The function keys are window sensitive, and some perform different functions, depending on what window the cursor is in. EXTERMIN8 PLUS is very simple to learn - one command and four function keys provide the basic requirements to debug any program. The strength of EXTERMIN8 PLUS is in its extensive set of features, detailed in chapters 5 and 6, that allows the explanation of debugging skills. EXTERMIN8 PLUS is a tool used to get closer to the programs, thereby increasing productivity and satisfaction when debugging or modifying a program. Contents EXTERMIN8 PLUS Package Installing EXTERMIN8 PLUS License Code Removing EXTERMIN8 PLUS Documentation Included ASNA s Support

8 2 EXTERMIN8 PLUS The EXTERMIN8 PLUS Package The EXTERMIN8 PLUS software package contains the following items: The EXTERMIN8 PLUS product on AS/400 media. EXTERMIN8 PLUS User s Guide. EXTERMIN8 PLUS requires an IBM AS/400 running the OS/400 operating System Version 3, Release 7 or higher. Users must have *USE authority to the OS/400 debug commands STRDBG, ENDDBG, STRSRVJOB, and ENDSRVJOB. Note: When upgrading to a new release of OS/400, be sure to contact ASNA Technical Support, (210) , to ensure that your current release of EXTERMIN8 PLUS will run properly with the new Operating System. Review your License Agreement for the privileges available from Maintenance. Installing EXTERMIN8 PLUS EXTERMIN8 PLUS is shipped on AS/400 media. If you receive media incompatible with your System please contact your Sales Representative and request the correct media. The AS/400 section of the installation only has to be done once for each AS/400 the product is being installed on. What the Installation Will Do Note: Before upgrading a new release of IBM's operating System (OS/400), please check with ASNA that your current release of EXTERMIN8 PLUS is compatible with the new OS/400 release. The installation procedure is now in two parts: 1. Restore the temporary library, ILETEMP onto the AS/400 either directly from AS/400 media or an APPC link. 2. Run a command on the AS/400 that will: Restore the library EXT8LE from the temporary library onto the System. Request a License Code to validate operation of the product. Note: You must ensure that no one is using EXTERMIN8 PLUS prior to and during the installation process.

9 To Install from AS/400 Tape Media Chapter 1 Introduction 3 Note: You must ensure that no one is using EXTERMIN8 PLUS prior to and during the installation process. The installation process has two steps. 1. The first step is to restore a temporary installation library and can be done by anyone with *USER authority or higher. 2. The second step does the actual installation and initialization of the product, and requires *SECOFR authority to run it. To Install from As/400 Tape Media 1. Load the Installation tape. Enter the following command to restore the install program to the ILETEMP library: RSTLIB ILETEMP Tap01 where TAP01 refers to the device name from which the object will be restored. If an alternative tape drive is being used, enter the appropriate device name. Once the library is restored, sign onto the AS/400 with *SECOFR authority and execute the following command: ILETEMP/LODILE Once the installation is completed, the ILETEMP library is automatically deleted. License Code Before EXTERMIN8 PLUS may be used on any AS/400, a valid license code, issued by ASNA, must be entered. For new trials, this code will be sent with the product if the machine serial number and model type are known at the time of shipping. The code issued with a trial of EXTERMIN8 PLUS will license, or register the product to be used on a specified machine up to a specified date. If it is required to move the product onto another machine, upgrade the model type, or extend the trial period, please contact your Distributor or ASNA for a new license code. Once the product has been purchased, a new license code will be issued to register the product on a permanent basis. This code will be based on either unlimited users, or on a per-user basis. Entering the License Code on the AS/400 A new license code is entered, or a current license can be viewed or changed by using the product s Registration Assistant program. When installing the product for the first time, or when an upgrade is installed, the Registration Assistant screen is displayed with the bottom of the screen displaying whether the current License Code is valid or not. If the License Code is valid, press F3 to continue. If not, call ASNA or your Distributor to get a new License Code. Note: You can not use the product without a proper License Code.

10 4 EXTERMIN8 PLUS To Display the Current License Code, or Enter a New License Code 1. If you are not already at the Registration Assistant Screen, enter the following: a. ADDLIBLE LIB(EXT8LE) POSITION(*FIRST) b. EXT8LE/REGISTER The following screen will display: 2. Enter or verify the information as detailed below. System Name The name of the AS/400 will automatically display. Model The model of the AS/400 will automatically display. Serial Number The serial number of the AS/400 will automatically display. License Key For a new license, enter the 16-digit license code acquired from ASNA exactly as it is given. License Type License Type specifies if the licensing is for an individual machine, or for the entire company. To license, or register the current machine, use *MACH, which is the default. To license, or register the entire company, enter *SITE. Customer Name The name of the user that was entered when the product was installed will automatically display. However, you can change this name as needed. Note: The customer name is case-sensitive and must match the customers name exactly as ASNA's account shows. Company Name The name of the company that was entered when the product was installed will automatically display. However, you can change this name as needed. Note: If you are entering a Site License, the name of the company must be spelled exactly as determined by you and ASNA. This name is also case-sensitive, so capitalization must match exactly.

11 Chapter 1 Introduction 5 Start Date The Start Date specifies if the product has been purchased, in which you have a Permanent code, or if the product is a Trial, which is only valid for a specified period. If the product has been purchased, use *PERM, which is the default. For a Trial of the product, enter the starting date in the format MM/DD/YYYY. Expiration Date The Expiration Date indicates the date in which the license code will expire. If the product has been purchased, use *PERM, which is the default. For a Trial of the product, enter the ending date of the trial as specified by ASNA in the format MM/DD/YYYY. User Count User Count specifies the number of concurrent users that can access the product, as a peruser-basis, or as unlimited. For unlimited users, use *UNLIM, which is the default. For a specified number of users, enter the user count as a positive integer. 3. Acceptance of a valid licensing code is confirmed at the bottom of the screen. Press F3 to continue. If the message The License is Invalid displays, recheck all entries. If no errors were made in any of the entries, call ASNA or your National Distributor for further assistance. Removing EXTERMIN8 PLUS from the AS/400 To Remove EXTERMIN8 PLUS from the AS/ Delete the library EXT8LE and any commands that may have been copied to other libraries such as QSYS or QGPL. DLTLIB EXT8LE Documentation Included The documentation for EXTERMIN8 PLUS is designed to help you quickly learn and reference any aspect of the program. The documentation included is listed below: Documentation ASNA EXTERMIN8 PLUS User s Guide On-Line Help Description A guide to using EXTERMIN8 PLUS. On-Line help for EXTERMIN8 PLUS. This file contains a reference list of the function keys and commands available in EXTERMIN8 PLUS.

12 6 EXTERMIN8 PLUS Accessing On-Line Help ASNA s Support ASNA EXTERMIN8 PLUS includes On-Line help. On-Line help is "on-the-screen" documentation that provides a quick, convenient way to look up information about a task you wish to perform. To Access On-Line Help 1. Put the cursor in the desired window in which you want information on. 2. Press either the Help button or F1 key. 3. The help file will open. Use the ScrlUp/ScrlDown keys to find the topic you wish. 4. Put the cursor over the desired function key (it will be underlined) and press the F9 key to go to the desired topic. Press F7 to go back to the previous screen, or press F8 to go to the topic you previously viewed. ASNA provides a selection of high-quality, free and fee-based support options that make it easier for you to fully utilize ASNA products. Following are the types of Support available at this time. However, the types of Support are subject to change. Web site: ASNA has a site on the World Wide Web, with our Home Page accessible via This site includes general information on all ASNA products as well as in-depth information such as white papers, seminar schedules, feature lists, customer comments, and technical literature. Keep checking for bi-weekly updates! NewsGroup: Access ASNA s NewsGroup on the Web site to ask questions and receive detailed answers from ASNA or other users. Select the NewsGroup topic from ASNA s Home Page. Downloading Latest Product Builds: You can download the latest Product builds from our FTP site, as long as you are a registered user, since a password is required. The download procedure is available on the Web site, or contact ASNA for the download procedure. Ask questions and receive detailed answers from the Sales or Technical Support Departments. Just send electronic mail to the accounts listed below. You will receive a reply by . Sales Sales@asna.com Technical Support Support@asna.com Fax: You can fax questions or comments to ASNA. Just send a fax to one of the numbers listed below. You will receive a reply by fax. Technical Support Sales/Marketing USA (210) (210) UK (+44) Telephone: Once you have obtained a Support Program, you can reach Technical Support in the USA at (210) between the hours of 8:00 am to 6:00 p.m. Central Time, Monday through Friday, excluding holidays. Some programs provide a toll-free number which you may use. You can reach Technical Support in the UK at (01483) between the hours of 9:00 am to 5:00 p.m. Monday through Friday, excluding holidays.

13 Chapter 1 Introduction 7 Before you call, have you Checked the Web site for the latest information? Checked the On-Line Help? Checked the latest EXTERMIN8 PLUS User s Guide? When you call... Please be at your computer, have your documentation in hand, and be prepared to provide the following information. Account number. EXTERMIN8 PLUS Registration Number. Product and product version. The type of computer hardware you are using. What you were doing when the problem occurred. Error number, or exact wording of any messages on your screen. How you tried to solve the problem. Maintenance Support Programs ASNA s Introductory Support ASNA s Pay-Per-Incident Technical Support Distributor Technical Support Please contact ASNA for more information and prices for these programs. UNITED STATES Blanco Road Suite 300 San Antonio, TX (210) (210) Fax UNITED KINGDOM 31 Frederick Sanger Road Surrey Research Park Guildford Surrey GU2 5YD United Kingdom Tel: (01483) International: Internet Access ASNA now has a site on the World Wide Web, with our home page accessible via The site includes information on ASNA products, as well as a link to NewsGroups where visitors can post questions to ASNA Technical Staff or other ASNA customers. Some of the features ASNA s Web site includes are: Site Guide - a guide to assist visitors with their tour of ASNA products. Overview of ASNA products - a brief look at each ASNA product. Product sections - detailed information about each ASNA product. What s New - quick access to new information on ASNA s Web site. Case studies - reports on applications that have been developed by companies using ASNA s Visual RPG. Visual RPG On-Line Help files - the place to find answers to your Visual RPG questions and learn more about the product.

14 8 EXTERMIN8 PLUS Tips and Techniques - helpful hints for using ASNA s products, with special emphasis on Visual RPG. Troubleshooting - solutions to issues you may encounter while using Visual RPG. Frequently Asked Questions - answers to questions about using ASNA Visual RPG. Seminars - the latest information on ASNA Visual RPG seminar dates, locations and cost. ASNA NewsGroup - the opportunity to submit questions and receive answers about any ASNA product. Feedback - the opportunity to ASNA with your comments and questions. Download files - download product demos, upgrades and beta versions directly from the site. Check for bi-weekly updates!

15 9 C H A P T E R 2 EXTERMIN8 PLUS Quick Start This chapter is designed to provide a simple and quick guide to using EXTERMIN8 PLUS. A full description of all the available options is provided in the following chapters of this Manual. Contents Preparing Programs for Debugging EXTERMIN8 PLUS Quick Start EXTERMIN8 PLUS commands from the OS/400 Command Line Ending EXTERMIN8 PLUS

16 10 EXTERMIN8 PLUS Preparing Programs for Debugging When creating a module for debugging, you must specify the types of debugging views you want available while using EXTERMIN8 PLUS. There are four types of views that can be specified. The four views are: *LIST Enables the Listing View *SOURCE Enables the Source View *COPY Enables the Copy View *STMT Enables the Statement View You must at least specify the Source View when creating the module. For example: CRTRPGMOD DBGVIEW(*SOURCE) will generate the source view in the module. The views are then listed (LS) and changed (CS) within the program. See CS and LS commands in chapter 7 for more information. Note: For Cobol ILE, there is no *COPY, so if you want to use Copy and embedded SQL statements, you must specify *LIST. Preparing OPM Programs for Debugging OPM With the new release of Extermin8P 4.01 the OPM programs DO NOT need to be recompiled with special views to be debugged. However *LSTDBG must be specified in the Source listing options to debug OPM Cobol or RPG programs having COPY statements or embedded SQL statements. Note: *SRCDBG and *LSTDBG cannot be specified together on the CRTRPGPGM command. EXTERMIN8 PLUS Quick Start This section is included for those programmers who want to gain an overview of the product and begin using it quickly. It will teach you one command and four function keys that are needed to get started. Before starting, be sure that the user has *USE authority to the command STRDBG, ENDDBG, STRSRVJOB, and ENDSRVJOB. Note: Programs must be compiled with the *SOURCE option before they can be debugged. The principle of debugging from an AS/400 terminal is that as you start EXTERMIN8 PLUS, you specify the programs that you want to debug (up to 10). Programs can be added later if necessary, but the start command does require at least one program to be specified. Enter on the OS/400 Main Menu command line: EXT8LE/STRXT8LE library-name/program-name The source of the first program specified will be displayed on the upper portion of the screen. The EXTERMIN8 PLUS screen consists of 4 sections: Status Bar, displayed at the very top. Command Line. Above the source window is the window title bar. Source, log and watch windows (help window will only be opened when the F1/help key is pressed). The user can scroll through the displayed source and set breakpoints as required by placing the cursor on the line where execution is required to stop and press F10.

17 Chapter 2 Quick Start 11 Note: Execution will stop BEFORE this line is executed. It is recommended that when first using EXTERMIN8 PLUS, to set a breakpoint at the beginning of the program in code that you are sure is going to be executed. Breakpoints can be set in other programs at this time or when execution has stopped at a breakpoint in the first program. When at least one breakpoint has been set, the program to be debugged can be executed by leaving the EXTERMIN8 PLUS window and starting the execution of the program. Press F12 to exit EXTERMIN8 PLUS, then Enter a CALL statement on the OS/400 command line or select a menu option: The program called could be the one in debug or the first program in the call stack. Normal execution will continue until the breakpoint is reached. There is no need for the preceding program(s) to be in debug mode. Once the breakpoint has been reached the following can be done: To display the contents of a variable, position the cursor on the variable name in the displayed source file listing and press F9. To change the contents of a variable, place the cursor on the variable name and press F4. To set another breakpoint, place the cursor on the required line and press F10. To execute the line currently stopped on and then stop before the next line press F11. To continue execution to the next breakpoint press F12. These are the basic debugging commands. There are, of course, many other function keys described in chapter 5 and commands that are described in chapter 6. EXTERMIN8 PLUS Commands EXTERMIN8 PLUS has three commands that may be entered from the OS/400 command line: STRXT8LE ENDXT8LE DSPXT8LE Start EXTERMIN8 PLUS. End EXTERMIN8 PLUS. Display EXTERMIN8 PLUS. Ending EXTERMIN8 PLUS To End a Debug Session 1. Press F3 to exit the EXTERMIN8 PLUS window. 2. Enter ENDXT8LE on the OS/400 command line to end the EXTERMIN8 PLUS debug session.

18 12 EXTERMIN8 PLUS This Page Intentionally Left Blank

19 13 C H A P T E R 3 Comparison of EXTERMIN8 PLUS to EXTERMIN8 This chapter is intended to help programmers who have used previous versions of ASNA EXTERMIN8 (old program model). It explains the differences between the current version of EXTERMIN8 and the current EXTERMIN8 PLUS release. Contents Major Differences between EXTERMIN8 and EXTERMIN8 PLUS New Screen Layout Resizing the Windows Speed Menu Breakpoints on Conditioned Lines

20 14 EXTERMIN8 PLUS Major Differences The following differences exist between EXTERMIN8 PLUS and EXTERMIN8. The function keys are window sensitive. Not all function keys work in every window, or function the same from window to window. See chapter 5 for a complete listing of function key by window. Press F14 to move from window to window. The Active window is the window where the cursor is, and will be denoted when the title bar, or name of the window is highlighted. The Help window will display information for all windows, function keys, and commands. The help for each window contains Links or jumps to the function keys available for that window. You can also jump to a list of commands from the command line help. A Watch window has been added that displays the values of selected variables and indicators. To add a variable to the watch window, either use the command AW or position the cursor on the variable name in the source window, press F6 to show the Speed Browser menu and select option 7. See below for more information on the Speed Browser menu. Note: Watches are currently not available for CL programs. However, they will be available in a future release. The Command Line and Status Bar are now at the top of the EXTERMIN8 screen. Using F2, the three default windows (source, log, window) that make up the EXTERMIN8 screen can be sized to personal preferences and can overlap each other. Some function keys have changed function. In particular, F6 now gives a pop-up menu of the most commonly used functions. F12 will no longer start the program to be debugged. Initialization of this program must be done by either calling it directly or starting it from another program or menu. The advantage of this over the existing version of EXTERMIN8 is that the menu or program can already be running when EXTERMIN8 is started. Programs must be re-compiled with special compiler options before they can be debugged. Breakpoints are added and displayed by source line number as opposed to SEU Line number. No longer have to step into a subroutine in order to step out of the subroutine. A new command, SA LINE {ON/OFF}, displays the line numbers referenced by the breakpoints. It can be used instead of, or in addition to SEU numbers. The default is to not show line numbers. To display the line numbers enter the command: SA LINE ON To hide the line numbers enter the command: SA LINE OFF

21 Chapter 3 Comparison to EXTERMIN8 15 New Screen Layout The EXTERMIN8 PLUS screen is shown below: Status Bar Command Line Window Title Bar Source Window Log Window Watch Window Resizing the Windows The status bar and command line are now located at the top of the screen. The new watch window is located at the bottom right of the screen. F2 activates the command keys for resizing the active window. A series of function key options will blink across the top of the EXTERMIN8 PLUS screen. See chapter 5 for a detailed discussion of the F2 options. Speed Menu Press F6 to display the Speed Menu for the active window. The options available will depend on the location of the cursor or the mode you are in. The following is the Speed Menu for the source window. See chapter 5 for detailed information of the Speed Menu for each window.

22 16 EXTERMIN8 PLUS Breakpoints on Conditioned Lines Setting a breakpoint on a line that has conditional indicators will cause execution to stop if the indicators are True. This behavior is similar to the *INMATCH option of EXTERMIN8.

23 17 C H A P T E R 4 Using EXTERMIN8 PLUS This chapter explains the functions of using the EXTERMIN8 PLUS Debugger. It will present a general overview of the screen and window formats, function keys for each window, operation modes and command syntax. Chapters 6 and 7 provide a detailed reference for all function keys and commands. Contents Starting a Debug Session Preparing Programs to be Debugged EXTERMIN8 PLUS Command Parameters The EXTERMIN8 PLUS Screen Actions and Object Types Window Title Bar Source Window and Function Keys Log Window and Function Keys Watch Window and Function Keys Help Window and Function Keys Conditional Expressions

24 18 EXTERMIN8 PLUS Starting a Debug Session User must have *USE authority to the commands STRDBG, ENDDBG, STRSRVJOB, and ENDSRVJOB. To Start a Debug Session 1. On the OS/400 command line enter: EXT8LE/STRXT8LE library_name/program_name Preparing Programs to be Debugged Once the STRXT8LE command has been entered, the EXTERMIN8 PLUS main screen will be displayed with a message across the bottom stating Preparing Program xxxxxx where xxxxxx is the name of each of the programs given on the STRXT8LE command. This process may take a few seconds since it is necessary for EXTERMIN8 PLUS to scan the source and build certain look up tables before any processing can take place. The length of time this can take depends on the size and complexity of the programs to be debugged. Once the preparation is complete, EXTERMIN8 PLUS will display the first 16 lines of source for the first program given on the STRXT8LE command. EXTERMIN8 PLUS Command Parameters If the command STRXT8LE is entered on the command line or within a CL program, the following format of the keywords is required. The default parameters are underlined. STRXT8LE PGM(lib/pgm lib/pgm) + JOB(number/user/name) + MODS(*ALL or List) (For ILE only) UPDPROD(*NO or *YES) + CLRLOG(*NO or *YES) + OPMPGM (*NO or *YES) + (EXTERMIN8 PLUS only) SRVPGM (*NO or *YES) + (EXTERMIN8 PLUS only) Program (PGM) PGM is a list of up to 10 programs that will be debugged during the EXTERMIN8 PLUS session. At least one program name must be given. Programs may be qualified by library name. If the library name is not specified, then the library list will be searched. Further programs can be added during the EXTERMIN8 PLUS session (up to a maximum of 10). There is no need to specify programs that will run but not be debugged during the EXTERMIN8 PLUS session. Job (JOB) JOB is the Job to be serviced. If omitted, EXTERMIN8 PLUS assumes the current Job (i.e., interactive session) is to be used. The Job number, user, and name may be found using option 5 of either the WRKACTJOB command (Job must be running) or the WRKSBMJOB (if the Job is still in the JOBQ). Modules to be Loaded (MODS) - For ILE only MODS allows you to choose up to 20 modules on the command line that can be bound together in the program(s) to be loaded. Only those module(s) selected will be loaded into Extermin8 Plus. A special value of *ALL (default) loads all the modules bound in the program.

25 Chapter 4 Using EXTERMIN8 PLUS 19 Update Production File (UPPROD) Clear Log (CLRLOG) UPPROD defines whether or not if the programs running during this debug session may update files within production libraries. The options are *YES or *NO; the default is *NO. If *YES is chosen, keep in mind that all production files can be updated. CLRLOG defines whether or not to clear the log file before starting EXTERMIN8 PLUS. The options are *YES or *NO; the default is *YES. If *NO is chosen, the log file is not cleared. Debugging OPM Programs (OPMPGM) For machines V3R7 and up, OPM s can be added to debug using EXTERMIN8 PLUS. This is done with the following command: The options are *YES or *NO; the default is *YES. Debugging Linked Service Programs (SRVPGM) All Service Programs linked to a program can be automatically added to the debug session. The options are *YES or *NO; the default is *YES. The EXTERMIN8 PLUS Screen The EXTERMIN8 PLUS screen, as shown below, consists of the following: Status Bar Command Line Window Title Bar Source Window Log Window Watch Window The Status Bar is located at the very top of the screen and displays the status messages, program name, module name, and current mode. The Command Line is used to enter debug commands, source browsing commands and standard OS/400 commands. It is located directly below the Status bar. The Window title bar located at the top of the source window displays the column, line, and SEU number. When the title bar is highlighted, this means that the window is the active or current window. The Source window (center, larger window) is used to display and browse program source code. The Log window (bottom left window) is used to log the EXTERMIN8 PLUS commands entered and display their output. The Watch window (bottom right window) lists the variables whose values you want to be automatically displayed at each and every breakpoint. If you have not added any variables to the Watch List yet, the Watch variable window is blank.

26 20 EXTERMIN8 PLUS The status bar and command line always remain in the same location and can not be moved. The EXTERMIN8 windows (source, log, and watch and help) can be moved, enlarged or resized by pressing F2. The location in which the cursor is placed is considered the active window. To move from window to window, simply use your arrow keys to move the cursor from one window to another, or press F14 to give focus to the next window. The help window for the active window will display when the F1/help key is pressed. See chapter 5 for a complete listing of function keys available in the help window. Any command entered affects the entire session. For instance, if you are in the source window and add a breakpoint, the log window will change to reflect the added breakpoint. The Status Bar The status bar, located at the top of the screen, has three fields that indicate the current status of EXTERMIN8 PLUS: PGM: Mod: Mode: Displays the name of the currently selected program. Any EXTERMIN8 PLUS commands that are program-oriented will be applied to this program. Displays the name of the currently selected module. Any EXTERMIN8 PLUS commands that are module-oriented will be applied to this module. Shows the current mode of the EXTERMIN8 PLUS session. (In the example above, BREAK is the current mode of this EXTERMIN8 PLUS session.) The following modes are possible. BREAK: The module has stopped at a breakpoint. EXCEP: MONTR: PRESRV: SETUP: STEP: RUN: HELP: WINDOW: An exception to the program being debugged has occurred. The module has stopped because the condition being monitored has been met. The batch job being debugged (serviced) is not yet active. This is the entry mode. When this status is shown, no programs/modules are currently running. The module is running in single step mode. The module is currently executing. This mode will display when the help window is the active window. This mode allows you to move or change the dimensions of the SOURCE, LOG, WATCH, or HELP windows.

27 The Command Line Chapter 4 Using EXTERMIN8 PLUS 21 The command line is used to enter debug commands, source browse commands and standard OS/400 commands. It is directly under the status bar. Command Line EXTERMIN8 PLUS debug commands must be entered on the command line. Any output from these commands is displayed in the log or watch windows. All commands are explained in detail in chapter 6. Program-oriented commands will always refer to the currently selected program, i.e., the one shown in the status bar. Module-oriented commands will always refer to the currently selected module, i.e., the one shown in the status bar. Any entry on the command line that is not recognized as an EXTERMIN8 PLUS command will be passed to the OS/400 command processor. The general syntax of any EXTERMIN8 PLUS command is: XY -options (condition) parameters where: XY X Y XY is a mnemonic command where: is the first letter of an action and is the first letter of an object type on which the action will be performed. For example, the command DC represents Display Contents, and AW represents Add Watch. Options (Condition) Parameters Any options that follow a command are introduced with a dash and each letter represents one option. For instance, -s may mean to show the source. Not all commands allow options. The conditional expression, where valid. Parentheses must surround the condition. The parameters follow the options and are separated by blanks. Not all commands require parameters. Actions Actions used by EXTERMIN8 PLUS are: Action Valid Objects A Add B, E, P, W C Change B, C, E D B, C, E, L, M, P, R, U, W F Find T, U or string L List B, E, F, L, M, P, R, S, W R Remove B, E, P, W S Set A / OS/400 Command The letters after each action are the valid object types for that action.

28 22 EXTERMIN8 PLUS Object A B C E F L M P S T U V W at location - This object is used with the Display action to show the name of the currently stopped module and the next line to be executed. Attribute - Allows the individual user to Set various personal global attributes for debugging sessions that are stored under the user profile name within the EXT8LE library. Breakpoint - The point at which the module will stop executing and return control to EXTERMIN8 PLUS. Module execution stops before the breakpoint statement is executed. The value of selected fields, structures, and indicators can be automatically displayed when breakpoints are reached. A breakpoint can be defined by either the source line/statement number or a subroutine name. Optionally, a conditional expression can be attached to the breakpoint so that execution will only stop at the breakpoint if the condition is true. breakpoints may also be added or removed from within the source window by placing the cursor on the required source line and pressing F10. Contents - Displays the contents of any field, indicator, record or data structure, including multiple occurrence data structures. The user may also Change the contents of any type of data element or structure. Expression to be monitored - Expressions to be monitored for a specified condition to be true. The execution of the module will stop immediately after the statement that caused the condition to be satisfied. Applicable actions: Add, Change, Display, List, and Remove the expression. File - Refers to the files being used by the programs being debugged. The user can List the Files used by the programs and optionally show the record format names. List - Refers to a named Parameter List (PLIST) or Key List (KLIST) in the current RPG program. Applicable action: Display the contents of a List. Module - Refers to either the current module or a named module depending on the action. Applicable actions: Display or List modules from the active debug list. Program - Refers to either the current program or a named program depending on the action. Applicable actions: Add, List, and Remove programs from the active debug list, and Display the source of a program. Source View - Refers to the view selected when the module was created using the CRTRPGMOD command. The source view can be Copy, Listing, or source. Applicable action: List the source view selected. Type - Finds the first source line of the given Type within the displayed source. SEU Related Object - Refers to a SEU number or SEU member. Applicable actions: Displays the SEU number or member named as a parameter, or Finds the SEU number or member named as a parameter. Variable - Lists all variable names declared for the currently selected module. Watch - A list of field names, indicators and/or structures, the contents of which will be displayed whenever the execution of the module is interrupted by either reaching a breakpoint, single stepping or satisfying a monitor condition.

29 Chapter 4 Using EXTERMIN8 PLUS 23 The user can Add, Display, List and Remove names from the list to be displayed. The output from any command is displayed in either the log or watch window. If the window is not large enough to display the complete result, use the Roll Up key or change the size of the window to view the complete reply. Also use the roll keys to view earlier commands and their replies. The command line will also accept all OS/400 and user commands. To use an OS/400 command that has the same name as an EXTERMIN8 PLUS one, precede the command with a / (forward slash). The Window Title Bar The window title bar at the top of the source window contains: Source Col Line Seu View Note: Name of the window. First source column displayed in the window. First source line displayed in the window. Shows the position of the current SEU being displayed. Shows the current view name. The available views are: *COPY, *LIST, *SOURCE, and *STMT. Line numbers are always displayed in whole numbers. SEU numbers are always displayed in decimal format. The Source Window The Source window is used to display and browse source code. From the source window, you can easily add breakpoints, display the contents of variables, step to the next executable statement or quickly scan the source. By default, source lines that have a breakpoint applied to them are shown underlined, and the line where execution has stopped is shown highlighted. All other lines are displayed in normal mode.

30 24 EXTERMIN8 PLUS SEU Type Browse Commands The following commands may be entered to browse the source being displayed. (nn in the following commands means any number may be entered). F string Find String: Search for a string in the source file. T Top: Display the beginning of the source member. B Bottom: Display the end of the source member. Wnn Window: Show column nn of the source member in column 1 of the screen. nn Display line nn on row 1 of the screen. +n Move display up n lines. -n Move display down n lines. Note: All entries must be made on the command line. Unlike SEU, EXTERMIN8 PLUS does not accept commands on the left hand side of the source window. Function Keys within the Source Window ROLLUP/DN TAB F1/Help F2 F3 F4 F5 F6 F7 F8 F9 F10 Scrolls forward or backward a full window. Moves the cursor to the command line. Displays the help documentation for the source window. Allows you to move, size or hide the source window. Exits the EXTERMIN8 PLUS window. Displays the current contents of a variable and prompts for a new value. Displays the source of the interrupted module with the current breakpoint instruction at the top of the source window regardless of what was previously displayed. Displays a pop-up menu for the source window. Finds the top of an RPG structure (IF, ELSE, DO, etc.) from the position of the cursor in the source window. Finds the end of the RPG structure (IF, ELSE, DO, etc.) from the position of the cursor. With the cursor positioned on EXSR, CAS or CALL statements in the source window, F9 retrieves and displays the source code of the subroutine or called program. With the cursor positioned on a variable or a constant, F9 will display the contents. Sets a breakpoint or removes an existing breakpoint on the line where the cursor has been positioned in the source window. F11* Executes only the single statement where the module is currently stopped. F12* Resumes execution of the currently stopped module. F13 F14 F16 F17 Displays a pop-up window allowing you to either show the user screen or show or hide a selected window(s). Gives focus to the next window. While in any window, press F14 to take you to the next open window. Searches the source window for the character string keyed on the command line, or repeats the prior search if the command line is blank. Shows the top of the source member.

31 Chapter 4 Using EXTERMIN8 PLUS 25 F18 F19 F20 F21 F22 Shows the bottom of the source member. Shows left of the source member. Shows right of the source member. Sets a temporary breakpoint and resumes execution. Adds or removes breakpoints on ALL executable statements between the statement where F10 was last used to add or remove a breakpoint and the current cursor position. F23* Steps over a subroutine. F24* Steps out of a subroutine. * - When in SETUP mode, this function key will take you back to the OS/400 command line. The Log Window The log window is used to record the EXTERMIN8 PLUS commands entered and display the results of those commands. At the top of the log window the window title bar is highlighted when it is the active window. The Command Log File Everything that is shown in the log window is recorded in the command log file for the user. This log file is an OS\400 *USRSPC (user space). The EXTERMIN8 PLUS default is to allocate a user space in the library EXT8LE with the same name as the user profile. This allocation is done automatically the first time the user runs the STRXT8LE command. A different log can be used by changing the options using the SA command. Note: If the requested log file is in use by another EXTERMIN8 PLUS session, a new temporary log file will be created in QTEMP. The command log is cleared at the beginning of a debug session. Function Keys within the Log Window The following function keys are available when the cursor is positioned in the log window. ROLLUP/DN TAB F1/Help F2 F3 F5 F6 Scrolls forward or backward a full window. Moves the cursor to the command line. Displays the help documentation for the log window. Allows you to move, size or hide the log window. Exits the EXTERMIN8 PLUS window. Displays the source of the interrupted module with the current breakpoint instruction at the top of the source window regardless of what was previously displayed. Displays a pop-up menu for the log window.

32 26 EXTERMIN8 PLUS F9 With the cursor positioned on the command line, each instance of F9 will retrieve the most recently executed command until the beginning of the log file is reached. F11* Executes only the single statement where the module is currently stopped. F12* Resumes execution of the currently stopped module. F13 F14 F16 F17 F18 F19 F20 Displays a pop-up window allowing you to either show the user screen or show or hide a selected window(s). Gives focus to the next window. While in any window, press F14 to take you to the next open window. Searches the log window for the character string keyed on the command line, or repeats the prior search if the command line is blank. Shows top of log window. Shows bottom of log window. Shows left of log window. Shows right of log window. F23* Steps over a subroutine. F24* Steps out of a subroutine. * - When in SETUP mode, this function key will take you back to the OS/400 command line. The Watch Window The Watch window lists the variables whose values you want to be automatically displayed at each and every breakpoint. If you have not added any variables to the Watch List yet, the Watch variable window is blank. The window title bar is highlighted when it is the active window. Every breakpoint reached will update the current values for all the variables in the watch window. If you wish to add or remove a watch to or from the Watch list, select AW or RW at the command line. Function Keys within the Watch Window The following function keys are available when the cursor is positioned in the watch window. ROLLUP/DN TAB F1/Help F2 F3 Scrolls forward or backward a full window. Moves the cursor to the command line. Displays the help documentation for the watch window. Allows you to move, size or hide the watch window. Exits the EXTERMIN8 PLUS window.

33 Chapter 4 Using EXTERMIN8 PLUS 27 F5 Displays the source of the interrupted module with the current breakpoint instruction at the top of the source window regardless of what was previously displayed. F6 Displays a pop-up menu for the watch window. F11* Executes only the single statement where the module is currently stopped. F12* Resumes execution of the currently stopped module. F13 Displays a pop-up window allowing you to either show the user screen or show or hide a selected window(s). F14 Gives focus to the next window. While in any window press F14 to take you to the next open window. F16 Searches the Watch window for the character string keyed on the command line, or repeats the prior search if the command line is blank. F17 Shows top of watch window. F18 Shows bottom of watch window. F19 Shows left of watch window. F20 Show right of watch window. F23* Steps over a subroutine. F24* Steps out of a subroutine. * - When in SETUP mode, this function key will take you back to the OS/400 command line. The Help Window The help window is used to display the documentation for the window in which the cursor is positioned, or the active window. Pressing the F1 key will display information of the active window, followed by a list of function keys that are available in that window. The function keys are underlined, denoting that they are context-sensitive, so when the cursor is on a function key and F9 is pressed, information will display for the selected function key.

34 28 EXTERMIN8 PLUS Function Keys within the Help Window The following function keys are available when the cursor is positioned in the help window. ROLLUP /DN TAB F1/Help F2 F3 F5 F6 F7 F8 F9 Scrolls forward or backward a full window. Moves the cursor to the command line. Displays documentation on the help window. Allows you to move, size or hide the help window. Exits EXTERMIN8 PLUS. Displays the source of the interrupted module with the current breakpoint instruction at the top of the source window regardless of what was previously displayed. Displays a pop-up menu for the help window. Goes to the next help topic. Goes to the previous help topic. Retrieves the help documentation for the selected function key, or link. F11* Executes only the single statement where the module is currently stopped. F12* Closes the help window. F13 F14 F16 F17 F18 F19 F20 Displays a pop-up window allowing you to either show the user screen or show or hide a selected window(s). Gives focus to the next window. While in any window, press F14 to take you to the next open window. Searches the help window for the character string keyed on the command line, or repeats the prior search if the command line is blank. Shows top of help window. Shows bottom of help window Shows left of help window. Shows right of help window. F23* Steps over a subroutine. F24* Steps out of a subroutine. * - When in SETUP mode, this function key will take you back to the OS/400 command line. Conditional Expressions Monitors and breakpoints may be controlled by conditional expressions, so that the module will stop only when the expression is true. Conditional expressions are made up of variables, literals, constants, relational and logical operators surrounded by parentheses. Literals are defined within apostrophes. The valid logical operators are: Operator Meaning *AND AND & Logical AND *OR OR Logical OR and the relational operators are:

35 Operator Meaning Chapter 4 Using EXTERMIN8 PLUS 29 *EQ EQ = Equal *GT GT > Greater Than *LT LT < Less Than *GE GE >= Greater than or Equal *LE LE <= Less than or Equal *NE NE Ø= Not Equal *NG NG Ø> Not Greater than *NL NL Ø< Not Less than Expression evaluation is dependent on the order and type of operators in the expression. Parentheses may be used to change the order of expression evaluation. The following table shows the priority of all the operators used in expressions, including negative constants. Priority Operator 1 Negative constants 2 *GT, *LT, *EQ, *GE, *LE, *NE, *NG, *NL 3 AND 4 *OR A priority of 1 is the highest priority (negative constants are evaluated first); a priority of 4 is the lowest (OR relationships are evaluated last). When operators with different priority levels appear in an expression, operations are performed according to priorities. When operators of the same priority appear in an expression, operations are performed from left to right within the expression. Parentheses can be used to control the order in which operations are performed. The value of a parenthetical expression is determined from the innermost level to the outermost, following the priorities stated above within matching sets of parentheses. Example of a Conditional Expression >AB 173 ((DUE>0 BAL>LIMIT) & CR= B ) The above statement will set a breakpoint on line 173 of the current module with the following conditions: If the account is overdue (DUE > 0), or If the balance is greater than the credit limit (BAL > LIMIT), and A credit extension was asked for (CR = 'B') If this condition becomes true, the execution of the module will stop at statement 173.

36 30 EXTERMIN8 PLUS This Page Intentionally Left Blank

37 31 C H A P T E R 5 Advanced Debugging Features This chapter describes some of the advanced debugging features of EXTERMIN8 PLUS, including how to debug batch jobs and other users interactive jobs. Contents Debugging Jobs that are Currently Executing Debugging OPM Programs Debugging Linked Service Programs Debugging a Batch Job that is not yet Running Automatic Watches

38 32 EXTERMIN8 PLUS Debugging Jobs that are Currently Executing If the job that is running the program(s) to be debugged is currently active, simply start EXTERMIN8 PLUS with the STRXT8LE command giving the specific job information as the JOB parameter. This job can either be another interactive session or a job that is running in a Batch Pool. Example: STRXT8LE PGM(makemedia/shipdetail) JOB(016789/TA/DSP74) EXTERMIN8 PLUS will display the source of the first program given on the command. At this point the command window indicates SETUP mode even if the program is currently running. Only the debugging commands valid in SETUP mode may be used at this time. For example, breakpoints can be added, but a monitor cannot be added, nor can the contents of any field be displayed. Once stopped in BREAK mode, all debug commands and function keys can be used, including F12 to resume execution. Note: When requesting ENDXT8LE, the serviced job will automatically be ended. If the job being serviced is another session, then: The user s screen will be frozen while EXTERMIN8 PLUS has the program stopped. F13 is not allowed while servicing a job. A message will be issued starting "user screen not valid with service job" if F13 is pressed. Debugging OPM Programs For machines V3R7 and up, OPM s can be added to debug using EXTERMIN8 PLUS. This is done with the following command: 1. Start EXTERMIN8 PLUS with the following STRXT8LE command. STRXT8LE OPMPGM (*YES) PGM (library/opmpgmname) Debugging Linked Service Programs All Service Programs linked to a program can be automatically added to the debug session. This is done with the following command: 1. Start EXTERMIN8 PLUS with the following STRXT8LE command. STRXT8LE SRVPGM (*YES) PGM (library/opmpgmname) Note: Any Service program starting with the letter Q is considered IBM s Service program and no attempt will be made to add these to the debug session. The default is *NO if you do not want to add Service programs to debug. Debugging a Batch Job that is Not Yet Running Breakpoints may be set in a batch program before it starts executing. This is done by the following steps: 1. Hold the job on the job queue - use the SBMJOB command with the HOLD(*YES) parameter. Example: SBMJOB CMD(CALL PGM(library/program)) Hold(*YES) or - hold the Job queue and then submit the job. 2. Record the job number, user, and name. This is displayed at the bottom of the screen after submitting the job, or may be obtained by running the WRKSBMJOB command and using option 5 to work with the job to be debugged.

39 Chapter 5 Advanced Debugging Features Start EXTERMIN8 PLUS with the STRXT8LE command giving details of the program and the job. Example: STRXT8LE PGM(library/program) JOB(nnnn/user/name) 4. This will display the first program s source. EXTERMIN8 PLUS is now in PRSRV (pre-service) mode, and will remain in this mode until the serviced job becomes active. In this mode, no debug commands or functions may be entered. 5. The message "Job: number/user/job is being serviced in this session" and "Service Job is not active" will be issued in the log window if EXTERMIN8 PLUS found the job on hold, as seen on the screen below. If the messages do not appear, check the Job Description entered on the STRXT8LE command, and try the command again. 6. Press F12 to go to the AS/400 command line. Use the WRKSBMJOB command to release the job or WRKJOBQ command to release the Job queue. Do not press any keys until the "start service job" screen appears. 7. The OS/400 Start Serviced Job screen will then be displayed. 8. Press F10 to display the OS/400 command screen.

40 34 EXTERMIN8 PLUS 9. On the command line enter EXT8LE/DSPXT8LE. This command will redisplay the EXTERMIN8 PLUS screen. 10. EXTERMIN8 PLUS is in SETUP mode and all commands that are valid for SETUP mode may be used. Note that the job, and thus the program has not started running yet, so breakpoints can be set to stop execution anywhere in the program. 11. To start the job, press F12, which will display the OS/400 command screen. 12. Press F12 again and the Start Serviced Job screen will be displayed. 13. Press ENTER and the job will then start executing. The screen prior to releasing the job will be displayed until the batch program reaches one of the previously set breakpoints. The EXTERMIN8 PLUS screen will then be displayed in BREAK mode. 14. The program may now be debugged using all EXTERMIN8 PLUS functions and commands. Note: When F3 is used to exit EXTERMIN8 PLUS window, the batch job will end. Automatic Watches This is an advanced debugging feature that whenever a program stops due to a break, step or monitor, Factor 1, Factor 2 and resulting indicator on that line will automatically be displayed in the watch window. If the user has added some watches, there will be a line separating the user watches and automatic watches. You can specify the position or order in which the watches will be displayed in the watch window. The position of the automatic watches can be changed by using the SA command Automatic Watch option. The position of the watches can be changed at any time, and the change will be reflected immediately. The options for Automatic Watch are:

41 Chapter 5 Advanced Debugging Features 35 A = The automatic watches will display after the user watches in the watch window. B = The automatic watches will display before the user watches in the watch window. N = No automatic watch will display. The following displays an example of an automatic and user watch in the watch window. Stopped Line Factor 1 Automatic Watch Automatic Watch User Watch Note: This feature is only available to ILE and OPM RPG programs in the current version. Debugging Service Programs Service program names can not be given at the command line with the STRXT8LE command. Only after entering the Extermin8 for ILE screen can users use the AP - Add program *SRVPGM command to add service programs to the debug session.

42 36 EXTERMIN8 PLUS This Page Intentionally Left Blank

43 37 C H A P T E R 6 Debugging Function Keys Most EXTERMIN8 PLUS actions can be initiated with function keys. Function keys are cursor, or window sensitive and only provide the desired results if you are in the proper window prior to selecting the function key. This chapter divides the function keys into each location and window within EXTERMIN8 PLUS in which they can be used. Contents Common Function Keys to all of EXTERMIN8 PLUS Command Line Function Keys Function Keys available to all EXTERMIN8 PLUS Windows Source Window Function Keys Log Window Function Keys Watch Window Function Keys Help Window Function Keys

44 38 EXTERMIN8 PLUS Common Function Keys to ALL of EXTERMIN8 PLUS The following function keys operate exactly the same anywhere within EXTERMIN8 PLUS. This includes the command line, help window, log window, source window, and watch window. ROLLUP/ROLLDN - Roll Keys Cursor On: Modes: RollUp/RollDn rolls the text up or down a full window. Anywhere ALL None TAB - Tab Key Cursor On: Modes: Tab moves the cursor to the command line from the active window. Anywhere ALL None F1/Help - Help Key Comments: Cursor On: Modes: F1 or HELP displays the EXTERMIN8 PLUS help documentation for the active window. The first screen displayed is a quick cross reference of available commands and an index for the main help topics. To view a specific topic, simply enter the required line number. The help text is in the source member RPG_HELP in the source file HELP in the library EXTERMIN8. This member may be edited to add text relevant to the user s own installation. Please be aware that new releases of EXTERMIN8 PLUS will replace the HELP text, so if any changes are made, it is advisable to keep a back up, either off line or in another library. Since this is the same as displaying any other source member, all browse functions and commands are available, as are all debugging commands. Use the F12 key to exit from the HELP screen. Anywhere ALL None F3 - Exit EXTERMIN8 PLUS Window Cursor On: Mode: F3 will close the EXTERMIN8 PLUS window and end the execution of the debug program if not servicing a job, otherwise, all breakpoints and watches will be removed. To exit the EXTERMIN8 PLUS program, ENDXT8LE must be entered on the OS/400 command line. Anywhere BREAK, STEP, SETUP None

45 Chapter 6 Debugging Function Keys 39 F5 - Display Current Location Cursor On: Mode: F5 displays the source of the interrupted module with the current breakpoint instruction at the top of the source window, regardless of what was previously displayed. The cursor moves to the breakpoint line. Anywhere BREAK STEP Not available in SETUP, PRSRV, RUN modes. D@ F6 - Display Speed Menu F6 displays a Speed Menu for the active window. This menu will vary according to the window the cursor was in and provides a fast way of doing common tasks. The following is an example of the Speed Menu for the source window. At the prompt, type in the appropriate number on the menu (1-9). The following actions are possible: 1. Help Displays the online help text. 2. Find Displays a pop-up window containing search criteria for a list of objects. Enter the string to find and change the options to Match the Case or Search Down as needed. Press F12 to cancel. 3. toggle Line numbers 4. toggle Nesting levels 5. toggle SEU numbers Allows you to toggle the display of line numbers. Allows you to toggle the display of nesting levels of structures within RPG programs. Allows you to toggle the display of SEU line numbers.

46 40 EXTERMIN8 PLUS 6. find first C- spec Moves the cursor to the first C-spec. 7. Watch When the cursor is set on a variable name, this option adds that variable to the watch list. 8. Break Displays the ADD/CHANGE BREAKPOINT dialog box, with the breakpoint position option displaying the line the cursor is on. You may change this breakpoint position if desired before pressing ENTER to complete the action. Cursor On: Mode: 9. break with Vars Anywhere ALL None Displays the ADD/CHANGE BREAKPOINT dialog box, with the breakpoint position and variable options prefilled according to the position the cursor is on. F1 F10 F22 AB AW DB F LB RB RW F11 - Single Step Execution F11 either executes only the single statement where the module is currently stopped, or takes you back to the OS/400 command line. From there, you can call a program to be debugged. When in BREAK or STEP Mode, F11 executes only the single statement where the module is currently stopped. Optionally, each statement executed via single stepping may be logged, as well as automatically single step through a module without user intervention. The next statement to be executed is shown in high intensity. The window title bar displays the column and line numbers and the next SEU number to be executed. The execution of the module must be restarted by F11, F12, F23, or F24. When the next statement to be executed is a CALL and F11 is pressed, the called module will be stopped at the first statement in the called program, no matter if you are in debug mode or not. If the program is not in debug mode, the source will not be displayed and the line numbers of the program will be logged in the log window. When in SETUP Mode, F11 takes you back to the OS/400 command line. From there, you can CALL a program to be debugged. RPG Only When the next RPG statement to be executed is an EXSR operation, F11 will single step into the subroutine. This may be avoided by pressing F23 to step over the subroutine; i.e., the subroutine will be executed and the module stopped at the statement immediately following the EXSR statement. When stepping through a subroutine, F24 will step out of the subroutine; i.e., complete the execution of the subroutine without stopping. Execution stops at the statement immediately following the EXSR statement.

47 Chapter 6 Debugging Function Keys 41 COBOL Only When the next statement to be executed is a PERFORM operation, F11 will Single Step into the PERFORM paragraph. This may be avoided by pressing F23 to step over the PERFORM paragraph; i.e., the PERFORM paragraph will be executed and the program stopped at the statement immediately following the PERFORM statement. When stepping through a PERFORM, F24 will step out of the PERFORM; i.e., complete the execution of the PERFORM without stopping. Execution stops at the statement immediately following the PERFORM statement. Note: F23 and F24 are only available if the option to maintain the PERFORM call stack was set to Y when the program was put in debug mode. See Chapter 2 for further information. Single step execution performs faster when the number of statements to be viewed through Single Stepping is given to EXTERMIN8 when executing the F11 function key. When at a breakpoint, key the number of statements to Single Step onto the command line and press the F11 key. Note: Be aware that when using this statement count feature, it does not follow logic of the program. If a GO TO or PERFORM statement directs the program to a statement outside the selected group, then Single Step will behave as F12, continue execution of program. Since a number of statements can exist in a single COBOL statement line, Single Stepping may not appear to advance to the next line of code. Automated Single Stepping Automated single stepping executes one statement at a time without halting for user intervention. As each statement is executed, the source is displayed in the source window, highlighting the next statement to be executed. This is the equivalent to repeatedly pressing the F11 key approximately once each second. It is recommend this option be used in conjunction with the logging feature of the Set Attributes command, SA STEP LOG, so that a record is maintained of the statements executed. Optionally, set the range for automated single stepping by positioning the cursor in the first statement in the range. Using the Add Breakpoint command, AB, set a breakpoint to the last statement in the range. If no range is desired, automatic single stepping will continue until a previously set breakpoint is reached, the module terminates, or the module is interrupted. Use the Set Attributes command to initiate automatic stepping. SA STEP GO Start automated stepping by pressing F11. If a previously set breakpoint is reached, automated stepping will stop. To resume automated stepping, press F11 again. If stepping to observe the progress of the module being executed, the GO option on the SA BREAK command may prove useful. If this attribute is set and F11 is pressed, execution will continue when a breakpoint is reached. Cursor On: Mode: Anywhere SETUP BREAK STEP None F12 F23 F24

48 42 EXTERMIN8 PLUS F12 - Resume Execution Cursor On: Mode: F12 will resume execution of the currently stopped program, or exit Extermin8 PLUS window in setup mode. When in SETUP mode, F12 will take you back to the OS/400 command line. From there you can CALL a program to be debugged. When in BREAK or STEP mode, F12 will resume the execution of the stopped program at the SEU number shown in the window title bar. The program will continue until it reaches the next breakpoint of the program. When in HELP mode, F12 will cancel the help display and return to the previously displayed source. Anywhere ALL None F11 F23 F24 F13 - Display Window List F13 displays a pop-up window that allows you to either show the user screen (Option 1) or show or hide a selected window (Options 2-5). If a user screen has not been displayed during the execution of the programs within EXTERMIN8 PLUS, the EXTERMIN8 PLUS SETUP screen will be re-displayed. Press ENTER to return to the current EXTERMIN8 PLUS display. Option 1 - User Screen The last interactive user screen will display before control was returned to EXTERMIN8 PLUS. This display may not be modified in any way. Pressing ENTER or any function key when viewing the redisplayed screen will return to the current EXTERMIN8 PLUS display. Options 2-5 The corresponding window will either be shown or hidden. If a window is bolded, it is currently shown. Cursor On: Mode: Anywhere All Modes except WINDOW None Selecting a window that is bolded, or shown, will then hide that window, until that window number is selected again.

49 F14 - Focus To Next Window Cursor On: Mode: Chapter 6 Debugging Function Keys 43 F14 will allow you to give focus to the next window. While in any window, press the F14 key to take you to the next open window. You can repeat this action to keep moving to the next window. Anywhere SETUP BREAK STEP None F2 F23 - Step Over F24 - Step Out Cursor On: Mode: Cursor On: Mode: When single stepping through a program and stopped at an RPG EXSR or COBOL Perform or CAS operation, F23 steps over the RPG subroutine or COLBOL Paragraph. The RPG Subroutine or COBOL Paragraph will execute without stopping. EXTERMIN8 PLUS will stop the program again at the statement following the RPG EXSR or COBOL Perform or CAS statement. If a defined breakpoint exists in the RPG Subroutine or COBOL Paragraph, execution will stop at that breakpoint. If F23 is pressed on any statement other than RPG CALL, RPG EXSR or COBOL Perform or CAS, it is treated as F11 to Single Step. When in SETUP Mode, F23 will take you back to the OS/400 command line. From there, you can CALL a program to be debugged. Anywhere BREAK STEP None F11 F12 F21 F24 When Single Stepping in a subroutine, F24 will step out of the subroutine. The subroutine will complete executing without stopping. Execution of the program stops at the statement immediately following the EXSR or CAS statement that called the subroutine. Program execution will stop at any breakpoints in the subroutine beyond where F24 was pressed. When in SETUP Mode, F24 will take you back to the OS/400 command line. From there, you can CALL a program to be debugged. Anywhere STEP RPG programs only. F11 F12 F23

50 44 EXTERMIN8 PLUS Command Line Function Keys F4 - Prompt a Command Cursor On: Mode: F4 displays the prompt for an OS/400 command. With the OS/400 command keyed and the cursor on the command line, press F4, and the OS/400 prompt screen for the command will be displayed. Command Line ALL None. However, if the OS/400 command word is the same as an EXTERMIN8 PLUS command, precede the command with a forward slash (/). F9 - Retrieve a Prior Command Cursor On: Mode: F9 retrieves previously entered commands from either the command line or log window. With the cursor positioned on the command line, F9 retrieves the last command entered and copies it to the command line. Each successive time F9 is pressed, the next previously entered command is retrieved to the command line. The command may now be edited and executed. Command Line ALL None DP (called program) F16 - Find a String in Active Window F16 searches the active window for the character string keyed on the command line, or repeats the prior search if the command line is blank. To find a character string within the source that is currently displayed, key the required string on the command line and press F16. The search begins with the first line displayed in the source window. Note: The search is case sensitive, so it must be keyed exactly how you expect to find it in the source. Embedded blanks are acceptable, so there is no need to surround the string with apostrophes. When the string has been found, the cursor is positioned at the beginning of the string in the source window. If the string is not originally displayed in the current window, the source line containing the string will be on the second line of the window. Press F16 again to find the next occurrence of the string. If no string is given on the command line, the last entered string is searched for again, even if that string was entered using the F command. If the cursor is moved after the string was found, the next F16 will begin searching for the string from the next line of code displayed in the source window. Once the string is not found, a message Not Found will display in the log window.

51 Chapter 6 Debugging Function Keys 45 Cursor On: Mode: Command Line ALL None F F17 - Top of Active Window Cursor On: Mode: F17 displays the first entries in the active window. The function key is processed as if the cursor had been in the top left of the active window or command line, Row 1 Col 1. Command Line ALL None T F18 F18 - Bottom of Active Window Cursor On: Mode: F18 displays the last entries of the active window. The function key is processed as if the cursor had been in the bottom left of the active window or command line. Command Line ALL None B F17 F19 - Show Left of Active Window Cursor On: Mode: F19 displays the left side of the active window. The function key is processed as if the cursor had been in the top left of the active window. Command Line ALL Only allowed when the cursor is positioned in the command line. F20 F20 - Show Right of Active Window Cursor On: Mode: F20 displays the right side of the active window. If F20 is pressed while the SEU numbers are displayed, the numbers will remain on the left side of the screen. The function key is processed as if the cursor had been in the top right of the active window. Command Line ALL Only allowed when the cursor is positioned in the source window or command line. F19

52 46 EXTERMIN8 PLUS Function Keys available to ALL EXTERMIN8 PLUS Windows F2 - Resize Window F2 allows you to move or change the dimensions of the source, log, watch or help window. Position the cursor in the window you want to alter. Press the F2 key to activate the WINDOW mode. The status bar will display the six function key options available, which are described below. F2 (Expand Restore ) F3 (Hide) F5 (Reset) F6 (Move Top Left) F7 (Size Top Left) F8 (Bottom Right) Expands the window to the full size of the screen. To maximize the size of the selected window, press F2. To restore the active window s original size, press F2 again. Hides a window. Press F13 to restore window. Press F5 to reset the selected window back to its default size. Moves the top left corner of the window to the current cursor position. To move the active window, position the cursor on the top left of the new location you want the window to be moved to and press F6. The window will remain the same size, but will be relocated. Resizes the active window from the top. Place the cursor on the top left location of the new size you want the window to be and press F7. The bottom and right edge of the window will remain in their original positions. Resizes the active window from the bottom. To resize the active window from its bottom, place the cursor on the bottom right location of the new size you want the window to be and press F8. The top and left edge of the window will remain in their original positions. If F8 is pressed when the cursor is at the top left position of an active window, the cursor will jump to the bottom right position. This will save time when resizing a window from its bottom. Note: A moved or resized window will not appear beyond the edge of the original screen. Its size will be adjusted to accommodate the available screen size. Cursor On: Mode: Any Window WINDOW None F14

53 F16 - Find a String Chapter 6 Debugging Function Keys 47 F16 searches the source, log, watch, or help window for the character string keyed on the command line, or repeats the prior search if the command line is blank. To find a character string within the source that is currently displayed, key the required string on the command line and press F16. The search begins with the first line displayed in the active window. Note: The search is case sensitive so it must be keyed exactly how you expect to find it in the source. Embedded blanks are acceptable, so there is no need to surround the string with apostrophes. Cursor On: Mode: When the string has been found, the cursor is positioned at the beginning of the string. If the string is not originally displayed in the current window, the source line containing the string will be on the second line of the window. Once the string is not found, a message Not Found will display in the log window. Any Window ALL None F F17 - Top of Source Cursor On: Mode: F18 - Bottom of Source Cursor On: Mode: F17 displays the first entries in the active window. The function key is processed as if the cursor had been in the top left of the active window or command line, Row 1 Col 1. Any Window ALL None T F18 F18 displays the last entries of either the source, log, watch or help window. Any Window ALL None B F17

54 48 EXTERMIN8 PLUS F19 - Show Left of Source F19 displays the left side of either the source, log, watch or help window.. Cursor On: Mode: Any Window ALL Only allowed when the cursor is positioned in the source window or command line. F20 F20 - Show Right of Source F20 displays the right side of either the source, log, watch or help window.. Cursor On: Mode: Any Window ALL Only allowed when the cursor is positioned in the source window or command line. F19 Source Window Function Keys F4 - Prompt a Variable Change F4 displays the current contents of a variable and prompts for a new value. Position the cursor on a variable name in the source window and press F4. A pop-up window displays the current contents of the variable and allows the contents to be modified. The complete contents of a data structure, list, table, etc., will be displayed formatted by the field name. Use the roll keys to move the display up or down. To change the variable, enter the new value over the existing display, then press ENTER to accept the change. Cursor On: Mode: Source Window BREAK STEP MONTR None CC

55 F6 - Display Source Window Speed Browser Menu Chapter 6 Debugging Function Keys 49 F6 displays a Speed Menu for the source window. This menu provides a fast way of doing common tasks and is context-sensitive to the location of the cursor. At the prompt, type in the appropriate number seen on the menu (1-9). The following actions are possible: 1. Help Displays the online help text. 2. Find Displays a pop-up window containing search criteria for a string. Enter the string to find and change the options to match the case or search down as needed. Press F12 to cancel. 3. toggle Line numbers 4. toggle Nesting levels 5. toggle SEU numbers 6. find first C- spec Allows you to toggle the display of line numbers. Allows you to toggle the display of nesting levels of structures within RPG programs. Allows you to toggle the display of SEU line numbers. Moves the cursor to the first C-spec. 7. Watch When the cursor is set on a variable name, this option adds that variable to the watch list. 8. Break Displays the ADD/CHANGE BREAKPOINT dialog box, with the breakpoint position option displaying the line the cursor is on. You may change this breakpoint position if desired before pressing ENTER to complete the action.

56 50 EXTERMIN8 PLUS Cursor On: Mode: 9. break with Vars Source Window ALL None Displays the ADD/CHANGE BREAKPOINT dialog box, with the breakpoint position and variable options prefilled according to the position the cursor is on. F1 F10 F22 AB AW DB F LB RB RW F7 - Find Top of Structure Cursor On: Mode: F8 - Find End of Structure Cursor On: Mode: F7 finds the top of an RPG structure (IF, ELSE, DO, etc.) from the position of the cursor in the source window. Position the cursor on a line within a structure and press F7. The cursor and display then moves to the first statement of the current structure. Source Window ALL Only valid with RPG programs F8 F8 finds the end of the RPG structure (IF, ELSE, DO, etc.) from the position of the cursor. Position the cursor on a line within a structure and press F8. The display and cursor then moves to the END statement of the current structure. Source Window ALL Only valid with RPG programs F9 - Retrieve Variable or Program Source F7 F9 either retrieves and displays the contents of the variable or constants with the cursor positioned on a variable name in the source window, or with the cursor positioned on GOTO, EXSR, CAS or CALL statements in the source window, F9 retrieves and displays the source code of the subroutine or called program. Only source code of programs that are in debug mode may be displayed. The current contents of the variable, including data structure, list, array, constants, etc., will be displayed in a pop-up window. Use the roll keys to move the display up or down. The contents of the variable may not be changed. Press F12 to return to the source window.

57 Chapter 6 Debugging Function Keys 51 Cursor On: Mode: Source Window BREAK STEP None DC F9 - Retrieve Program Source (RPG Only) To retrieve the source of a tag, position the cursor on the GOTO statement and press F9. EXTERMIN8 PLUS will display the source of the tag in the source window. To retrieve the source of a subroutine, position the cursor on the CAS, EXSR statement and press F9. EXTERMIN8 PLUS will display the source of the subroutine in the source window. Cursor On: Mode: To retrieve the source of a called program, position the cursor in the name of the member on the CALL statement line and press F9. The called program must be in debug mode. Source Window ALL

58 52 EXTERMIN8 PLUS The source being displayed must be a program in debug mode. DP (called program) F9 - Retrieve Program Source (COBOL Only) With the cursor positioned on PERFORM, COPY or CALL statements in the Browse window, F9 retrieves and displays the source code of the paragraph or called program. Only source members of programs that are in debug mode may be displayed. To retrieve the source of a Paragraph, position the cursor on the paragraph name in the PERFORM statement and press F9. EXTERMIN8 will display the source of the paragraph in the Browse window. To retrieve the source of a COPY book statement, position the cursor in the name of the member on the COPY statement line and press F9. All EXTERMIN8 debugging commands and function keys are valid for the displayed Copybook under the same rules as apply to the main program. F9 may be used on any COPY statement except the type Format 2 used in the Data Division to copy external file definitions. To retrieve the source of a called program, place the cursor on the program name in the CALL statement. The called program must be in debug mode. To re-display the source containing the COPY or CALL statement, use the Display program command (DP), or if stopped at a breakpoint, use F5 to return to the current breakpoint. Mode: All The source being displayed must be of a program in debug mode. DP (called program) F10 - Add/Remove Breakpoint F10 sets a breakpoint or removes an existing breakpoint on the line where the cursor has been positioned in the source window. Positioning the cursor on a non-executable statement before pressing F10 will affect the next executable statement in the source code. To set a breakpoint, position the cursor on the line of source where execution of the module is to stop, and press F10. The default is to distinguish breakpoints by underlining the statement in the source window. This default may be changed using the EXTERMIN8 PLUS Attributes Screen. If the contents of one or more variables are to be displayed when the breakpoint is reached, key the field name(s) on the command line before pressing F10. If the same variable(s) are to be displayed on all breakpoints, use the Add Watch command, AW, to define them. If a conditional breakpoint is to be set, type in the condition(s) on the command line prior to pressing F10. Whenever a breakpoint is reached in a module, execution is stopped prior to executing the statement. With the EXTERMIN8 PLUS default options, the current breakpoint is shown in high intensity, and the status bar displays the module name. The execution of the module must be restarted at a breakpoint by using either F11, F12, F23, or F24.

59 Chapter 6 Debugging Function Keys 53 To remove an existing breakpoint, position the cursor on the breakpoint to be removed and press F10. To remove all breakpoints, use the Remove Breakpoint command, RB, with the *ALL parameter. F21 - Run To Cursor On: Mode: Cursor On: Mode: To add or remove a range of breakpoints, use F10 at the beginning of the range and F22 at the end. The Add Breakpoint command, AB, may also be used to set ranges. The Remove Breakpoint command, RB, may also be used to remove ranges. Source Window ALL None F6 F21 F22 F23 F24 AB AW DB LB RB F21 will set a temporary breakpoint on the line where the cursor has been positioned in the source window, then start or continue the execution of the pgm. To set a temporary breakpoint, position the cursor on the line of source where the execution of the program is to stop, and press F21. The default is to distinguish breakpoints by underlining the statement in the source window. Once the breakpoint has been reached, it will be removed, therefore, execution of the program will no longer stop at the statement. If you place the cursor on a non-executable statement (e.g. TAG or BEGSR) and press F21, then the temporary breakpoint will be allocated to the next executable statement in the source code. F21 cannot be used to set a conditional breakpoint. The Add Breakpoint command AB or F10 must be used to do this. See chapter 6. If F21 is pressed in SETUP mode, will set the breakpoint and then exit the Extermin8 PLUS window so the program can be called. Whenever a breakpoint is reached while running the program, the execution of the program is stopped after the preceding statement. With the EXTERMIN8 default options, the current breakpoint, (i.e. the next statement to be executed) is shown in high intensity, and the status bar shows the program name and the SEU line number of the breakpoint. The execution of the program must be restarted at a breakpoint by either another F21, F11, or F12. Source Window ALL None F10 F22 AB AW DB LB RB F22 - Add/Remove Breakpoints up to Cursor Position F22 adds or removes breakpoints on ALL executable statements between the statement where F10 was last used to add or remove a breakpoint and the current cursor position. If the last use of F10 set a breakpoint, F22 will set breakpoints on ALL executable statements between the current cursor position and the statement where that breakpoint was set. If the last use of F10 removed a breakpoint, F22 will remove ALL breakpoints between the current cursor position and the statement where that breakpoint was removed.

60 54 EXTERMIN8 PLUS Cursor On: Mode: Source Window ALL The last breakpoint set by F10 must be in the same source view as is currently being displayed. F6 F10 AB DB LB RB Log Window Function Keys F6 - Display Log Window Speed Menu F6 displays the Speed Menu for the log window. This menu provides a fast way of doing common tasks and is context-sensitive to the cursor location. At the prompt, type in the appropriate number on the menu (1-2). The following actions are possible: 1. Help Displays the online help text for the log window. 2. Find Displays a pop-up window containing search criteria for a string, as displayed below. Cursor On: Mode: Log Window ALL None Enter the string to find and change the options to match the case or search down as needed. Press F12 to cancel. F1 F10 F22 AB AW DB F LB RB RW

61 F9 - Retrieve a Command Cursor On: Mode: Chapter 6 Debugging Function Keys 55 F9 retrieves previously entered commands from the log window. With the cursor positioned on a previously entered command displayed in the log window, F9 retrieves that command and copies it to the command line. The command may now be edited and executed. Log Window ALL None DP (called program) Watch Window Function Keys F6 - Display Watch Window Speed Menu F6 displays the Speed Menu for the watch window. This menu provides a fast way of doing common tasks and is context-sensitive to the cursor location. At the prompt, type in the appropriate number on the menu (1-2). The following actions are possible: 1. Help Displays the online help text for the watch window. 2. Find Displays a pop-up window containing search criteria for a string, as displayed below. Cursor On: Mode: Watch Window ALL None Enter the string to find and change the options to match the case or search down as needed. Press F12 to cancel. F1 F10 F22 AB AW DB F LB RB RW

62 56 EXTERMIN8 PLUS Help Window Function Keys F6 - Display Help Window Speed Menu F6 displays the Speed Menu for the help window. This menu provides a fast way of doing common tasks and is context-sensitive to the cursor location. At the prompt, type in the appropriate number on the menu (1-2). The following actions are possible: 1. Help Displays the online help text for the help window. 2. Find Displays a pop-up window containing search criteria for a string, as displayed below. Cursor On: Mode: Help Window ALL None Enter the string to find and change the options to match the case or search down as needed. Press F12 to cancel. F1 F10 F22 AB AW DB F LB RB RW F7 - Go Backward Cursor On: Mode: F7 goes back to the previous help topic. F7 is only valid if you have selected a link topic by pressing the F9 key. Help Window HELP F8 F9

63 F8 - Go Forward Cursor On: Mode: Chapter 6 Debugging Function Keys 57 F8 goes forward to a help topic previously selected. F8 is only valid if you have selected a link topic by pressing the F9 key. Help Window HELP F7 F9 F9 - Retrieve Link Topic Cursor On: Mode: F9 retrieves the help contents of the selected hyperlink within the help window. Position the cursor on a function key containing a hyperlink, which is noted with an underline. Press F9. You will go directly to that topic. Press F7 to return to the previous screen, then press F8 to go to the next screen. Help Window HELP None F1

64 58 EXTERMIN8 PLUS This Page Intentionally Left Blank

65 59 C H A P T E R 7 Debugging Commands This chapter provides a detailed explanation of all EXTERMIN8 PLUS commands in alphabetical order. Contents Command Syntax Priority of Operators Alphabetical listing of EXTERMIN8 PLUS commands

66 60 EXTERMIN8 PLUS Command Syntax The general syntax of most commands is: XY -options (condition) parameters where XY is the name of the command, X is the first letter of an action and Y is the first letter of an object on which the action will be performed. -option only applies to certain commands to qualify the action and may be omitted if not required. All options are preceded with a dash and each letter represents one option. For instance, -s may mean to show the source. conditional expressions require parentheses to surround the condition. The following operators are valid: Operator Meaning *AND AND & Logical AND *OR OR Logical OR *EQ EQ = Equal *GT GT > Greater Than *LT LT < Less Than *GE GE >= Greater than or Equal *LE LE <= Less than or Equal *NE NE = Not Equal *NG NG > Not Greater than *NL NL < Not Less than Priority of Operators The priority of the operators follow, where 1 is the highest and 4 is the lowest priority. If more than one operator of the same level exist in the condition, the expression is performed from left to right. Parenthesis can be used to override the evaluation sequence. Priority Operator 1 Negative constants 2 *GT, *LT, *EQ, *GE, *LE, *NE, *NG, *NL 3 *AND 4 *OR Field names, numeric constants and alphanumeric strings can be used within expressions, alphanumeric strings must be enclosed within apostrophes. Examples of conditional expressions: (CUST# < 3 CUST# > 10) (CUST# NE *LSTVAL) ((CUST# = & STATUS = B ) OR (CUST# > & STATUS = A )) Parameters are entered as specified for the individual command where required.

67 Index 61 The following is a list of actions and objects that are allowed, and their possible combinations. ACTION X Used with Objects Add A B, E, P, W Bottom B Change C B, C, E Display B, C, E, L, M, P, R, U, W Find F T, U or string List L B, E, F, M, P, R, S, W Remove R B, E, P, W Set S A Top T OS/400 Command / Y OBJECT Used by at location D A Attribute S B Breakpoint A, C, D, L, R C Content C, D E Expression A, C, D, L, R F File L L List D M Module D, L P Program A, D, L, R R subroutine D, L S Source L T Spec Type F U SEU object D, F W Watch A, D, L, R

68 62 EXTERMIN8 PLUS AB - Add Breakpoint Syntax: AB -xtl [location range] {(Condition)} {FIELD 1... FIELD 5 } AB adds one or more breakpoints to the currently selected module. Breakpoints can be specified by either line number or subroutine name or a range of line numbers. Breakpoints set by this command can be conditional, so that execution will stop only when the condition is met. Temporary breakpoints may also be set. These are breakpoints that are automatically removed after execution has stopped there once. You can also specify the number of times this breakpoint should be skipped. Whenever a breakpoint is reached, the module is stopped prior to executing the statement and control is returned to EXTERMIN8 PLUS. The EXTERMIN8 PLUS default is to display the current breakpoint in high intensity. The status bar indicates the module name and line number of the breakpoint. The execution of the module must be restarted at a breakpoint by F11 or F12. Setting a breakpoint on a line that has a conditional indicator will stop the execution only if the condition is TRUE. To remove an existing breakpoint, either use the Remove Breakpoint command, RB, or the F10 function key. To remove all breakpoints, use the RB command with a parameter of *ALL. Refer to F22 to set or remove a range of breakpoints. If AB is entered without options, the Add/Change Breakpoint dialog box will be displayed, as shown below. Breakpoint location, condition, variables, options, and the number of times this breakpoint should be skipped will display. Location/Range: Enter either a single line number, a range of line numbers, a subroutine name or a TAG name. The breakpoint is set at the next executable statement following the BEGSR or TAG statement. Condition: Specifies a conditional expression. Execution will stop on the breakpoint only when the condition is true. Conditional breakpoints can only be set when the selected module is running. The conditional expression must be surrounded by parentheses. All the breakpoints behave with the *INMATCH. If a line on which user has a breakpoint and is conditional, then the program stops on that line only if the condition is TRUE, which is AB *INMATCH.

69 Index 63 Variables: {FIELD 1... FIELD 5 } When the breakpoint is reached, the contents of any variables named as parameters are displayed in the log window. If the variable named is a structure, then the contents of the individual fields will be displayed. The contents of any variables named in the watch list (see AW) are also displayed in the watch window. A maximum of five variables may be displayed on an AB command. Options (Command Line): -x Displays the contents of the field in hexadecimal format. -t Temporary breakpoint - specifies this is to be a temporary breakpoint where once the module has stopped at the breakpoint, the breakpoint will be automatically removed. -l Log Breakpoint - every time execution stops at this breakpoint an entry will be made in the log file, regardless of whether breakpoint logging is turned on or off. Any option can be entered singly or in combination such as -tl or -lt. Options (Dialog Box): Temporary: The breakpoint will remain until RB (Remove breakpoint) is selected. Log: Specifies whether to display the breakpoint in the log window. Hex: Specifies whether to display the values of the breakpoint in Hex. Skip: Specifies the number of times this breakpoint will be skipped before stopping. When setting conditional breakpoints, the selected module must be in BREAK or STEP mode. AW CB LB RB F6 F10 F22 Example: AB Add breakpoint at line 123 and skip it 3 times. AB 191 EMPNO DEPT Stop module at Line number 191 and display the contents of the fields EMPNO and DEPT. AB 47 (CUST# < 3 CUST# >10) CUST# CUNAME Stop module at Line number 47 if CUST# is less than 3 or greater than 10 and then display the variables CUST# and CUNAME. AB LOOP3 Stop at the next executable statement after the TAG LOOP3. AB -t 35 Stop at Line number 35, then remove the breakpoint. AB 35>45 Set breakpoints at all executable statements between lines 35 and 45.

70 64 EXTERMIN8 PLUS AE - Add Expression to be Monitored Syntax: AE (Condition) AE adds an expression to be monitored that stops module execution when the condition is true. Control is returned to EXTERMIN8 PLUS, in MONTR mode, at the statement immediately following the statement where the condition becomes true. The AE command will override any existing expression for the selected module. The expression is not cleared when the module terminates. If the module is started again from within the same EXTERMIN8 PLUS session, the expression is still active, unless the Remove Expression (RE) command has been used. Note: Debugging a module with an active expression is slow in execution since it is equivalent to setting a conditional breakpoint on every statement. Only one expression is allowed for each module being debugged. CE DE LE RE Example: AE (EMPNO <= 17) Stop the selected module when EMPNO is less than or equal to 17. AE ((BAL >=5000 AMTLAT >=10000) & STATUS = A ) Stop the selected module whenever BAL is greater than or equal to 5000 and STATUS is equal to A, or when AMTLAT is greater than or equal to and STATUS is equal to A. AM - Add Module (For ILE only) Syntax: Example: AM (Module Name) AM adds a module to the current program. The program from which it is picked is the active program (the one whose module is being displayed). None DM LM AM CUALFSILE AP - Add Program Syntax: AP Program Name t {type} m {Module1, Module2, } AP adds the given program to the list of programs in debug mode. The option -t is the type of program to add. The option -m is the name of the module(s) to add. (For ILE only).

71 Index 65 Program Type is optional and can be *PGM, (default) or *SRVPGM for service programs. Example: AW - Add Watch Syntax: None. LP RP AP XT8DEMO/CUALFS -t *SRVPGM AP XT8DEMO/CUALFS -t *PGM AP XT8DEMO/CUALFS -m CUALFSILE AP xt8demo/shipping *PGM AW Name {Name2... NameN} AW adds the given variable name or names to a list of fields the contents of which will be displayed in the watch window whenever a breakpoint is reached in the selected module. If the variable name given is a structure, then the contents of the individual fields within the structure will be displayed. Example: Valid only in BREAK or STEP modes. DW LW RW F6 AW EMPNO AW EMPNO EMPNAM EMPADD EMPFON B - Bottom Syntax: Example: B B displays the end of the source member currently in the source window. B positions the last line of source member at the bottom of the window. None T F18 B CB - Change Breakpoint RPG Syntax: CB -xtl [location range] {(Condition)} {FIELD 1... FIELD n } n CB provides a prompt screen which allows the attributes, condition, and display fields of a breakpoint to be changed. You can also specify the number of times this breakpoint should be skipped. Enter CB and the line number or TAG name, subroutine name or Procedure name where the breakpoint is set. A prompt screen is displayed identifying the current condition and variables to be displayed.

72 66 EXTERMIN8 PLUS The entries are in the same format as the Add Breakpoint (AB) command on page 62. Key the new conditions and/or field names and press ENTER to effect the change. The current breakpoint is prompted for change if the line number, TAG name or subroutine name is omitted. Only breakpoints in the currently selected module may be changed. To change breakpoints in another module use the Set Module (SM) or Display Module (DM) command first. AB DB LB RB F6 F10 Example: CB Change breakpoint on line 191 and skip it 3 times. CC - Change Contents Syntax: CC Field1 NewValue CC changes the contents of the named field in the current module to the new value entered. When an alphanumeric literal is entered that is shorter than the field length, the field is padded with blanks to the right. Apostrophes ( ) must surround the literal if it contains imbedded blanks. If an apostrophe is contained in the new value, surround the literal with quotation marks ( ). If the new value is numeric and requires a decimal point or a leading minus, these must be entered as part of the value. Otherwise, all positions following the decimal point are set to zero and all numbers are assumed to be positive. The syntax of the new value is edited to ensure alpha characters are not entered in numeric fields. CC may be used on structure or record names. The string entered fills the structure or record from left to right and is padded with blanks, without regard to the fields being numeric, so care must be taken to avoid decimal data errors. It is normally better to use F4 in this circumstance since EXTERMIN8 PLUS prompts for each field within the structure or record. If the new value is longer than the command line, use the F4 key on the field name. The pop-up window will be large enough to accept the complete field. Not available in SETUP Mode. DC F4 Example: CC EMPNO CC EMPNAM JOHN DOE CC DATA "John s Number" (note the embedded apostrophe)

73 Index 67 CC CITY AUSTIN CC ARBAL -14 CE - Change Expression to be Monitored Syntax: CE CE produces a prompt screen allowing the conditional attributes of the current module s expression to be modified. The EXTERMIN8 PLUS Change Expression prompt indicates the current conditions for the expression. Key in the changes to the expression and press ENTER. Example: Module must be running. AE DE LE RE CE CO - Change Occurrence (RPG Only) Syntax: CO MdsName NewOccur CO changes the current occurrence of the named multiple occurrence data structure. Once the occurrence has changed, individual fields may be changed using the CC command. Program must be running. Only valid with RPG programs. DO Example: >CO LINDS 3 CS - Change Source Views Syntax: CS [*]View Name or View number CS allows you to change the current view depending upon the compiler option. The four views are: *LIST - Listing View *SOURCE - Source View *COPY - Copy View *STMT - Statement View You do not have to specify the asterisk when changing views. For example: CS *COPY or CS COPY The available views must be defined when creating the RPG module. For example: CRTRPGMOD DBGVIEW (*ALL) will allow all views to be used. See Preparing Programs for Debugging in chapter 2 for further information on specifying a view when creating a module. Use LS - List Source views to list the views available for the selected program being debugged. When LS is specified, a number will be listed to the left side of the available views. If you want to change to one of the views, use CS and enter the view name as shown above, or specify the number of the view. A message window will display if an invalid view name or number is entered, as shown below. Press F12 to cancel the message.

74 68 EXTERMIN8 PLUS Example: ILE program only. LS >CS *LIST or CS LIST Changes the current view to the Listing view. >CS *STMT or CS STMT Changes the current view to the Statement view. >CS 1 Changes the current view to the view specified with number 1 after doing an LS. D@ - (RPG Only) Syntax: D@ D@ displays in the log window the name of the current module and the next statement to be executed. Both the line/statement number are displayed. This is the same information that exists in the EXTERMIN8 PLUS status bar and is most often used to put a marker in the EXTERMIN8 PLUS command log. Example: None D@ At pgm SHIPDETAIL line 41/82 (log entry) D@ - Display Calling Stack (COBOL Only) Syntax: DB - Display Breakpoint D@ -n N D@ displays in the calling stack of the PERFORM statements executed before reaching the current breakpoint. Options: -n displays the calling stack of PERFORMs without the associated SEU line numbers. Extermin8 PLUS displays a maximum of 30 characters for each FROM and THRU Paragraph Names. Omitting this option includes the SEU Line numbers, but shortens the Paragraph Names to 23 characters each. N indicates how deep to display the calling stack of PERFORMs. When a value for N is given, only the last N entries in the stack are displayed. Otherwise, the entire stack is displayed. Not valid in SETUP mode.

75 Index 69 Syntax: DB {SeuNum TagLabel SubrName} DB displays in the dialog box, the location, conditional expression if it exists, variable names, the contents of which will be displayed when the breakpoint is reached, and the number of times this breakpoint should be skipped. None AB AW CB RB F10 Example: DB 35 Display breakpoint on line 35. DC - Display Contents Syntax: DC -x Name1 {Name2... NameN} DC displays the current module s contents of the named fields, data structures, constants, or records in the log window. Position the cursor in the log window and use the roll keys to move the display up or down. Data structures and records are displayed by the field name in the data format of the field. Only the contents of the current occurrence of a multiple occurrence data structure is displayed. The name, length, current number and total number of occurrences prior to the current occurrence will also be displayed. To display a particular occurrence of a structure, enter the structure name followed by a comma and the occurrence number. To display all occurrences of a multiple structure, follow the name with a period and the letter O. In this case, each occurrence will be displayed unformatted. The option -x displays the contents of the field in hexadecimal format (not for constants). When displaying an array, the number of elements and the name of the array is given prior to the list of elements. To display a particular element of an array, follow the array name with a comma and the element number or field name containing the element number. Module must be running.

76 70 EXTERMIN8 PLUS Example: AW DL F9 DC CUST# Displays the contents of CUST#. DC -X CUST# Displays the contents of CUST# in hexadecimal format. DC SCRNLN.O Displays all occurrences of the multiple occurrence data structure SCRNLN. DC SEL,1 Displays the contents of array SEL element 1. DE - Display Expression to be Monitored Syntax: DE -e {ProgName} DE displays in the log window the conditional expression for the given module. If a module name is not specified, the expression for the current module is displayed. The command List Expression (LE) may be used to display the expressions for all modules currently in debug mode. The option -e evaluates the expression. A message window will display if there is no expression to display. Press F12 to cancel. Example: None AE CE LE RE DE CUST# NE 0 DE -e CUST# NE 0 is FALSE DE shipdetail Displays conditional expression for module named SHIPDETAIL. DI - Display Indicators Syntax: DI DI displays a window with the status of all indicators referenced by the current program. Indicators set on are shown in reverse image. The status of individual indicators may be displayed using the DC *INxx command.

77 Index 71 Valid only with RPG programs. DC DD Example: >DI -A DL - Display List (RPG Only) Syntax: DL ListName DL displays in the log window the contents of the fields in the specified KLIST or PLIST. Each element of the LIST is formatted by its field name. Example: Valid only with RPG modules. Module must be running. F9 DL CPKEY DM - Display Module Syntax: Example: DM {ModuleName} DM displays in the source window the source code of the given module. The selected module is set to the status of current module in debug mode. Any command entered that requires the current module will now use the displayed module. Only the source of the modules in debug mode may be displayed. Module must be in debug mode. LM DM shipdetail

78 72 EXTERMIN8 PLUS DN - Show/Hide/Reset a window or All Windows Syntax: Example: DN -shr Window Name DN allows you to show, hide or reset a window or all windows with *ALL. Options: -s Shows the specified window or all windows. -h Hides the specified window or all windows. -r Resets the specified window or all windows back to their original size and position. Window Name can be: Source Log Watch Help *ALL None DO - Display Occurrence (RPG Only) Syntax: F2 DN -s Source Shows the source window and makes it the active window. DN -h *ALL Hides all the windows. DO MdsName DO displays the current occurrence of the named multiple occurrence data structure. Program must be running. Only valid with RPG programs. CO Example: >DO LINDS 3 DP - Display Program Syntax: Example: DP {ProgName} DP displays in the source window the source code of the given program. The selected program is set to the status of the current program in debug mode. Any command entered that requires the current program will now use the displayed program. If the program name is not specified, the source of the currently selected program using the command Set Program (SP), is displayed. Only the source of the programs in debug mode may be displayed. Program must be in debug mode. AP LP RP DP shipdetail

79 DW - Display Watch Syntax: Example: DW Index 73 DW refreshes the watch window displaying the watch list from the top of the current module. Module must be running. AW LW RW DW F - Find Syntax: F {string} If the argument is not found before the end of source the message, string not found, is displayed. This command does not automatically wrap around to the beginning of the source to search for the argument. Enter command T or F17 to go to the top of the source and repeat search using F16. F without any argument pops up dialog box to enter the string. Example: The Find operation is case sensitive unless you change option Match Case. F16 F CUALFS Searches for string CUALFS. F Hello World Searches for string Hello World. FT - Find Type (RPG Only) Syntax: FT { F C O } FT finds the first line of the given RPG specification type of the source member displayed in the source window. FT will find the first file, Calculations, or Output specification with the parameters F, C, or O respectively, and position that line at the top of the source window. If the specification type is omitted, the first C specification is displayed. If the given specification type does not exist within the member, the last line of the previous specification type will be displayed at the top of the source window. Module must be in debug mode. F

80 74 EXTERMIN8 PLUS FT - Find Type (COBOL Only) Syntax: FT { D E F L P W } FT finds the first line of the given COBOL specification type of the source member displayed in the Browse window. FT will find the first DATA DIVISION, ENVIRONMENT DIVISION, FILE CONTROL SECTION, LINKAGE SECTION, PROCEDURE DIVISION, or WORKING STORAGE SECTION specification with the parameters D, E, F, L, P or W, respectively, and position that line at the top of the Browse window. If the specification type is omitted, the first PROCEDURE DIVISION specification is displayed. If the given specification type does not exist within the member, the last line of the previous specification type will be displayed at the top of the Browse window. When a source is first displayed the default is to show the beginning of the source. The User Choices Screen EXTERMIN8 can be modified to always show the beginning of the selected division or Section. See SA or Chapter 2. Example: Program must be in debug mode. SA >FT C or >FT Finds the first PROCEDURE DIVISION statement >FT L Finds the first LINKAGE SECTION statement FU - Find SEU Related Object Syntax: FU SeuNum FU finds the SEU related object specified on the command line. The object may be a SEU number or a SEU member. Module must be running. DU Example: FU LB - List Breakpoints Syntax: LB -pm LB lists all breakpoints and their attributes for all modules in debug mode. The information displayed in the log window consists of the module name, if it is a conditional breakpoint, the line/statement number, and the names of any variables that will be displayed upon reaching the breakpoint. A breakpoint having a? under the condition column is a conditional breakpoint. To view specifics of the condition, use the Display Breakpoint command (DB).

81 Index 75 The option -p requests the listing for all modules in all programs. The option -m requests the listing for all modules in the current program. Does not display the names of the fields in the general watch list (see LW). AB CB DB LW RB Example: LB displays: Module Cond Line/Statement Variable SHIPDETAIL * 34/0045 CUST# SHIPDETAIL? 45/0059 CUST# CUALFS 112/01AE ALPHAl LE - List Expression to be Monitored Syntax: Example: LE -pm LE lists the expression conditions for each module in debug mode that has a expression. The module name(s) are displayed followed by the expression. The option -p requests the listing for all modules in all programs. The option -m requests the listing for all modules in the current program. None AE CE DE RE LE displays: Module Expression SHIPDETAIL (CXMDL = B20 & CXMDL = B25 ) CUALFS (CUCUS = 1) LF - List Files Syntax: LF -rpm LF lists the names of the files used by all the modules in debug mode. The file names shown are as they are found in the F specifications. EXTERMIN8 PLUS does not regard any AS/400 OVRDBF commands that may be current. In COBOL, the file names shown are as they are found in the FILE CONTROL specifications. Displayed after each file name is the type of access being made to the file; i.e., I for Input, U for Update, O for Output, or C for Combined. If the complete list is not displayed, move the cursor to the log window and use the roll keys, or increase the size of the log window (F2). The option -r requests the listing of record formats for the given file. The option -p requests the listing for all modules in all programs. The option -m requests the listing for all modules in the current program.

82 76 EXTERMIN8 PLUS Example: LK - List Constants Syntax: Only valid with RPG modules. LF LF -r displays: Files for Module: SHIPDETAIL F: SHIPDTFM C F R: SHIPDT01 R: SHIPDT02 LK -v p m LK lists the names of the constants in all modules currently in debug mode. The option -v lists the names of the constants with their corresponding values. The option -p lists the names of the constants of all the programs in the debug session. The option -m lists the names of the constants of all the modules of the current program. Example: None DC F9 LK displays: CONST1 CONST2 NUM3 LK -v displays: CONST1 = Hello CONST2 = Bye NUM3 = 1234 LM - List Modules Syntax: LM -pu LM lists in the log window the names of all modules currently in debug mode. The list displays the module name, library, and type. The program name is preceded by the EXTERMIN8 PLUS Display Program command (DM), allowing F9 to be positioned at the display in the log window to bring the command to the command line. The option -u requests the additional display of the associated source member in the format: library name, file name, and member name. The option -p requests the display for all modules in all programs.

83 Index 77 Example: AP DP RP SP F9-log window LM displays: dm SHIPDETAIL XT8DEMO RPGLE LM -u displays: dm SHIPDETAIL XT8DEMO/SHIPDETAIL XT8DEMO RPGLE LM -p displays: XT8DEMO XT8DEMO SHIPDETAIL LP - List Programs Syntax: LP LP lists in the log window the names of all programs currently in debug mode and program attribute. The list displays the program library and name. Example: The program name is preceded by the EXTERMIN8 PLUS Display Program command (DP), allowing F9 to be positioned at the display in the log window to bring the command to the command line. None AP DP RP SP F9-log window LP displays: dp SHIPDETAIL EXILE RPGLE LR - List SubRoutines Syntax: Description for RPG: LR -pm LR lists the names of all subroutines within each module in debug mode. The list contains the subroutine name, and beginning and end line numbers for the subroutine. The option -p requests the listing for all modules in all programs. The option -m requests the listing for all modules in the current program.

84 78 EXTERMIN8 PLUS Description for COBOL: LR lists the names of all Paragraphs and Sections within each module in debug mode. The list contains the Paragraphs and sections name, and beginning and end line numbers for the Paragraphs and sections. The option -p requests the listing for all modules in all programs. The option -m requests the listing for all modules in the current program. Example: None. LR displays: Module Subr LineFrom LineTo SeuFrom-SeuTo SHIPDETAIL VALID VALID LS - List Source Views Syntax: LS LS allows you to list the available views for the current program based on how it was compiled. The four views are: *LIST - Listing View *SOURCE - Source View *COPY - Copy View *STMT - Statement View When LS is specified, a number will be listed with each view in the log window. You will have to press Page Down keys to display all the views. If you want to change to one of the views, use CS and enter the view name as shown above, or specify the number of the view. For example: LS CS 1 (This changes the view to the view associated with the number 1). The available views must be defined when creating the RPG module. For example: CRTRPGMOD DBGVIEW (*ALL) will allow all views to be used. See Preparing Programs for Debugging in chapter 2 for further information on specifying a view when creating a module. None CS

85 Index 79 RPG Example: >LS displays and numbers the available views. LV - List Variable Syntax: LV {Prog_name *ALL *PGM *MOD} LV displays in the log window all of the variable names used within the current or specified program. If a program name is not given, the variable names in the current program are listed. When *ALL is specified, the variable names used by each program in debug mode are listed. *ALL *MOD *PGM Note: All variables of all programs and modules are listed. All variables are listed from the current module. All variables in all modules of the current program are listed. Currently does not list variables for OPM programs. Example: None >LV displays: variables for program SHIPDETAIL var1 var2 var3..varn >LV *ALL displays: variables for program SHIPDETAIL var1 var2 var3...varn variables for program CUALFS var1 var2 var3...varn LW - List Watch Syntax: LW -pm LW lists the names of the fields in the log window whose contents will be displayed when the current module reaches a breakpoint. The option -p requests the listing for all modules in all programs. The option -m requests the listing for all modules in the current program. Example: None DW LW displays: Watches for module SHIPDETAIL cust# sel cxmdl

86 80 EXTERMIN8 PLUS RB - Remove Breakpoint Syntax: RB {*ALL *PGM *MOD LineNum LineRange TagLabel SubrName} {PgmName *ALL} RB removes one or more breakpoints from the named module. When all parameters are omitted, the current breakpoint is removed. If a module name is not given, all actions of this command are applied to the current module. *ALL All breakpoints of all programs are removed. *MOD All breakpoints are removed from the current module. LineNum The breakpoint at the given Line Number is removed from the current or named module. LineRange All breakpoints between a range of statement numbers are removed inclusively from the current or named module. The two line/statement numbers must be separated by a single greater-than sign (>). TagLabel (RPG) The breakpoint at the given TAG label is removed from the current or named module. SubrName The breakpoint at the beginning of the given subroutine is removed from the current or named module. *PGM All breakpoints in all modules of the current program are removed. Module must be running. AB F10 F22 Example: RB 234 Removes the breakpoint at line 234. RB 234>280 Removes all breakpoints between the lines 234 & 280, inclusively. RB 5 Removes the breakpoint at line 5. RB *ALL Removes all breakpoints in all modules open for debug. RB GETTEM Removes the breakpoint at the beginning of subroutine GETTEM. RE - Remove Expression to be Monitored Syntax: Example: RE RE removes the expression of the current module. Once the expression is removed, the execution time of the module will improve, since there is no longer the equivalent of a conditional breakpoint at every instruction. None AE CE DE LE RE

87 RP - Remove Program Syntax: Example: RP ProgName Index 81 RP removes the named program from the EXTERMIN8 PLUS session and from debug mode. Ending the EXTERMIN8 PLUS debug session also removes all programs from debug mode. RP also releases the source member, so that it is available to be edited from another session. None AP LP RP shipdetail RP CUALFS RW - Remove Watch Syntax: Example: SA - Set Attributes Syntax: RW {Variable Names *ALL *PGM *MOD} RW removes watches from modules and programs from the watch list that was added to the list using the command Add Watch (AW). The variable(s) will no longer be displayed when a breakpoint is reached. Variable Name Removes selected watch name for current module. *ALL Removes all watches from all modules and all programs. *PGM Removes all watches from all modules for the current program. *MOD Removes all watches for the current module. Program must be running. AW DW LW RW EMP-NO SA [Attribute {option}] SA sets the attributes for the debug session. The BREAK and STEP attributes provide tracing capabilities that are discussed within the narratives for each attribute. The following attributes and their options are available: BREAK [go nogo log nolog] This attribute controls the actions taken by EXTERMIN8 PLUS when a breakpoint is reached. To change both the BREAK and go log options, enter the SA command twice, once for each option. go Automatically continue execution when a breakpoint has been reached. When combined with the log option, information regarding each breakpoint is posted to the log file. This provides the ability to trace the program execution and review only breakpoints. nogo (default) Stop execution at each breakpoint encountered. log Log information in the log file on each breakpoint

88 82 EXTERMIN8 PLUS encountered. nolog (default) Do not log information on each breakpoint encountered. LINE {on off} Turns on and off the display of Line numbers for the source displayed in the source window. If the option is omitted, the current option will be toggled, i.e., off switches to on and on switches to off. NEST {on off} (RPG Only) Turns on and off the display of nesting of structures within the source window. If the option is omitted, the current option will be toggled; i.e., off switches to on and on switches to off. (F6 may also be used to toggle this nesting option). SEU {on off} Turns on and off the display of SEU numbers for the source displayed in the source window. If the option is omitted, the current option will be toggled. F6 also may be used to toggle the SEU number display. STEP [go nogo log nolog] This attribute controls how EXTERMIN8 PLUS performs single stepping. It provides the automated single stepping feature. To change both the log nolog and go nogo options, enter the SA command twice, once for each option. go nogo log nolog Automatically continue execution when a breakpoint has been reached. When combined with the log option, information regarding each breakpoint is posted to the log file. This provides the ability to trace the program execution and review only breakpoints. (default) Stop execution at each step when F11 is used. Log information in the log file on each instruction executed during single-stepping, whether manual or automated. (default) Do not log information on each single-step instruction executed. If only SA is entered, the following dialog box will display. The current user choices will display. Change the choices as needed, as shown below. RPG code section to display {T}

89 Specifies the section of RPG code to display. The default is T. Index 83 Log Breakpoints {Yes No) Specifies whether breakpoints will display in the log window. The default is No. Show SEU numbers at entry {Yes No) Specifies if SEU numbers for the source will be displayed. No is the default. Automatic Watch {A B N} Automatic watch specifies the position of automatic watches within the watch window. A = The automatic watches will display after the user watches in the watch window. B = The automatic watches will display before the user watches in the watch window. N = No automatic watch will display. Press F12 to cancel, F5 to refresh the screen, or F6 to display or change the color settings. The following dialog will display when F6 is pressed. Select the numbers associated with the type of text or window you wish to change. Press F5 to Refresh, F6 to test the color changes, or F12 to cancel making color changes. Maintain Subr/Perform stack Not applicable in RPG. COBOL code section to display When browsing a COBOL program source, EXTERMIN8 will initially position the display depending upon the value of this parameter. T B E D W L P Top of source. Bottom of source. At the start of the ENVIRONMENT DIVISION. At the start of the DATA DIVISION. At the start of the WORKING STORAGE SECTION. At the start of the DECLARATIVES SECTION. At the start of the PROCEDURE DIVISION. None